CloudBase Cocos Native Adapter

概述

CloudBase Cocos Native Adapter 是专为 Cocos Creator 原生平台（iOS/Android）设计的腾讯云开发适配器。它让开发者能够在 Cocos Creator 原生项目中无缝集成腾讯云开发的核心能力，包括数据库、云存储、云函数、数据模型等。

特性

• 完全兼容 Cocos Creator 原生平台（iOS/Android）
• 使用 XMLHttpRequest 进行网络请求，兼容性更好
• 内置 AbortController polyfill，支持请求中止
• 使用 cc.sys.localStorage 进行本地存储

安装

npm install @cloudbase/adapter-cocos_native @cloudbase/js-sdk

快速开始

在 Cocos Creator 项目中引入并初始化适配器：

import cloudbase from '@cloudbase/js-sdk';
import adapter from '@cloudbase/adapter-cocos_native';

// 使用 Cocos Native 适配器
cloudbase.useAdapters(adapter);

// 初始化 CloudBase 应用实例
const app = cloudbase.init({
  env: 'your-env-id',           // 替换为您的云开发环境 ID
  region: 'ap-shanghai',         // 地域
  accessKey: 'your-access-key',  // 替换为您的 Publishable Key
});

export const auth = app.auth;
export default app;

@cloudbase/js-sdk 使用方法请参考：JS SDK(V3)

环境检测

适配器会自动检测当前是否为 Cocos Native 环境，检测条件包括：

• cc 全局对象存在
• cc.sys.isNative 为 true
• XMLHttpRequest 和 WebSocket 可用

注意事项

• 网络请求：使用 XMLHttpRequest 实现，已针对 Cocos Native 平台进行兼容性优化
• 本地存储：使用 cc.sys.localStorage，原生环境不支持 sessionStorage
• AbortController：内置 polyfill，无需额外安装

版本要求

| 依赖 | 版本 | |------|------| | @cloudbase/js-sdk | >=2.25.1 | | Cocos Creator | 3.x | | Node | 22.x |

示例展示

CloudBase Cocos Demo示例请参考 示例代码

相关资源

• CloudBase JavaScript SDK
• 适配器开发指引
• Cocos Creator 官方文档