自定义基座如何才能安装成功

欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。

根据知识库内容，针对您遇到的"同步资源失败"和自定义基座安装问题，以下是详细解答：

同步资源失败的主要原因

您遇到的"同步资源失败，未得到同步资源的授权"错误，很可能是由于手机系统的分身功能导致的。具体表现为：在手机的初始空间运行安装基座，但基座被安装到了系统分身里头，导致资源同步授权失败。参考案例

解决方案：检查手机设置，确保基座安装到正确的系统空间，或在手机设置中调整分身相关权限设置。

自定义基座是否安装成功的判断

如果您已经将自定义基座 apk 安装到手机，但运行项目时仍提示同步资源失败或找不到插件，说明基座没有正确生效。正确的自定义基座安装成功后：

1. 手机上会有您应用图标（不是标准基座的 HBuilder 图标）
2. 运行项目时，HBuilderX 控制台不会提示"同步资源失败"
3. 如果是包含原生插件的基座，不会提示"[JS Framework] 当前运行的基座不包含原生插件"

正确的自定义基座安装步骤

请严格按照以下步骤操作：

第一步：制作自定义基座

• 在 HBuilderX 中，点击菜单【运行】→【运行到手机或模拟器】→【制作自定义基座】
• 或使用【发行】→【原生 App - 云打包】，勾选"自定义调试基座"（Android 勾选 apk）
• 必须使用真机，安卓模拟器可能存在兼容性问题

第二步：确保基座正确安装

• 打包完成后，如果通过 USB 安装失败，请根据提示手动安装 unpackage/debug/android_debug.apk
• 关键操作：如果之前安装过旧基座，务必先删除手机上的旧应用和旧基座，路径在 unpackage 文件夹内
• 安卓手机在 USB 安装时可能会弹框提示，需及时点击允许，否则会超时安装失败

第三步：运行时必须勾选自定义基座

• 点击菜单【运行】→【运行到手机或模拟器】→【运行基座选择】，务必勾选"自定义调试基座"
• 如果不勾选，即使安装了自定义基座，也会使用标准基座运行，导致资源同步失败

第四步：检查原生插件配置

• 如果使用了原生插件，需在 manifest.json →【App 原生插件配置】中勾选对应插件
• 修改插件或版本后，必须重新制作自定义基座才能生效

特别注意

1. 自定义基座不是正式版，仅用于调试，发布时需要重新提交云端打包（不勾选自定义基座）
2. 版本号问题：自定义基座如果没改版本号，可能不会同步资源；离线打包需要手动改为 release 模式才会同步
3. 真机要求：自定义基座主要用于真机调试，安卓模拟器可能存在限制，建议优先使用真机测试

如果按以上步骤操作后仍有问题，建议检查手机是否开启了代理或 VPN，这也会导致基座同步失败。