iOS接入配置

WARNING

在接入SDK之前， 建议先请仔细阅读：接入流程

添加framework和bundle

把SDKDemo工程中Libs目录下的所有库文件和bundle文件添加到游戏的xcode工程中, 并添加如下系统库：

AdService.framework
AdSupport.framework
AVFoundation.framework
CFNetwork.framework
CoreFoundation.framework
CoreGraphic.framework
CoreTelephony.framework
QuartzCore.framework
WebKit.framework
Security.framework
StoreKit.framework
SystemConfiguration.framework
libc++.tbd
libc++abi.tbd
libresolv.9.tbd
libresolv.tbd
libsqlite3.tbd
libz.tbd

阿里一键登录的库ATAuthSDK_D.xcframework是动态库， 需要设置为Embed&Sign：

Info Plist配置

Info Plist配置

在游戏的Info Plist文件中， 增加以下配置节点：

<key>NSCameraUsageDescription</key>
<string>是否允许此APP访问您的相机</string>  
<key>NSPhotoLibraryUsageDescription</key>
<string>是否允许此APP访问您的相册</string>  
<key>NSPhotoLibraryAddUsageDescription</key>
<string>是否允许此APP访问您的相册</string> 
<key>NSUserTrackingUsageDescription</key>
<string>是否允许此APP记录您的广告偏好</string>
<key>UIUserInterfaceStyle</key>
<string>Light</string>  
<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

BuildSetttings 配置

在Xcode工程中 当前Target的build settings中，搜索other link flags， 在other link flags中，添加一项：

-ObjC

第三方登录的配置

如果当前开启了微信和QQ等第三方登录， 还需要进行一些额外的配置。请参考如下：

1 点击查看【QQ登录】的配置

1.1 QQ互联后台配置

前往QQ互联开发者平台，在应用详情-》开发配置-》iOS应用标签中， 配置iOS应用的包名和Universal Links等信息：

Bundle ID： 配置包名，和XCode工程中的Bundle ID一致
URL Schema： 配置（随便配置）
AppStore ID: AppStore Connect后台，该游戏的Apple ID
Universal Link: iOS平台未使用，可以随便配置

1.2 SDK后台配置

上面配置好后， 获取到应用的AppID。 登录SDK后台-》基础配置管理-》登录配置中，QQ登录标签中进行配置：

1.3 添加URL Schemes

在XCODE工程的Info Plist中， 添加一个url scheme配置。 设置为tencent+{QQ AppId}:

1.4 配置Queried URL Schemes

在XCODE工程的Info Plist中， 添加QQ跳转需要的URL Schemes:

mqq
mqqapi
tim
mqqopensdkapiV2
mqqOpensdkSSoLogin
mqqopensdknopasteboard
mqqopensdknopasteboardios16

2 点击查看【微信登录】的配置

2.1 Apple Universal Links配置

1. 本地创建一个文本文件，并命名为： apple-app-site-association （无后缀）

2. 在文件中，添加如下内容：

{  
    "applinks": {  
        "apps": [],  
        "details": [  
            {
                "appID": "AR2JPVHN9Z.com.u8sdk.sample",
                "paths": [/app2/*"]
            }
        ]  
    }  
}

appID的格式为： teamID.bundleID， teamID是Apple开发者后台该应用对应的TeamID， bundleID为当前游戏的包名（bundleID）;
paths： 是匹配的相对路径， 自定义即可。 但是格式为/xxx/\* ，最后一定要加\*。

3. 将上面文件放到web服务器对应的根目录下，比如放到www.u8sdk.com 网站对应的根目录或.well-known目录下， 然后浏览器中访问该文件URL地址，能正常访问到即可。 注意该地址一定要支持https，否则微信开发者后台无法配置。

4. 这样最终文件的访问地址就是： https://www.u8sdk.com/apple-app-site-association

2.2 微信后台配置

前往微信开发者平台，在应用详情-》开发配置-》iOS应用标签中， 配置iOS应用的包名和Universal Links：

Bundle ID： 配置包名
Universal Links： 配置上面apple-app-site-association文件所在的域名路径加上文件内容中的paths，比如 https://www.u8sdk.com/app2/

如下图：

2.3 SDK后台配置

上面配置好后， 登录SDK后台-》基础配置管理-》登录配置中， 将Universal Links配置为上面微信后台一致的值：

2.4 配置域名

在XCODE界面中， 添加上面域名的配置， 格式为： applinks:域名， 比如对应上面的是： applinks:www.u8sdk.com

2.5 添加URL Schemes

在XCODE中Info Plist中， 添加微信开发者平台中该应用的app id:

2.6 配置Queried URL Schemes

在XCODE中Info Plist中， 添加微信跳转需要的URL Schemes:

weixin
weixinULAPI
weixinURLParamsAPI