App 专题

1. 其他端正常，App 白屏

请检查 useXxxStore 的调用，需要在函数内部调用，而不是在函数外部调用。(估计是顶层调用的时候 pinia 没有初始化，导致的问题，app 端独有的问题。)

// 错误写法
const userStore = useUserStore();
function foo() {
  userStore.xxx;
}
// 正确写法
function foo() {
  const userStore = useUserStore();
  userStore.xxx;
}

2.unibest 的 App 模块配置

核心解决办法就是把 manifest.json 的内容搬运到 manifest.config.ts 中。

我们默认的的 manifest.config.ts 只包含了比较基础的 uniapp 配置，有的时候我们需要在打包 app 时在 hbuilderx 里面额外设置一些配置，那么就需要配置好后把 manifest.json 中的内容拷贝到 manifest.config.ts 中，后面运行就不会丢失了。

举例子，我在 manifest.json 里面配置了 2 个模块配置，如下：

点击左侧下面的 源码视图 就可以看到增加了如下内容：

只需要把对应的内容拷贝到 manifest.config.ts 中的 distribute.plugins 里面即可。

3. app 热更新

3.1 ios 模拟器热更新

• pnpm dev:app
• 把 dist/dev/app 文件夹导入到 hbx编辑器 里面，然后运行。这样在编码的时候是可以热更新的。

但是上面的方法，在 android 模拟器里面不生效。

3.2 android 热更新

• 在 android 里面，把dist/dev/app 文件夹导入到 hbx编辑器 里面运行，无法热更新！！
• 需要把整个 unibest 项目文件夹 导入到 hbx编辑器 里面，然后运行，这样就可以热更新。
• 不管是模拟器还是真机调试，都是这样。

3.3. 鸿蒙 热更新

同 android 热更新。

4. 打包原生插件

这里说的是传统 uni-app App 原生语言插件，不是 UTS 插件。

思路：把整个 unibest 项目导入 HBuilderX，把本地原生插件放到项目根目录的 nativeplugins 目录，在 src/manifest.json 里配置好 App 原生插件，再把新增配置同步到 manifest.config.ts，最后制作包含该插件的自定义运行基座。

注意：标准基座不包含你自己的本地原生插件。出现“当前运行的基座不包含原生插件”时，通常是还在使用标准基座，或者自定义基座没有重新包含该插件。

pnpm build:app 会把项目根目录的 nativeplugins 自动复制到 dist/build/app/nativeplugins。如果没有复制，请确认 env/.env 中的 VITE_COPY_NATIVE_RES_ENABLE 为 true。

步骤：

• 1. 把本地原生插件放到项目根目录的 nativeplugins 目录下。目录名使用官方约定的全小写 nativeplugins。

• 2. 在 HBuilderX 里打开整个 unibest 项目，在 src/manifest.json 的 App 原生插件配置 中选择本地插件。

     

• 3. 切换到 manifest.json 源码视图，把新增的原生插件配置同步到 manifest.config.ts。因为 src/manifest.json 是生成文件，只改它后续会被覆盖。

• 4. 制作自定义运行基座。

     

• 5. 使用自定义基座运行或真机调试。

     

• 6. 发布时再执行 pnpm build:app，然后在 HBuilderX 中导入 dist/build/app 进行云打包或本地打包。pnpm build:app 只负责生成 App 项目文件并复制 nativeplugins，不会自动制作自定义基座。

其他参看文章 掘金教程 - Unibest 原生插件模块配置