1
0
mirror of https://github.com/ialley-workshop-open/uni-halo.git synced 2026-09-12 16:40:40 +08:00
Files
uni-halo/.agents/bak-skills/uniapp-uview/examples/integration/manifest-config.md
T
2026-08-31 07:58:23 +08:00

3.4 KiB

Manifest Configuration

manifest.json 配置

manifest.json 是 UniApp 的应用配置文件,需要正确配置以支持 uView UI 在不同平台运行。

基本配置

{
  "name": "uniapp-uview-project",
  "appid": "",
  "description": "",
  "versionName": "1.0.0",
  "versionCode": "100",
  "transformPx": false,
  "app-plus": {
    "usingComponents": true
  },
  "h5": {
    "router": {
      "mode": "hash"
    }
  },
  "mp-weixin": {
    "appid": "",
    "setting": {
      "urlCheck": false
    },
    "usingComponents": true
  }
}

H5 平台配置

{
  "h5": {
    "router": {
      "mode": "hash",
      "base": "/"
    },
    "devServer": {
      "https": false,
      "port": 8080
    },
    "publicPath": "/",
    "template": "index.html"
  }
}

微信小程序配置

{
  "mp-weixin": {
    "appid": "your-appid",
    "setting": {
      "urlCheck": false,
      "es6": true,
      "enhance": true,
      "postcss": true,
      "minified": true
    },
    "usingComponents": true,
    "permission": {
      "scope.userLocation": {
        "desc": "你的位置信息将用于小程序位置接口的效果展示"
      }
    }
  }
}

App 平台配置

{
  "app-plus": {
    "usingComponents": true,
    "nvueStyleCompiler": "uni-app",
    "splashscreen": {
      "alwaysShowBeforeRender": true,
      "waiting": true,
      "autoclose": true,
      "delay": 0
    },
    "modules": {},
    "distribute": {
      "android": {
        "permissions": [
          "<uses-permission android:name=\"android.permission.INTERNET\"/>"
        ]
      },
      "ios": {},
      "sdkConfigs": {}
    }
  }
}

支付宝小程序配置

{
  "mp-alipay": {
    "usingComponents": true
  }
}

百度小程序配置

{
  "mp-baidu": {
    "usingComponents": true
  }
}

字节跳动小程序配置

{
  "mp-toutiao": {
    "usingComponents": true
  }
}

QQ 小程序配置

{
  "mp-qq": {
    "usingComponents": true
  }
}

完整配置示例

{
  "name": "uniapp-uview-project",
  "appid": "",
  "description": "UniApp + uView UI 项目",
  "versionName": "1.0.0",
  "versionCode": "100",
  "transformPx": false,
  "app-plus": {
    "usingComponents": true,
    "nvueStyleCompiler": "uni-app"
  },
  "h5": {
    "router": {
      "mode": "hash"
    },
    "devServer": {
      "port": 8080
    }
  },
  "mp-weixin": {
    "appid": "",
    "setting": {
      "urlCheck": false,
      "es6": true,
      "enhance": true,
      "postcss": true,
      "minified": true
    },
    "usingComponents": true
  },
  "mp-alipay": {
    "usingComponents": true
  },
  "mp-baidu": {
    "usingComponents": true
  },
  "mp-toutiao": {
    "usingComponents": true
  },
  "mp-qq": {
    "usingComponents": true
  },
  "quickapp": {},
  "vueVersion": "3"
}

关键配置说明

usingComponents

所有平台都需要设置 "usingComponents": true,以支持组件使用。

transformPx

建议设置为 false,使用 rpx 单位进行响应式布局。

vueVersion

指定 Vue 版本:

  • "2" - Vue 2
  • "3" - Vue 3

注意事项

  1. usingComponents:必须设置为 true
  2. 平台差异:不同平台有不同的配置项
  3. AppID:小程序平台需要配置对应的 AppID
  4. 权限配置:根据功能需求配置相应权限
  5. 版本号:正确配置版本号和版本名称