如何配置SDK

iOS 版 SDK配置方法

前提条件

1. 下载SDK包：根据您的需求，选择手动添加依赖或统一接入方式。手动添加需先下载SDK包；统一接入则需下载配置文件。
2. 推送证书配置：确保已按照iOS配置推送证书指南完成证书设置。
3. 了解使用限制：在开始前，请阅读移动推送产品的使用限制。

集成步骤

1. 添加依赖

• 手动添加

  • 解压SDK包，将CloudPushSDK.framework拖入Xcode项目中的Target下，并勾选Copy items if needed。
  • 对于2.2.0以下版本，还需添加AlicloudUtils.framework和UTDID.framework到Target中。
  • 在工程的Build Phases -> Link Binary With Libraries中添加以下系统库：

  libz.tbd
  libresolv.tbd
  CoreTelephony.framework
  SystemConfiguration.framework
  libsqlite3.tbd
  

• Pod集成

  • 在Podfile中添加阿里云仓库源并执行相关命令以拉取依赖。
  • 添加依赖库到Podfile中：

  pod 'AlicloudPush', '2.2.0'
  

  • 执行pod install安装依赖。

2. 引入头文件

在需要使用推送功能的类中引入头文件：

#import <CloudPushSDK/CloudPushSDK.h>

3. Objc配置

• 在Xcode的TARGETS -> Build Settings中，搜索Other Linker Flags，添加-ObjC。

4. 配置文件与初始化

• 将下载的AliyunEmasServices-Info.plist配置文件拖入App Target下，并勾选Copy items if needed。
• 初始化SDK，通过配置文件自动获取AppKey和AppSecret，或直接在代码中指定：

- (void)initCloudPush {
    [CloudPushSDK asyncInit:@"Your_AppKey" appSecret:@"Your_AppSecret" callback:^(CloudPushCallbackResult *res) {
        // 初始化结果处理
    }];
}

5. 注册APNs

• 实现应用代理方法注册APNs并上报deviceToken至阿里云服务器：

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // 注册APNs
    [self registerAPNS:application];
    return YES;
}

- (void)registerAPNS:(UIApplication *)application {
    // 根据iOS版本注册通知
    // ...
}

// deviceToken回调处理
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    [CloudPushSDK registerDevice:deviceToken withCallback:^(CloudPushCallbackResult *res) {
        // 上报结果处理
    }];
}

// 失败回调
- (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error {
    NSLog(@"didFailToRegisterForRemoteNotificationsWithError %@", error);
}

6. 监听推送消息

• 注册接收推送消息的通知：

- (void)registerMessageReceive {
    [[NSNotificationCenter defaultCenter] addObserver:self
                                             selector:@selector(handleNotification:)
                                                 name:CloudPushNotificationReceived
                                               object:nil];
}

- (void)handleNotification:(NSNotification *)notification {
    // 处理接收到的推送消息
}

注意事项

• 模拟器架构剥离：提交App Store时，确保移除x86架构动态库（Pod集成已自动处理）。
• 编译错误处理：如遇编译问题，可尝试将编译源文件设置为Objective-C++。
• 证书与密钥：确保使用正确的AppKey和AppSecret，特别是从其他平台迁移的用户。

以上步骤指导您完成iOS版SDK的配置与集成。