🍣
HarmonyOS開発実践：柔軟なコンパイルオプションのカスタマイズで効率的なアプリケーションを構築する

2025/06/30に公開
HarmonyOS開発の広い分野において、柔軟なコンパイルオプションのカスタマイズは、すべての開発者が欠かせないスキルです。このスキルは、アプリケーションのパフォーマンスに影響を及ぼすだけでなく、アプリケーションが異なるシナリオで安定し、ユーザー エクスペリエンスに直接関連するものです。本稿では、HarmonyOS開発でどのように巧妙にコンパイルオプションをカスタマイズするかを深く探り、実用的な実践経験や専門的なノウハウをいくつか共有します。

 一、プロジェクトレベルの設定の解析
 1. 製品カテゴリ設定 (products)HarmonyOSプロジェクトのビルド設定では、productsフィールドが製品カテゴリを定義する鍵です。各製品カテゴリは、異なるビジネスニーズを満たすための独自のコンパイル設定を持っています。以下は、典型的な製品カテゴリ設定の例です。
"products": [
  {
    "name": "default",
    "signingConfig": "defaultSigning",
    "compileSdkVersion": "4.1.0(11)",
    "compatibleSdkVersion": "4.1.0(11)",
    "runtimeOS": "HarmonyOS",
    "output": {
      "artifactName": "default_app"
    },
    "buildOption": {
      "arkOptions": {
        "buildProfileFields": {
          "IS_PRODUCTION": false,
          "URL_BASE": "https://*"
        }
      }
    }
  }
  // ... その他の製品カテゴリ設定
]

name：製品カテゴリの名前を定義し、ビルド時に異なる製品を区別するのに便利です。

signingConfig：製品カテゴリに対応する署名設定を指定し、アプリケーションのセキュリティを保証します。

compileSdkVersion と compatibleSdkVersion：それぞれがビルド時に使用するSDKバージョンと実行時に使用するSDKバージョンを定義し、アプリケーションの互換性と安定性を保証します。

runtimeOS：アプリケーションの実行環境がHarmonyOSであることを明確にします。

output：出力されるアーティファクトの名前などの出力に関する情報を設定します。

buildOption：強力なフィールドで、ARK（HarmonyOSアプリケーションランタイム）のコンパイルオプションをカスタマイズすることができます。例えば、buildProfileFieldsは、コード内でマクロ定義を通じて異なるコンパイル環境と設定を区別することができます。

 2. ビルドモード設定 (buildModeSet)buildModeSetフィールドは、ビルドモードの集合を定義する場所です。異なるビルドモードは、異なるコンパイルパラメーターと出力製品に対応し、開発の異なる段階のニーズを満たします。
"buildModeSet": [
  {
    "name": "debug"
  },
  {
    "name": "release"
  }
]

name：ビルドモードの名前を定義し、例えばdebug（デバッグモード）とrelease（リリースモード）があります。ビルドプロセス中、ニーズに応じて適切なビルドモードを選択することで、最適なビルド結果を得ることができます。
HarmonyOS開発では、柔軟なコンパイルオプションをカスタマイズすることは、効率的で安定した開発を実現する鍵です。productsやbuildModeSetなどのフィールドを適切に設定することで、アプリケーションが異なる段階と環境で最適なコンパイル結果を得られることを保証できます。これらの設定オプションの意味と役割を深く理解することで、HarmonyOS開発のエッセンスをよりよく掌握し、開発効率と品質を向上させることができます。

 3. モジュールとターゲットの設定 (modules と targets)HarmonyOS開発の世界では、modules と targets は非常に重要な役割を果たします。modules はプロジェクト内の各モジュールとそのソースコードの場所を定義し、targets はこれらのモジュールからビルドされるAPP製品を指し示します。
"modules": [
  {
    "name": "entry",
    "srcPath": "./entry",
    "targets": [
      {
        "name": "default",
        "applyToProducts": ["default"]
      }
    ]
  },
  // ... その他のモジュール設定
]

name：各モジュールには一意の名前があり、識別と管理が容易です。

srcPath：このフィールドは、モジュールのソースコードが格納されているディレクトリを指定し、プロジェクトのルートディレクトリからの相対パスです。

targets：各モジュールは複数のtargetを持つことができ、各targetは1つのビルド製品に対応します。

name：targetの名前で、通常はモジュールの製品名に対応します。

applyToProducts：このフィールドは、このtargetがどの製品（product）に適用されるかを定義します。例えば、entryモジュールのdefault targetをdefault製品に適用することができます。


 二、モジュールレベルの設定の詳細な解析
 1. buildOptionSet 設定buildOptionSetは、HarmonyOS開発で複数のビルドオプションを定義するための集合です。各ビルドオプションには、異なるビルドニーズを満たす特定の名前と設定の詳細があります。
リリースモード設定（releaseビルドに適用）：
{
  "name": "release",
  "debuggable": false,
  "arkOptions": {
    "obfuscation": {
      "ruleOptions": {
        "enable": true,
        "files": [
          "./obfuscation-rules.txt"
        ]
      }
    }
  }
}

debuggable：falseに設定され、このビルドモードのアプリケーションはデバッグ不可能です。

arkOptions：ARK（HarmonyOSアプリケーションランタイム）の設定オプションです。

obfuscation：コードの難読化設定で、アプリケーションのセキュリティを高めます。

enable：コードの難読化を有効にします。

files：難読化ルールファイルのパスを指定します。


デバッグモード設定（debugビルドに適用）：
{
  "name": "debug",
  "debuggable": true,
  "arkOptions": {
    "obfuscation": {
      "ruleOptions": {
        "enable": false
      }
    }
  }
}

debuggable：trueに設定され、デバイス上でアプリケーションをデバッグ可能にします。

arkOptions：デバッグモードでは、通常コードの難読化をオフにし、開発者がコードをより簡単に確認し、デバッグできるようにします。

 2. buildModeBinder 設定buildModeBinderフィールドは、ビルドモード（buildModeName）とビルドオプション（buildOptionName）とターゲット（targetName）の間のマッピング関係を確立します。このように、ビルド時にビルドモードを指定するだけで、システムは自動的に対応するビルドオプションとターゲットを選んでビルドを行います。
デバッグモード：
{
  "buildModeName": "debug",
  "mappings": [
  {
    "targetName": "default", //バインドするtargetを指定する
    "buildOptionName": "debug" //バインドするbuildOptionを指定する
  },
  ]
}
debugモードでは、指定されたターゲット（例えばdefault、tc、pro）はdebugビルドオプションを使用してビルドされます。
リリースモード：
{
  "buildModeName": "release",
  "mappings": [
        {
    "targetName": "default", //バインドするtargetを指定する
    "buildOptionName": "release" //バインドするbuildOptionを指定する
      },
  ]
}
releaseモードでは、指定されたターゲットはreleaseビルドオプションを使用してビルドされます。

 3. targets 設定targetsフィールドは、プロジェクト内のすべてのターゲットを定義します。各ターゲットは、ビルド時にビルドするアプリケーションまたはコンポーネントを指定するためのユニークな名前を持ちます。
HarmonyOS開発実践：柔軟なコンパイルオプションのカスタマイズで効率的なアプリケーションを構築する

一、プロジェクトレベルの設定の解析

1. 製品カテゴリ設定 (`products`)

2. ビルドモード設定 (`buildModeSet`)

3. モジュールとターゲットの設定 (`modules` と `targets`)

二、モジュールレベルの設定の詳細な解析

1. `buildOptionSet` 設定

2. `buildModeBinder` 設定

3. `targets` 設定

Discussion
