跳到主要内容

Cocos Creator 原生适配器

概览​

Cocos Native 适配器是云开发为 Cocos Creator 原生平台（iOS/Android）提供的专用适配器，让开发者能够在 Cocos Creator 原生项目中无缝使用云开发的完整功能。通过该适配器，您可以轻松实现移动端的云端数据存储、用户认证、文件管理和云函数调用等。

支持平台​

目前已适配以下平台：

  • Cocos Creator 支持的所有平台

环境要求​

  • Node.js >= 22
  • Cocos Creator 3.x
  • @cloudbase/js-sdk >= 2.25.1
  • @cloudbase/adapter-cocos_native >= 1.0.0

效果展示​

完整示例项目请参考：CloudBase Cocos Demo

安装​

使用 npm 安装：

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

快速开始​

适配器配置​

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

// 注册适配器
cloudbase.useAdapters(adapter);

const app = cloudbase.init({
  env: "your-env-id", // 替换为您的环境 ID
  region: "ap-shanghai", // 地域
  accessKey: "your-access-key", // Publishable Key
});

export default app;
重要提示

adapter 必须在 cloudbase.init() 之前调用

特性说明​

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

环境检测​

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

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

主要依赖​

依赖版本说明
@cloudbase/js-sdk>=2.25.1腾讯云开发 SDK
@cloudbase/adapter-cocos_native^1.0.0Cocos Native 适配器

常见问题​

Q: 为什么要在 init 之前调用 useAdapters？​

A: 适配器需要在 SDK 初始化之前注册，以确保 SDK 能够正确识别当前运行环境并使用相应的适配器。

Q: 本地存储有什么限制？​

A: Cocos Native 环境使用 cc.sys.localStorage 进行本地存储，不支持 sessionStorage。

Q: 支持哪些版本的 Cocos Creator？​

A: 适配器支持 Cocos Creator 3.x 版本。

相关资源​