一：开设帐号，生成appkey

联系工作人员，提供 boundId，测试环境apns证书，正式环境apns证书，生成 appkey。

二：集成SDK

1.CocoaPods 集成

iPush支持 CocoaPods 方式和手动集成两种方式。我们推荐使用 CocoaPods 方式集成，以便随时更新至最新版本。

在 Podfile 中增加以下内容。

 pod 'cableUi'

执行以下命令，安装 iPush。

 pod install

如果无法安装 SDK 最新版本，执行以下命令更新本地的 CocoaPods 仓库列表。

 pod repo update

2.添加项目设置

1.主项目添加 Push Notifications 功能

在Targets中选择主项，点击右则 Signing & Capabilities， 点击 + ，选择 Push Notifications选项。

2. Enable Bitcode 设置成 NO

3. 添加以下权限描述

<key>NSCameraUsageDescription</key>
<string>此App会在用户扫描二维码信息时访问您的相机, 使用过程为用户保密</string>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>发送具体位置给好友时，需要用到位置服务，使用过程安全保密</string>
<key>NSLocationUsageDescription</key>
<string>发送具体位置给好友时，需要用到位置服务，使用过程安全保密</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>发送具体位置给好友时，需要用到位置服务，使用过程安全保密</string>
<key>NSMicrophoneUsageDescription</key>
<string>此App会在用户语音聊天时访问您的麦克风,然后打包提交, 使用过程为用户保密</string>
<key>NSPhotoLibraryAddUsageDescription</key>
<string>此App会为用户保存图片到您的相册,此过程不会有数据泄露, 使用过程为用户保密</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>此App会在用户使用照片时访问您的相册,然后打包提交, 使用过程为用户保密</string>

三：代码流程接入

1.在 AppDelegate.m 文件中初始化（以Swift项目为例）。

import iPush
import iChat
import cableUi

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    //选择运行环境 
    //true:测试环境，false:正式环境(默认)
    IMuiApi.getInstance().DEBUG = true    
    //初始化sdk
    IMuiApi.getInstance().initSdk()  
    //申请获取 deviceToken
    PushApi.getInstance().registerNotification(application: application, delegate: self)    
    //生成register_id
    PushApi.getInstance().registerUID { (response:PHResponse<String>) in                    
        print("*** [SDK] \(response.data ?? "")")
    }
    return true
}

项目中新建 sdk.plist 文件，并在文件中进行以下设置

<plist version="1.0">
<dict>
    <!-- 申请时生成的appKey -->
    <key>AppKey</key>
    <string>4d3967b5d1c4b7a3cad814af</string>
    
    <!-- im中默认图名字 -->
    <key>DefaultImage</key>
    <string>default_icon</string>
    
    <!-- im中左边的消息背景图 -->
    <key>LeftContentBg</key>
    <string>qipao_Left</string>
    
    <!-- im中右边消息的背景图 -->
    <key>RightContentBg</key>
    <string>qipao_Right Light</string>
    
    <!-- im中图片类型消息的默认图 -->
    <key>ImageMessageBg</key>
    <string>right_bg</string>
    
    <!-- im中是否显示聊天室中的title view -->
    <key>HideIMHeaderView</key>
    <true/>
    
    <!-- 是否显示搜索栏 -->
    <key>SearchEnable</key>
    <false/>
    
    <!-- 1:显示emoji, 2:显示sticker -->
    <key>StickerType</key>
    <integer>2</integer>
    
    <!-- 设置聊天室默认头像 -->
    <key>AvatarDefatulImage</key>
    <string>asdf</string>
</dict>
</plist>

2. 实现推送回调方法

当收到apns推送时，将回调UNUserNotificationCenterDelegate代理方法参考如下(原生apns消息回调代理方法)。如要支持ios 10以下的系统，请自行补充版本兼容代码。

func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    PushApi.getInstance().pushToken(data:deviceToken) { (response:PHResponse<Bool>) in
    }
}

@available(iOS 10.0, *)
func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void){
    PushApi.getInstance().userNotificationCenter(center, willPresent:notification, completionHandler:completionHandler)
    completionHandler([.alert, .sound])
}

@available(iOS 10.0, *)
func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void){
    PushApi.getInstance().userNotificationCenter(center, didReceive:response)
    completionHandler()
}

func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
    PushApi.getInstance().application(application, didReceiveRemoteNotification:userInfo)
    completionHandler(UIBackgroundFetchResult.newData)
}

四. 运行Demo注意事项

1. pod install

下载demo项目后，打开主目录，在终端中执行 pod install。

2. 替换你的 appkey

打开项目，打开 AppDelegate文件，在 initSDK 方法中替换成你申请成功的appkey

注意： 测试环境下的appkey，与正式环境下的appkey不相同，请分开申请。

License

The MIT License (MIT)

Copyright (c) 2020 Adam

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.