本文介绍移动推送Demo的使用,让您几分钟内快速体验移动推送功能。
创建应用
登录EMAS管理控制台,创建项目,在创建的项目下点击“添加应用”按钮,填写应用名称以及包名即可创建应用。
单击应用名称右侧的,打开指定应用的应用设置页面,记录应用的AppKey、AppSecret、PackageName。
iOS应用如需使用推送服务,需在移动推送控制台做鉴权配置,详细步骤参考:APNs鉴权配置。
Android
下载Demo工程
Android官网Demo样例请参见:移动推送 Android Demo。
配置app信息
1. 导入工程
下载示例工程后,使用Android Studio工具导入。
2. 配置工程
为了使Demo app能够正常运行,您还需要在Demo工程中配置您的AppKey、AppSecret信息。
在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-->
将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应用。
Demo已经完成了移动推送SDK的集成工作,但还是建议您仔细阅读移动推送的相关SDK文档:Android SDK接入。
当您在使用您自己的app集成移动推送遇到问题时,您可以对比Demo的配置情况。
iOS
下载Demo工程
iOS官网Demo样例请参见:移动推送 iOS Demo。
配置app信息
1. 导入工程
下载示例工程后,使用Xcode工具导入。
2. 配置工程
1.修改应用Bundle Identifier
,mpush_ios_demo
、mpush_service_extension
和mpush_content_extension
都要修改。
2.修改签名证书,mpush_ios_demo
、mpush_service_extension
和mpush_content_extension
都要修改。
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应用界面。
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平台创建的应用包名保持一致。
在AppGallery Connect“我的项目”里查看应用的“包名”,并在Demo工程./AppScope/app.json5文件中替换为您的应用包名。
{
"app": {
"bundleName": "您的应用包名",
"vendor": "example",
"versionCode": 1000000,
"versionName": "1.0.0",
"icon": "$media:app_icon",
"label": "$string:app_name"
}
}
应用运行
应用签名:DevEco Studio为开发者提供了自动签名方案,帮助开发者高效进行调试。也可选择手动签名对应用/服务进行签名。
参考链接:应用服务签名
应用运行:
运行之后打开Demo应用界面。
Demo已经完成了移动推送SDK的集成工作,但还是建议您仔细阅读移动推送的相关SDK文档:HarmonyOS SDK接入。
当您在使用您自己的app集成移动推送遇到问题时,您可以对比Demo的配置情况。
在移动控制台上推送
登录EMAS管理控制台。
在上方导航栏选择用户增长。
展开左侧移动推送右侧的下拉按钮,单击创建任务-推送通知。
填写通知标题及通知正文后,单击推送通知。
在手机上查看推送的通知。
后续步骤
移动推送demo仅提供简单推送功能,如需要接入到实际项目中或者使用更多高级能力,请参考开发手册。
联系我们
如遇到使用问题,请参考技术支持联系我们解决。