uniapp package.json配置详解

在uniapp项目中，package.json文件有哪些必须配置的字段？如何配置第三方插件依赖？有没有针对uniapp的特殊配置项需要注意？求详细配置示例和说明。

2 回复

uniapp的package.json是项目配置文件，主要包含以下核心字段：

基础配置

  • name：项目名称（小写字母+连字符）
  • version：版本号（遵循semver规范）
  • description：项目描述

依赖管理

  • dependencies：生产环境依赖
  • devDependencies：开发环境依赖
  • uni-app：指定uniapp框架版本

uniapp特有配置

{
  "uni-app": {
    "scripts": {
      "custom-platform": {
        "title":"自定义平台",
        "env": {"UNI_PLATFORM":"custom"},
        "define": {"CUSTOM_CONST":"hello"}
      }
    }
  }
}

脚本命令

  • dev：开发环境运行
  • build：生产环境打包
  • custom：自定义平台编译

注意事项

  1. 修改后需重新运行项目生效
  2. 不支持npm scripts钩子（如preinstall）
  3. 平台差异需通过条件编译处理

建议通过HBuilderX可视化界面修改配置，避免格式错误。


UniApp的package.json是项目配置文件，用于管理依赖、脚本和项目信息。以下是关键配置项详解：

基础结构

{
  "name": "项目名称",
  "version": "1.0.0",
  "description": "项目描述",
  "main": "main.js",
  "scripts": {
    "dev": "npm run dev:h5",
    "dev:h5": "uni -p h5",
    "build": "npm run build:h5",
    "build:h5": "uni build -p h5"
  },
  "dependencies": {
    "@dcloudio/uni-app": "^3.0.0"
  },
  "devDependencies": {
    "@dcloudio/uni-cli-shared": "^3.0.0"
  },
  "uni-app": {
    "scripts": {}
  }
}

核心配置说明

  1. scripts
    定义命令行脚本，例如：

    • dev:mp-weixin: 微信小程序开发环境
    • build:app-plus: 打包App

  2. dependencies
    生产环境依赖（如UI库、工具库）。

  3. devDependencies
    开发环境依赖（如编译器、插件）。

  4. uni-app 扩展配置

    "uni-app": {
  "scripts": {
    "mp-weixin": {
      "title": "微信小程序配置",
      "env": {
        "UNI_PLATFORM": "mp-weixin"
      },
      "define": {
        "MY_CONST": "value"
      }
    }
  }
}
    • 定义平台特有配置（如微信小程序AppID）。
    • 注入全局变量（通过define）。

注意事项

  • 使用HBuilderX创建项目时，部分配置会自动生成。
  • 修改后需重启开发服务器或重新打包。
  • 平台配置需与manifest.json配合使用。

通过合理配置可优化多平台开发流程。

回到顶部