# 2、Android 启动失败

# a) 尚未完成 SDK 初始化

当应用启动时遇到如下错误提示时，可参考下方的方式进行排查

# 排查步骤

1、检查手机是否已经成功联网；如尚未联网，请联网后重试

2、前往开发者工具进入项目中查看「project.miniapp.json」文件中的 "sdkKey" 和 “sdkKeySecret” 是否与 Donut 平台open in new window中多端应用的 SDKKey 和 SDKSecret 一致

注意，需使用 1.06.2303012open in new window 之后的新版本才可在「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 再安装即可。

开发者可在终端执行下方命令后即可解决该问题。（可以通过“活动监视器”查看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 的扩展模块导致的，查看说明文档open in new window
可在 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 通道或透明度