小程序
取消
开发
中文
EN
取消
  • 云服务

    • # 跨端 JS SDK

    微信云托管团队提供了Web SDK，支持在 Web 中访问云托管资源。 但 Web SDK 只支持常规 Web 应用（即浏览器环境）的开发，不兼容其他类 Web 平台。由于类 Web 平台在网络络请求、本地存储等特性上与浏览器环境有明显差异，现提供 @wxcloud/cloud-sdk 以支持跨端适配的能力。在传入不同平台适配对象之后，在其他类 Web 平台也可以 callContainer 的形式访问微信云托管资源。

    # 目的

    目前市面上大部分的轻应用、小程序包括移动应用APP都是采用JS来作为开发语言的，所以我们可以对websdk进行轻微改造，就可以轻松使用在各种平台中。

    但是单独改造SDK包会有些许风险，比如在原SDK包升级时需要重新构造，就造成了无穷无尽的麻烦，改造成本相当大。

    基于这个问题，我们提供一套完整的适配扩展方案，遵循此方案规范可开发对应平台的适配器，然后搭配 @wxcloud/cloud-sdk 和适配器实现平台的兼容性。

    不了解的小伙伴肯定会有些茫然，我来用浅显的语言解释一下，就是@wxcloud/cloud-sdk 将底层的网络请求以及相关基础需求以接口的形式暴露出来，我们按照平台的特殊API来补充这些接口，sdk就可以根据这些补充的接口，无障碍的运行在平台中了。

    # 安装

    npm install @wxcloud/cloud-sdk --save

    # 使用

    @wxcloud/cloud-sdk 导出了 useAdapter 和 initCloud 方法。先通过 useAdapter 传入跨端的适配对象，然后调用 initCloud 获取 cloud 对象，即引入 Web SDK 时自动挂载在 window 下的 cloud 。

    const { useAdapter, initCloud } = require('@wxcloud/cloud-sdk')
import { adapters } from './example/adapters'

// platform 可传入标识平台的字符
useAdapter({ adapters, platform: 'platform' })
const cloud = initCloud()

    在浏览器环境中使用可以不调用 useAdapter。

    const { initCloud } = require('@wxcloud/cloud-sdk')

const cloud = initCloud()

    具体使用以及适配器需要实现的细节，请移步npm文档

    我们已经实现了uni-app的适配器，可以参考此项目。

    # 注意事项

    1. downloadFile、uploadFile 暂不支持适配。
    2. 公众号登录相关的 api 在微信客户端之外调用无法正常完成相应逻辑。
    3. 对于 @wxcloud/cloud-sdk 的问题，欢迎在微信开放社区发帖提问。