跳到主要内容

iOS自动接入工具使用说明

1 简介​

该工具将SDK接入操作及配置自动化，大大简化了研发接入SDK的步骤。工具的作用对象为Xcode工程，如果游戏是基于Unity或Cocos开发的，那么必须将游戏工程导出为Xcode工程后才可以使用本工具。

建议环境：

  • Unity：2018.4.31f1及以上
  • CocosCreator：3.0.0及以上
  • Xcode：12.4及以上
  • macOS：11.2.2及以上

2 使用说明​

2.1 下载SDK包​

请在SDK下载页选择好需要接入的登录方式及游戏引擎，并下载SDK包（含工具）。

SDK包包含（目录层级及文件名不可更改）：

  • sdk：Sdk的主库
  • plugins：插件资源
  • TopSDKTool：自动接入工具程序
  • cocos：cocos引擎插件
  • unity：unity引擎插件

tips：如果您是iOS原生工程，可跳过2.2、2.3直接查看2.4

2.2 导入插件（Unity、Cocos）​

2.2.1 Unity​

详细的unity接入说明可查看Unity接入文档

请将下载的SDK包中unity目录下的xxx.unitypackage包导入工程，按以下步骤操作进行插件导入：

  • 在 Unity 菜单栏中，依次点击 Assets > Import Package > Custom Package
  • 找到 xxx.unitypackage 文件的下载位置并选择该文件
  • 在 Import Unity Package 对话框中，全选并点击 Import

2.2.2 Cocos​

详细的unity接入说明可查看Cocos插件接入文档

请将下载的SDK包中的cocos目录下对应版本的TOPCustomerService.ts复制到工程目录->assets下即可

2.3 导出Xcode工程（Unity、Cocos）​

2.3.1 Unity​

在菜单->File->Build Setting弹窗中，选择iOS平台，并点击Build导出工程

2.3.2 Cocos​

在CocosCreator中的菜单->项目->构建发布弹窗中，点击新建构建任务，发布平台选择iOS，点击构建即可

2.4 运行工具​

双击TopSDKTool会弹出命令行窗口，按照工具提示进行操作即可

tips：如果该文件没有可执行权限，请先在终端输入以下命令进行授权

chmod 777 【TopSDKTool文件路径】
例：chmod 777 ~/Desktop/TopSDKTool

2.4.1 选择开发引擎​

选择游戏引擎
1 unity
2 cocos
3 ios
请输入序号进行选择：根据项目开发引擎选择

如果是unity引擎，由于版本差异性，还需要选择引擎版本

选择unity版本（如果没有，请选择最接近的版本）：
1 2017.4.40c1
2 2018.4.31f1
3 2019.4.28f1c1
4 2020.2.3f1c1
5 2020.3.1f1c1
6 2021.1.14f1c1
7 other
请输入序号进行选择：选择对应版本，如不在罗列版本内，请选择最接近的版本

2.4.2 输入.xcodeproj文件路径​

输入工程中的.xcodeproj文件的完整路径，可通过将.xcodeproj文件拖入终端窗口自动填入

请输入工程（.xcodeproj）文件路径：将导出的xcode工程文件，以.xcodeproj结尾的文件拖入终端即可

2.4.3 检查结果​

配置接入完成，则可以看到如下输出：

*** 接入结束 ***

没有这行输出的，则都为接入失败，请参照提示信息修改

如果工具使用异常可以联系对接技术咨询，或者参照iOS Xcode接入文档 手动接入