cocos联调注意事项-IOS

一:交互代码示例:

1、游戏内调用IOS方法

由于 Cocos iOS 侧通过 Objective-C 反射调用原生静态方法,所有 SDK 方法已封装在

FunSmithCocosBridge 类里,方法名与文档一致。

import { native, sys } from 'cc';

const CLASS = 'FunSmithCocosBridge';

function callStatic(method: string, ...args: any\[\]) {

if (sys.isNative && sys.os === sys.OS.IOS && native.reflection) {

native.reflection.callStaticMethod(CLASS, method, ...args);

} else {

console.warn('SdkBridge 非 iOS 原生环境,跳过', method);

}

}

1.1 无参数时

export const sdkInit = () => callStatic('SDKInit');

1.2 有参数时

iOS 方法名带参数时,方法名末尾需要带 :

export const sdkShowBanner = (json: string) => callStatic('SDKShowBanner:', json);

2、IOS 回调 游戏方法已在 桥接 文件里写好,方法名与文档一致,无需调整。

iOS 回调 Cocos 说明 :

iOS 桥接文件中已经统一封装了 SDK 回调逻辑。SDK 在原生侧产生异步结果后,会通过 Cocos JS 引擎回调游戏层的全局方法: window.FunSmithSdkCallback(methodName, data) 其中: - methodName:回调事件名 - data:回调数据字符串,通常为 JSON 字符串 游戏研发只需要在 Cocos 脚本初始化阶段注册 window.FunSmithSdkCallback,用于统一接收 SDK 回调。

二:播放广告流程

1、先调用检测广告SDKCheckAdReady接口,收到检测结果CheckAdReady回调。

2、根据返回的数据判断有广告时才调用播放广告接口,无广告时可以弹相关提示

3、收到播放广告成功ShowAdSuccess回调,发放奖励

4、收到播放广告失败ShowAdFail回调,可以弹相关提示

三:打包注意事项

1、自2026 年 4 月 28 日起,所有提审包硬性规则:

4.1 必须使用 Xcode 26 及以上版本

4.2 Unity Player Settings 里也要把 Minimum iOS Version 设置为 15

2、cocos导出xcode工程

3、因为IOS不能像安卓一样在demo里接好SDK,需要在游戏导出的xcode工程里对接,而且每次导出工程均需要重新对接一遍,强烈建议直接用脚本对接,脚本工具包如下(脚本用python写的,推荐 Python 3.9+ )

4、脚本执行方法:python3 cocos_ios_sdk.py文件路径 游戏导出的xcode工程路径 --resolve-packages(第一次对接需要拉取海外sdk的远程库资源,时间较久,第二次就会很快)执行完成后打开xcode工程。(如果脚本接入异常看文章末尾)

5、接入完成后sdk资源如下

6、脚本接入完成后,桥接文件位置如下图,后期有需求变动,也是修改这俩文件(我会把修改好需求的桥接文件重新发一份,然后打开本地目录去替换,不要在工程里替换,不会自动引用)

7、真机测试:游戏导出的xcode工程(需要添加苹果账号才能安装)

然后选Team-下拉框-组织, (首次添加苹果账号,注意需要发行授予该账号developer权限,拉取签名信息)

相关推荐
茶底世界之下16 小时前
洗衣房的午后斜光:用 Awaking 把光和影分开
ios·app·产品
我是谁的程序员1 天前
iOS 性能分析在 Windows 上怎么做,用 KXBuild 的 kxdevice 替代 Instruments
后端·ios
开心就好20251 天前
通配符 Bundle ID 和精确 Bundle ID 怎么选,推送、iCloud 能不能用通配符
后端·ios
布莱克6052 天前
Swift 枚举详解:从基础语法到关联值与模式匹配
开发语言·ios·swift·枚举
茶底世界之下2 天前
冬日窗边的早餐:用 Awaking 留住冷光里的暖意
ios·app·产品
布莱克6052 天前
Swift 闭包详解:从语法到实战的完整指南
服务器·开发语言·ios·ssh·swift·闭包
茶底世界之下3 天前
雨后的黄电车:用 Awaking 给灰色街景定一个主角
ios·app·产品
恋猫de小郭3 天前
iOS for Web ,把原生 iOS App 跑到进浏览器里面,倒反天罡
android·前端·ios
wuxianda10303 天前
Swift 项目用 Xcode 脚手架起步:默认工程结构和依赖组合为什么会被识别成同源
开发语言·xcode·swift·4.3a·appstore审核
00后程序员3 天前
iOS 实时活动怎么开发,Windows 上用 KXBuild 和 ActivityKit 写灵动岛
后端·ios