前言
第一次对接aws,遇到的坑是真多。现在记录一下。本文主要用到的是【Amazon Pinpoint】推送。
开发人员的指南:https://docs.aws.amazon.com/zh_cn/pinpoint/latest/developerguide/welcome.html
Amazon的SDK地址:https://github.com/aws/aws-sdk-ios
实践步骤,不要乱
第一步:拿到推送证书
一定要按照5个步骤一步一步来,拿到的证书才是正确的。
第二步:建项目将 iOS 应用程序添加到 Amazon Pinpoint
我们创建完应用之后,就可以在控制台上,拿到测试的Demo, 可以自己运行Demo,测试通知功能。
拿Demo的步骤:
1、登录 AWS 管理控制台,在 https://console.aws.amazon.com/mobilehub 打开 Mobile Hub 控制台。
如果还没有创建iOS应用程序,则跳到第4步【创建iOS应用程序】。如果已经创建了,跳到第3步创建工程
2、在所有的项目中,选择要测试的项目,https://console.aws.amazon.com/mobilehub/home
选中自己的Projects , 点击进入,点击iOS 的 【integrate】,其中【download cloud config】是自己的配置文件,集成到自己的APP里面需要用的,点击右上角的【Resources】下载自己的测试Demo.
3、如果上面的操作都找不到,那你就需要选创建一个工程。步骤https://docs.aws.amazon.com/zh_cn/pinpoint/latest/developerguide/getting-started-ios-mobilehub.html
第三步:测试推送
拿到demo之后,我们发现,程序运行不起来的。在demo中,有一个【podfile】文件,需要【pod install】更新一下,接着打开【MySampleApp.xcworkspace】 这个工程。
之后,就可以 使用 Amazon Pinpoint 测试示例应用程序 通过控制台来测试通知了。
另外需要注意,测试通知,一定要 导出.ipa文件,通过安装的方式安装在手机 ,才能接收到通知。如果还是没有收到通知,可以先关闭程序,再重新打开。
第四步:将相关deviceToken和.pem文件证书传给后台
测试成功后,我们发现,通过控制器的测试,是对所有设备一起发的通知。如果想针对单个用户,实现点对点的通知,我们需要给后台传deviceToken
在【MySampleApp】中,我们已经拿到deviceToken了,在相关的代码中:
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
NSLog(@"deviceToken: %@", deviceToken);
[_pinpoint.notificationManager interceptDidRegisterForRemoteNotificationsWithDeviceToken:deviceToken];
}
拿到的deviceToken是类似下面这一串:
Device Token = <examp1e 29z6j5c4 df46f809 505189c4 c83fjcgf 7f6257e9 8542d2jt 3395kj73>
将设备令牌提交给 Amazon SNS 时,设备令牌中不要包含空格:如
<examp1e29z6j5c4df46f809505189c4c83fjcgf7f6257e98542d2jt3395kj73>
另外,我们还需要给后台提供.pem文件。直接第一步拿到的.p12转成.pem即可
openssl pkcs12 -in myapnsappprivatekey.p12 -out myapnsappprivatekey.pem -nodes -clcerts
这一步的操作,可以参考:APNS 入门 ,感觉这里的文档有点旧了,左边写着是2010年的,使用 Amazon SNS 控制台将通知发送到设备上的 iOS 应用程序一直尝试不成功。
第五步:集成到真实APP项目中
这一步,可以参考:将推送通知添加到您的应用程序
这里的文档,是有坑的:
1、iOS只有swift语言的说明。解决:通过对照Demo【MySampleApp】可以得到解决。
2、pod sdk是一个大坑。文档上的pod 类库名写错了,一万个泥马
解决:实现上,我们通过看demo,需要pod的类库是:
pod 'AWSAuthCore', '~> 2.6.1'
pod 'AWSPinpoint', '~> 2.6.1'
github上的aws sdk地址,在【前言】上有写。
最后,变更工程
当我们集成完项目之后,最终需要变更工程文件,只需要登录控制台,把 【download cloud config】下载下来,替换一下工程的【awsconfiguration.json】文件即可。
收不到推送
1、检查APP工程,已经打开了【Push notification】开关
2、APP的包,一定要通过.ipa文件安装。就是xcode -- product -- archive
3、首次安装打开的APP,可能收不到推送。需要重启一遍即可。
祝君对接成功。