千千游戏SDK补充说明

2,465 阅读5分钟

文章主要针对游戏需要配置IAE与多Appicon,以及额外的三方依赖时的扩展说明

一、多AppIcon配置

该功能目前不牵扯代码切换,仅用于App store产品页测试多icon配置,具体设置步骤如下:

  1. 创建新Appicon,导入一张1024的logo图像

截屏2024-08-29 10.36.04.png

  1. 更改应用主icon与勾选多icon打包选项 截屏2024-04-07 15.22.00.png

二、千千SDK游戏自有IAE深链配置

Xcode通用链接配置

在Xcode项目中添加通用域名配置项

截屏2024-07-19 17.07.18.png

在Xcode中配置我方提供的通用链接域名(如:my.domain.com,即添加:applinks:my.domain.com) 截屏2024-07-19 17.07.38.png

代码处理

该部分请结合SDK接入指南中的接口7:处理IAE/URL启动事件

三、Xcode推送配置

  1. 在Xcode项目中添加推送通知配置项

WeChat5d0e037e976cd76a4ea838db106ae08f.jpg

  1. Unity项目需要修改导出工程内默认的推送配置值

找到Preprocessor.h文件,搜索UNITY_USES_REMOTE_NOTIFICATIONS,将值改为1。

WeChat0ce0fb16c4d42a6f36e1aad50a6f04c9.jpg

代码处理

该部分请结合SDK接入指南中的接口10. 推送

四、Xcode游戏中心配置

  1. 在Xcode项目中添加Game Center配置项:

WeChat0d7fe9400883453fd8f3d39efb400023.jpg

2.如接入挑战功能需在info.plist文件中配置权限描述:

NSUserTrackingUsageDescription:我们需要访问您的 Game Center 好友列表,以便邀请好友一起游戏。

image.png

代码处理

该部分请结合SDK接入指南中的接口11.iOS游戏中心(Game Center)

五、depends依赖

该部分主要为SDK所需的第三方框架,由于不同版本以及需求有所不同该部分框架可能有所不同。具体导入及配置方式如下:

  1. 当首次接入时可以直接导入整个SDK文件夹,如果后续更新具体根据SDK文件夹中depends文件夹框架差异进行导入或删除,具体导入选项如图所示

截屏2024-04-08 14.32.07.png

  1. 确认导入后Framework搜索路径生成正常,如果存在缺失请手动补充

截屏2024-04-08 14.36.59.png

动态

  1. 配置动态框架嵌入方式,动态框架需要在此处将默认导入配置修改为:Embed&sign,目前SDK个版本引入的动态框架有所不同具体根据实际情况对第三方框架进行配置,下图展示了抖音促活SDK配置事例

WeChat4e0cfc50ed94c72d20588e59be72da41.jpg

4. 确认runpath搜索参数配置正常,如果该项为空请手动添加参数项:@executable_path/Frameworks

截屏2024-04-08 14.55.07.png

  1. 添加依赖库

必要(港澳台及海外版本忽略此步骤)

  • libsqlite3.tbd
  • libc++.tbd
  • libz.1.2.5.tbd

WechatIMG40.jpg

可选 (请根据SDK文件中depends文件夹内框架选择性配置)

1.抖音SDK(如depends文件夹内含有OSDK需配置)

[1]补充系统库依赖,除了 SDK 的库文件之外,还需要添加一些系统库。 在 General -> Frameworks, Libraries and Embedded Content 下增加

  • UIKit.framework
  • Foundation.framework
  • Accelerate.framework
  • MobileCoreServices.framework

WeChat243e4a1dadad9e6030bfdca0edc7c41a.jpg

2.微信登录SDK(如depends文件夹内含有WechatOpenSDK-XCFramework需配置)

[1]补充系统库依赖,除了 SDK 的库文件之外,还需要添加一些系统库。 在 General -> Frameworks, Libraries and Embedded Content 下增加

  • Security.framework
  • CoreGraphics.framework
  • WebKit.framework

WeChat861a0855c41d25ba15db8d79fab266fd.jpg

[2]在你的工程文件中选择 Build Setting,在Other Linker Flags中加入-ObjC -all_load

WeChat13986331a87aa3a53078bf1450ee6cd8.jpg

[3]在Xcode中,选择你的工程设置项,选中TARGETS一栏,在info标签栏的URL type添加URL scheme为你所注册的应用程序id(配置信息请从我方提供的demo工程包内查看

WeChat28eab9ad7594d55d7ce2eddabad5d17e.jpg

[4]Xcode 设置 URL scheme。在Xcode中,选择你的工程设置项,选中TARGETS一栏,在info标签栏的LSApplicationQueriesSchemes添加weixinweixinULAPIweixinURLParamsAPI(如下图所示)。

WeChatdda1b95259ecf546f677cde17cca2d38.jpg

3.TapTap登录SDK(如depends文件夹内含有TapTap需配置)

[1]配置编译选项
右键项目New File from template...​(或 ⌘ + N)。
选择Swift File
点击Create,并在弹出窗口选择 Create Bridging Header
Xcode 会自动启用 Swift 编译选项,在 Build Settings 里搜索 swift 即可看到相关配置。
Build Setting 中的 Swift Compiler - Language栏目Swift Language Version 选择 Swift 5

WechatIMG153.jpg

[2]在你的工程文件中选择 Build Setting,在Other Linker Flags中加入-ObjC

WeChat13986331a87aa3a53078bf1450ee6cd8.jpg

[3]在Xcode中,选择你的工程设置项,选中TARGETS一栏,在info标签栏的URL type添加URL scheme为你所注册的应用程序id(配置信息请从我方提供的demo工程包内查看

WechatIMG151.jpg

[4]Xcode 设置 URL scheme。在Xcode中,选择你的工程设置项,选中TARGETS一栏,在info标签栏的LSApplicationQueriesSchemes添加taptaptapiosdktapsdk(如下图所示)。

WechatIMG152.jpg

4.Facebook登录SDK(如depends文件夹内含有facebook需配置)

[1]在Xcode中,选择你的工程设置项,选中TARGETS一栏,在info标签栏的URL type添加URL scheme为你所注册的应用程序id(配置信息请从我方提供的demo工程包内查看

WeChat3243de20b6216fd35b319fa9c40abd47.jpg

[2]Xcode 设置 URL scheme。在Xcode中,选择你的工程设置项,选中TARGETS一栏,在info标签栏的LSApplicationQueriesSchemes添加fbapifb-messenger-share-api(如下图所示)。

e6a3c413-cf0c-4262-a0a6-01ac4fadf802.png

5.Google登录SDK(如depends文件夹内含有firebase需配置)

[1]在Xcode中,选择你的工程设置项,选中TARGETS一栏,在info标签栏的URL type添加URL scheme为你所注册的应用程序id(配置信息请从我方提供的demo工程包内查看

WeChat54826cbf687e4017edbfd6f5e5c64e6f.jpg

7.Apple登录权限配置(如接入第三方登录需配置)

若 App 提供第三方登录(微信/谷歌等),必须同时包含苹果登录App Store 审核指南 4.8 条

在工程内添加Apple登录支持

107a39f4-817a-4f0f-a07b-96d5b0958e2b.png

  1. 最终出包确认,如果出包时此处仍旧无法展示动态框架项请复查上述操作,或联系iOS千千游戏SDK支持人员

WeChat7855a71ee12d7def7b9ec81fdfde9fb6.jpg