uni-app如何配置manifest中的常用代码块设置-uni-app-PHP中文网

manifest.json中最常手动修改的配置项是应用名称、版本号、图标路径、android/ios包名或bundle id、权限声明；其他字段多数为默认值或仅特定场景调整。

uni-app如何配置manifest中的常用代码块设置

manifest.json 里哪些配置项最常被改

大部分项目真正需要手动改的，就那么几项：应用名称、版本号、图标路径、Android/iOS 的包名或 Bundle ID、权限声明。其他字段多数是默认值或只在特定场景才动。

常见错误现象：versionCode 写成字符串（如 "100"）导致云端打包失败；appid 被误删或填错，影响 DCloud 云服务调用；app-plus 下的 distribute.android.permissions 漏加，真机调试时相机/定位等功能直接报错无提示。

name 和 description 直接写中文或带空格的字符串，没问题，但上架应用商店时建议用英文+简短描述
versionName 是展示给用户的（如 "2.3.1"），versionCode 必须是整数且每次发布递增（如 231），不能是浮点或字符串
app-plus.id 在 HBuilderX 工程中对应 Android 的 package name，必须符合 Java 包名规范（全小写、点分隔、不能以数字开头），例如 "com.example.myapp"
图标路径要真实存在，且尺寸符合要求：Android 要 36x36 到 192x192 多套，iOS 要 60x60、120x120、180x180；路径写错（比如漏了 static/ 前缀）会导致图标显示为白块

Android 权限怎么加才生效

权限不是写在哪都管用。uni-app 里有两种加法：一种走 manifest.json 的封装层，一种绕过封装直写 AndroidManifest.xml。前者简单但有限制，后者灵活但容易出错。

使用场景：如果只是加 android.permission.CAMERA、android.permission.ACCESS_FINE_LOCATION 这类标准权限，优先走 manifest.json；如果要用 android:exported="true" 或自定义 intent-filter，就必须新建 AndroidManifest.xml 文件。

uni-app

uni-app 是基于 Vue 的跨端开发框架，适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载

在 manifest.json 中加权限，写在 app-plus.distribute.android.permissions 数组里，每个元素是字符串，例如："android.permission.READ_EXTERNAL_STORAGE"
不要重复声明同一权限——manifest.json 和 AndroidManifest.xml 同时写了 INTERNET，云端打包会合并冲突，日志里报 duplicate permission
Android 12+（targetSdkVersion ≥ 31）要求显式声明 android:exported，这个无法通过 manifest.json 配置，必须进 AndroidManifest.xml 手动补
所有权限声明，无论哪种方式，都必须在用户首次使用功能前主动调用 uni.authorize 或 uni.getSystemInfo 检查，否则系统不会弹授权框

minSdkVersion 和 targetSdkVersion 怎么设不踩坑

这两个值不是“越高越好”，也不是“照抄别人”。它们直接影响安装成功率、功能兼容性和审核风险。

性能 / 兼容性影响：把 minSdkVersion 设太高（比如 26），会直接排除掉约 8% 的 Android 用户（截至 2026 年数据）；把 targetSdkVersion 设太低（比如仍用 28），Google Play 会拒绝上架新版本，国内主流应用市场也会警告“未适配新系统行为”。

minSdkVersion 建议设为 21（Android 5.0）起步，低于这个值的设备已基本退出主流市场；若项目用了 WebAssembly 或某些新 JS API，可能需提到 23+
targetSdkVersion 应尽量贴近当前 Android 主流版本，2026 年推荐设为 34（Android 14），但前提是已测试过后台限制、通知渠道、剪贴板变更等行为差异
这两个值都在 manifest.json → App常用其它设置 → Android设置 里填，填完必须提交云端打包才能验证是否生效；真机运行时即使改了也看不到效果
HBuilderX 3.6.0+ 支持在项目根目录新建 AndroidManifest.xml 覆盖这些值，但不推荐——除非你明确知道 package 属性和命名空间必须严格匹配云端打包配置，否则极易打包失败

AndroidManifest.xml 文件怎么写才不被云端打包拒绝

新建 AndroidManifest.xml 不是为了炫技，而是解决 manifest.json 封装不了的问题。但它一旦存在，就会参与云端打包的 XML 合并流程，格式或内容错一点，整个包就打不出来。

容易踩的坑：文件名大小写写成 androidmanifest.xml 或 AndroidManifest.XML；根节点漏掉 xmlns:tools；package 值和云端打包配置的包名不一致；在 <application></application> 外写了 <activity></activity> 标签。

文件必须放在项目根目录，右键“新建 → 自定义文件”，输入准确名称：AndroidManifest.xml
根节点 <manifest></manifest> 必须带两个命名空间：xmlns:android="http://schemas.android.com/apk/res/android" 和 xmlns:tools="http://schemas.android.com/tools"
package 属性值必须和你在 HBuilderX 里配置的 Android 包名完全一致（包括大小写），例如 io.dcloud.xxx
所有自定义内容应写在 <application></application> 内部，比如 <meta-data></meta-data>、<provider></provider>、带 android:exported="true" 的 <activity></activity>
不要在 AndroidManifest.xml 里重复 manifest.json 已配置的权限或 application 属性，冲突时以 AndroidManifest.xml 为准，但日志会报警告