使用Demo快速体验移动推送

本文介绍移动推送Demo的使用,让您几分钟内快速体验移动推送功能。

创建应用

  1. 登录EMAS管理控制台,创建项目,在创建的项目下点击“添加应用”按钮,填写应用名称以及包名即可创建应用。image

  2. 单击应用名称右侧的fig3,打开指定应用的应用设置页面,记录应用的AppKey、AppSecret、PackageName。image

说明

iOS应用如需使用推送服务,需在移动推送控制台做鉴权配置,详细步骤参考:APNs鉴权配置

Android

下载Demo工程

Android官网Demo样例请参见:移动推送 Android Demo

配置app信息

1. 导入工程

下载示例工程后,使用Android Studio工具导入。

2. 配置工程

为了使Demo app能够正常运行,您还需要在Demo工程中配置您的AppKey、AppSecret信息。

  1. AndroidManifest.xml中配置您的app信息。

    <meta-data android:name="com.alibaba.app.appkey" android:value="********"/> <!-- 请填写EMAS中创建的应用的AppKey -->
    <meta-data android:name="com.alibaba.app.appsecret" android:value="********"/> <!-- 请填写EMAS中创建的应用的AppSecret-->
  2. build.gradle文件中的applicationId修改成您在EMAS中创建应用时填写的PackageName。

    android {
        compileSdkVersion 23
        buildToolsVersion "23.0.1"
    
        defaultConfig {
            applicationId "********" // 填写所创建App的包名
            minSdkVersion 11
            targetSdkVersion 23
            versionCode 1
            versionName "1.0"
        }
     ......
    }

应用运行

若程序编译通过,且运行是MainApplication.initCloudChannel打印出类似如下日志,则说明集成成功。

08-23 11:30:02.741 25116-25116/cloud.aliyun.test I/Init: init cloudchannel success

将编译好的Demo应用安装到手机上,并在手机上打开Demo应用。

image

说明
  • Demo已经完成了移动推送SDK的集成工作,但还是建议您仔细阅读移动推送的相关SDK文档:Android SDK接入

  • 当您在使用您自己的app集成移动推送遇到问题时,您可以对比Demo的配置情况。

iOS

下载Demo工程

iOS官网Demo样例请参见:移动推送 iOS Demo

配置app信息

1. 导入工程

下载示例工程后,使用Xcode工具导入。

2. 配置工程

1.修改应用Bundle Identifiermpush_ios_demompush_service_extensionmpush_content_extension都要修改。

2.修改签名证书,mpush_ios_demompush_service_extensionmpush_content_extension都要修改。

Certificate-modify.png

3.配置您的AppKey、AppSecret信息。

static NSString *const testAppKey = @"******";
static NSString *const testAppSecret = @"******";
// SDK初始化
[CloudPushSDK asyncInit:testAppKey appSecret:testAppSecret callback:^(CloudPushCallbackResult *res) {
    if (res.success) {
        NSLog(@"Push SDK init success, deviceId: %@.", [CloudPushSDK getDeviceId]);
    } else {
        NSLog(@"Push SDK init failed, error: %@", res.error);
    }
}];

应用运行

根据SDK初始化回调结果查看是否成功。

 if (res.success) {
    NSLog(@"Push SDK init success, deviceId: %@.", [CloudPushSDK getDeviceId]);
} else {
    NSLog(@"Push SDK init failed, error: %@", res.error);
}

运行成功之后可以查看Demo应用界面。

image

说明
  • Demo已经完成了移动推送SDK的集成工作,但还是建议您仔细阅读移动推送的相关SDK文档:iOS SDK配置

  • 当您在使用您自己的app集成移动推送遇到问题时,您可以对比Demo的配置情况。

HarmonyOS

下载Demo工程

HarmonyOS官网Demo样例请参见:移动推送 HarmonyOS Demo

配置app信息

1. 导入工程

下载示例工程后,使用DevEco Studio工具导入。

2. 配置工程

1.参考HarmonyOS SDK发布说明,在Demo工程./entry/oh-package.json5文件中设置最新版本号。

{
  "name": "entry",
  "version": "1.0.0",
  "description": "Please describe the basic information.",
  "main": "",
  "author": "",
  "license": "",
  "dependencies": {
    "@aliyun/push": "1.1.0", //Demo以1.1.0版本示例,请在阿里云官方文档查看使用最新版本
  }
}

2.在Demo工程./entry/src/main/ets/common/Constants.ets文件中配置您的AppKey、AppSecret信息。

export const AppKey = '请填入EMAS平台创建的应用AppKey'
export const AppSecret = '请填入EMAS平台创建的应用AppSecret'

3.AppGallery Connect创建鸿蒙应用。

  • 参考鸿蒙应用开发准备,在AppGallery Connect创建应用,应用的包名与EMAS平台创建的应用包名保持一致。

  • 参考服务账号密钥,创建并下载推送服务API的服务账号密钥。并参考配置账号密钥文件,在EMAS平台配置鸿蒙厂商通道。

  • AppGallery Connect“我的项目”里查看应用的“包名”,并在Demo工程./AppScope/app.json5文件中替换为您的应用包名。

{
  "app": {
    "bundleName": "您的应用包名",
    "vendor": "example",
    "versionCode": 1000000,
    "versionName": "1.0.0",
    "icon": "$media:app_icon",
    "label": "$string:app_name"
  }
}

应用运行

说明
  • Demo已经完成了移动推送SDK的集成工作,但还是建议您仔细阅读移动推送的相关SDK文档:HarmonyOS SDK接入

  • 当您在使用您自己的app集成移动推送遇到问题时,您可以对比Demo的配置情况。

在移动控制台上推送

  1. 登录EMAS管理控制台

  2. 在上方导航栏选择用户增长

  3. 展开左侧移动推送右侧的下拉按钮,单击创建任务-推送通知

  4. 填写通知标题通知正文后,单击推送通知

    image

  5. 在手机上查看推送的通知。

后续步骤

移动推送demo仅提供简单推送功能,如需要接入到实际项目中或者使用更多高级能力,请参考开发手册

联系我们

如遇到使用问题,请参考技术支持联系我们解决。