开发常见问题
一、免费使用说明
- 使用 Donut 多端框架与工具的开发、编译、调试、预览等基础功能永久免费；云构建安装包需消耗较多资源，我们已提供基础发布与更新所需的免费次数。
- 专业版于公测期可免费升级，详情可查看升级至专业版
二、开发者工具
1、提示要升级最新的开发者工具
- 文案 1：为正常使用多端应用功能，需将当前工具升级到最新 nightly 版并重新升级多端项目
- 文案 2：此版本的该功能已停止维护，请升级最新工具并使用新的升级多端项目功能
- 如出现上述的报错提示，开发者需将开发者工具升级至最新的 nightly 版，并且重新点击「升级多端项目」即可正常使用
2、编译报错
a) [summer-compiler] Couldn't found the 'xxxx.json' file relative to 'xxxx'
- 多端编译对 json 路径的校验比小程序编译更严格，因此开发者需要重新确认一下组件路径配置是否准确
三、安卓相关
1、 Android 出现 CanvasView is not a constructor
- 因为缺少了 Xweb 的扩展模块导致的，查看说明文档
- 可在
project.miniapp.json中将 Xweb 扩展 SDK 勾上
2、Android 启动失败
a) 尚未完成 SDK 初始化
- 当应用启动时遇到如下错误提示时，可参考下方的方式进行排查
排查步骤
1、检查手机是否已经成功联网；如尚未联网，请联网后重试
2、前往开发者工具进入项目中查看「project.miniapp.json」文件中的 "sdkKey" 和 “sdkKeySecret” 是否与 Donut 平台中多端应用的 SDKKey 和 SDKSecret 一致
注意，需使用 1.06.2303012 之后的新版本才可在「project.miniapp.json 」中配置"sdkKey" 和 “sdkKeySecret” 。如果是使用其他版本开发者工具生成的多端项目，开发者可全局查找"sdkKey" 和 “sdkKeySecret”即可。
b) 无权限运行此模块
- 当应用启动时遇到如下错误提示时，可参考下方的方式进行排查
排查步骤
1、请检查 miniapp/android/app/src/main/java/com/tencent/weauth/ui/MainActivity.kt 中的 launchAppModule 配置的 miniModuleId 是否与当前小程序关联的模块 Id 一致，如果不一致，需调整成一致后再重新构建即可。
补充：如果开发者在工具上进行过切换小程序账号，需重新修改 miniModuleId
注意，开发者需注意区分应用 id 和模块 id
2、 如果上述问题已经排除还是无权限运行此模块，请尝试卸载 App 再安装即可。
四、iOS 相关
1、iOS M1 的电脑出现模拟器按钮点击无响应如何处理
Xcode 版本 ≥ 14.0
- 开发者可在终端执行下方命令后即可解决该问题。（可以通过“活动监视器”查看xcode模拟器的运行架构是否是intel）
arch -x86_64 /Applications/Xcode.app/Contents/Developer/Applications/Simulator.app/Contents/MacOS/Simulator
- 上述解决方案在新版本的xcode可能依然无法生效，开发者只能在真机中调试。
Xcode 版本 < 14.0
- 开发者可参考下方步骤将模拟器的"使用 Rosetta 打开"勾上即可解决该问题
步骤1. 前往 /Applications/Xcode.app/Contents/Developer/Applications/Simulator
步骤2. 右键打开模拟器简介，并且展开“通用” ，勾选"使用 Rosetta 打开"
2、iOS 本地图片无法加载问题
- 因为缺少了 Media 的扩展模块导致的，查看说明文档
- 可在
project.miniapp.json中将 Media 扩展 SDK 勾上
3、iOS 构建 IPA 报错createAssetsCar failed。
Xcode 没有安装 iOS SDK
- 可能是 Xcode 没有安装 iOS SDK，可安装下方路径查看已安装的 SDK
- 如果尚未安装，则可点击 “get” 进行安装
Command Line Tool
出现提示 xcrun: error: unable to find utility "actool", not a developer tool or in PATH .
需在 Xcode 「Settings」->「Locations」 中设置 Command Line Tools
4、Windows 系统构建 IPA 出现乱码
如出现上述乱码问题，开发者需进行下方两个操作
1、设置保存 IPA/APK 的路径不要包含中文
2、需设置系统默认 utf-8 编码（Windows系统默认字符编码为gbk编码，需将其调整为 UTF-8）
- 按 win 键，输入"区域与语言设置"
- 选择管理语言设置
- 在弹出框中选择更改系统区域设置
- 勾选Unicode UTF-8 并点击确定和应用
- 重启系统即可，如遇问题可自行网上搜索解决方案
5、iOS 如何查看日志
iPhone 连接 Mac 电脑，通过开发者工具安装了多端应用的情况下，怎么查看应用的日志？
Mac 打开 ”控制台” 程序，右边
选择你的iPhone手机，顶部点击开始按钮。在手机上操作你的应用程序，复现问题。
在 Mac 上点击
暂停按钮，点击旁边的搜索，输入demo，类别选择进程名。即可看到多端应用的日志。
说明：
如果应用崩溃了，那么最后一条日志一般会显示崩溃原因。
如果是其他问题，那么请把日志内容共享给我们（导出到 Note 中，再保存成文件）。
6、iOS - Asset validation failed (90034)
问题描述
报错详情
报错分析
此类报错一般是因为错误使用证书导致，解决方案如下。
解决方案
操作流程
检查是否采用分发证书
点击 「签名证书管理 - iOS 签名证书管理」 -> 在「采用分发证书」选择“是”
检查是否有同名证书
打开「钥匙串」，检查是否有同名证书，若有，应删除多余的，保留一个，否则打包时输入证书签证名会产生歧义。报错提示（示例）如下：
iPhone Distribution: xxx (H9178ADUBS): ambiguous (matches "iPhone Distribution: xxx (H9178ADUBS)" and "iPhone Distribution: xxx (H9178ADUBS)" in /Users/xxxx/Library/Keychains/login.keychain)
报错情况一：登录帐号中存在相同的分发证书
报错情况二：系统帐号和登录帐号中存在相同的分发证书
证书介绍
iOS 证书有多种类型，用于不同的目的。以下是 iOS 证书的分类：
- 开发者证书（Developer Certificate）：用于在开发阶段对应用程序进行签名和调试。开发者证书由苹果开发者中心颁发，需要使用 Xcode 或者其他开发工具进行申请和管理。
- 分发证书（Distribution Certificate）：用于将应用程序分发给其他用户或者上传到 App Store 进行审核。分发证书由苹果开发者中心颁发，需要使用 Xcode 或者其他开发工具进行申请和管理。
- 推送证书（Push Certificate）：用于实现远程推送功能，可以让应用程序接收来自服务器的推送通知。推送证书由苹果开发者中心颁发，需要使用 Xcode 或者其他开发工具进行申请和管理。
- 企业证书（Enterprise Certificate）：用于将应用程序分发给企业内部员工或者客户。企业证书由苹果开发者中心颁发，需要使用 Xcode 或者其他开发工具进行申请和管理。
7、iOS - Asset validation failed (90717)
问题描述
报错详情
Invalid App Store Icon. The App Store Icon in the asset catalog in 'demo.app' can't be transparent nor contain an alpha channel. (ID: ee9a621e-b195-4e79-a700-0fbb1aa1xxxx)
报错分析
提交应用到 App Store 时，图标不能包含 alpha 通道或透明度
解决方案
关闭图像 alpha 通道可参考如下方法：
https://cloud.tencent.com/developer/ask/sof/111356139
https://developers.weixin.qq.com/community/minihome/article/doc/0008e263df8b002b67a03566a66013
8、iOS - 所选证书非有效证书
- 如果提示证书无效，则需要安装Apple全球开发者关系认证媒介中间证书，一般选择Apple Intermediate Certificates 中Worldwide Developer Relations 相关的证书。
9、iOS 构建提示 dyld: Symbol not found
需要升级 macOS >= 11.5
五、多端应用控制台
1、绑定小程序时出现“暂无可绑定的小程序”
- 详细的排查指南可查看暂无可绑定的小程序说明
六、其他
1、如何获取小程序原始 ID
在微信公众平台里获取
- 登录微信公众平台 -> 进入小程序后台 ->「设置」 -> 「基本设置」 -> 「账号信息」
在微信小程序里获取
- 在微信里搜索目标小程序 -> 打开目标小程序 -> 查看目标小程序的「更多资料」