WHAT - uni-app 条件编译技术

在 UniApp 中，条件编译是一种根据不同的平台或环境，编译出不同代码的技术。

由于 UniApp 支持多端开发（如 H5、小程序、App 等），不同平台的 API、组件和功能可能存在差异，因此条件编译可以帮助开发者编写平台特定的代码，确保应用在不同平台上都能正常运行。

条件编译的语法

UniApp 的条件编译使用 #ifdef 和 #ifndef 指令，结合平台标识符来实现。

• #ifdef：表示“如果定义了某个平台标识符，则编译该部分代码”。
• #ifndef：表示“如果没有定义某个平台标识符，则编译该部分代码”。

平台标识符

UniApp 提供了以下常见的平台标识符：

• APP-PLUS：App 平台（包括 iOS 和 Android）
• H5：H5 平台
• MP-WEIXIN：微信小程序
• MP-ALIPAY：支付宝小程序
• MP-BAIDU：百度小程序
• MP-TOUTIAO：字节跳动小程序
• MP-QQ：QQ 小程序
• MP-JD：京东小程序
• MP-KUAISHOU：快手小程序
• MP-UNIAPP：跨端编译时使用的标识符

条件编译的使用示例

1. 在 JavaScript 中使用条件编译

// #ifdef APP-PLUS
console.log('这段代码只在 App 平台运行');
// #endif

// #ifdef H5
console.log('这段代码只在 H5 平台运行');
// #endif

// #ifdef MP-WEIXIN
console.log('这段代码只在微信小程序平台运行');
// #endif

2. 在 Vue 模板中使用条件编译

<template>
  <view>
    <!-- #ifdef APP-PLUS -->
    <view>这段代码只在 App 平台显示</view>
    <!-- #endif -->

    <!-- #ifdef H5 -->
    <view>这段代码只在 H5 平台显示</view>
    <!-- #endif -->

    <!-- #ifdef MP-WEIXIN -->
    <view>这段代码只在微信小程序平台显示</view>
    <!-- #endif -->
  </view>
</template>

3. 在 CSS 中使用条件编译

/* #ifdef APP-PLUS */
.custom-class {
  color: red;
}
/* #endif */

/* #ifdef H5 */
.custom-class {
  color: blue;
}
/* #endif */

跨端编译

UniApp 支持跨端编译，即一套代码可以同时编译到多个平台。

在跨端编译时，可以使用 MP-UNIAPP 标识符来编写适用于所有平台的代码。

// #ifdef MP-UNIAPP
console.log('这段代码在所有小程序平台都会运行');
// #endif

注意事项

1. 条件编译的优先级：如果多个条件编译指令同时满足，只会编译第一个匹配的代码块。
2. 条件编译的范围：条件编译可以用于 JavaScript、Vue 模板、CSS 等文件中。
3. 平台标识符的准确性：确保使用的平台标识符正确，否则条件编译可能不会生效。

示例：跨端兼容处理

// 通用逻辑
function commonFunction() {
  console.log('这是通用逻辑');
}

// 平台特定逻辑
// #ifdef APP-PLUS
function appSpecificFunction() {
  console.log('这是 App 平台特定逻辑');
}
// #endif

// #ifdef H5
function h5SpecificFunction() {
  console.log('这是 H5 平台特定逻辑');
}
// #endif

// 调用函数
commonFunction();

// #ifdef APP-PLUS
appSpecificFunction();
// #endif

// #ifdef H5
h5SpecificFunction();
// #endif

通过条件编译，开发者可以轻松地处理不同平台的差异，确保应用在各个平台上都能正常运行。