一文读懂Uniapp自定义运行环境和条件编译平台

前端

2022-12-16 13:39:50

自定义运行环境和条件编译平台：提升 Uniapp 项目管理和部署

在 Uniapp 项目开发中，随着项目复杂度的不断提升，管理和部署项目也变得愈发重要。自定义运行环境和条件编译平台 是 Uniapp 提供的强大工具，帮助开发者轻松应对不同环境下的联调和打包需求。

一、自定义运行环境的意义

在不同环境下进行联调或打包，是项目开发过程中经常遇到的需求。例如，开发者可能需要在开发环境下调试功能，而在生产环境下部署正式版本。自定义运行环境可以让开发者轻松切换运行环境，满足不同场景下的需求。

二、自定义运行环境的方法

Uniapp 提供了两种自定义运行环境的方法：

使用 Uniapp 的内置环境变量： Uniapp 提供了三个内置的环境变量：UNI_PLATFORM、UNI_ENV 和 UNI_SUB_ENV，分别表示当前运行的平台、环境和子环境。开发者可以通过设置这些环境变量来切换运行环境。例如，在终端中输入以下命令即可切换到开发环境：

export UNI_ENV=development

使用自定义环境变量： 除了内置环境变量，开发者还可以自定义环境变量。例如，为不同服务器请求地址创建自定义环境变量：

export API_URL=http://dev.example.com

通过设置自定义环境变量，开发者可以在不同环境中使用不同的服务器请求地址。

三、自定义条件编译平台的意义

在 Uniapp 项目中，不同的代码片段可能需要在特定的平台上运行。例如，开发者可能需要在 H5 平台上运行特定代码，而在 APP 平台上运行另一部分代码。自定义条件编译平台 允许开发者指定代码在哪个平台上运行，从而实现平台无关的开发。

四、自定义条件编译平台的方法

Uniapp 提供了两种自定义条件编译平台的方法：

使用 Uniapp 的内置条件编译平台： Uniapp 提供了三个内置的条件编译平台：H5、APP 和 MP-WEIXIN，分别表示 H5 平台、APP 平台和微信小程序平台。开发者可以通过设置条件编译平台来指定代码在哪个平台上运行。例如，以下代码片段指定代码只在 H5 平台上运行：

#ifdef H5
// 这段代码只在 H5 平台上运行
#endif

使用自定义条件编译平台： 除了内置条件编译平台，开发者还可以自定义条件编译平台。例如，创建自定义条件编译平台 my-platform：

#ifdef my-platform
// 这段代码只在 my-platform 平台上运行
#endif

通过自定义条件编译平台，开发者可以灵活地指定代码在不同平台上的运行方式。

五、动态修改 manifest.json 值

manifest.json 文件是 Uniapp 项目的配置文件，包含了项目的各种配置信息。开发者可以通过修改 manifest.json 文件来实现不同的功能。例如，为不同的环境设置不同的服务器请求地址：

{
  "h5": {
    "devServer": {
      "proxy": {
        "/api/*": {
          "target": "http://dev.example.com",
          "changeOrigin": true
        }
      }
    }
  },
  "mp-weixin": {
    "devServer": {
      "proxy": {
        "/api/*": {
          "target": "http://test.example.com",
          "changeOrigin": true
        }
      }
    }
  }
}