微信SDK安装
- 请查阅推荐引擎版本,安装时选择 WeiXin MiniGame(团结引擎)或 WebGL(Unity引擎)组件
- 前往微信开发者工具下载安装Stable版开发者工具【注意:为保证稳定性,请勿使用小游戏版 Minigame Build】
- 查阅小游戏开发者文档-快速上手创建小游戏类目应用
- 登录MP微信公众平台,能力地图-生产提效包-快适配,开通使用
- 查阅快速开始:转换工具导出微信小游戏进行小游戏导出转换
为兼容历史团结/Unity版本的使用,微信小游戏团队将SDK分为如下两种模式安装使用。
方法一(推荐):Package 方式安装
目前团结引擎、Unity 2019及以后版本推荐使用 Package 方式安装WXSDK。
安装指南
打开游戏工程
-> Unity/团结引擎 Editor 菜单栏
-> Package Manager
-> 右上方 “+”
-> Add package from git URL
URL地址为:
https://github.com/wechat-miniprogram/minigame-tuanjie-transform-sdk.git
或国内Gitee镜像:
https://gitee.com/wechat-minigame/minigame-tuanjie-transform-sdk.git
即可完成SDK导入。
方法二:资源包方式安装
对于 Unity 2018 版本引擎使用资源包方式可安装 WXSDK
安装指南
如果当前版本暂不支持 PackageManager 导入,请 下载UnitySDK 后导入游戏工程中。
目录结构说明
我们希望SDK与工程代码解耦,如此一来也更方便开发者的代码版本维护。因此 PackageManager 模式下,微信SDK内容将不再存放在游戏工程的Assets目录中。为兼容需要,仍然会自动在 Assets 目录下创建 WX-WASM-SDK-V2
数据目录,如需保持相关的应用配置应始终保留该目录内容。
常见问题
1.游戏工程可以导出但在微信开发者工具运行提示报错:
常见的情况是发生在如空项目或游戏代码中从未使用WXSDK的任何Runtime能力时,引擎导出项目将微信Runtime包裁剪,解决办法是在游戏合理位置增加对WXSDK的使用即可。 如:
c#
// 无直接的API能力调用可使用读取系统信息等API
WX.GetSystemInfo(new GetSystemInfoOption()); // 读取SystemInfo