導入：なぜOpenHarmony PCにコマンドラインが必要なのか？

開発者の世界では、グラフィカルユーザーインターフェース（GUI）が製品の下限を決め、コマンドラインインターフェース（CLI）が生産性の上限を決定します。「生産性ツール」としての位置づけを目指すOpenHarmony PCにおいて、開発者が慣れ親しんだ端末体験が提供できない場合—`git`でのコード管理、`vim`での設定ファイル編集、`openssl`での証明書生成ができない場合—、それは常に核心的な開発者層に届かないでしょう。

現在、OpenHarmony PCはエコシステム構築の重要な段階にあります。Linuxコミュニティが数十年にわたって築き上げた数十億規模のオープンソースツールライブラリに対し、我々は一つ一つソースコードを手動で修正して適応すべきでしょうか？それとも、より効率的な「一括移植」ソリューションを見つけるべきでしょうか？

答えは**OpenHarmonyPCDeveloper/build**プロジェクトにあります。これは標準化された「移植工場」であり、スクリプト体系を通じてLinuxからOpenHarmonyへの道を切り開き、適応作業をブロック組み立てのように簡単にするものです。

核心解説：「移植工場」の動作原理

このプロジェクトの核心的な価値を理解するため、そのワークフローを見てみましょう。簡単に言えば、それは「仲介者」の役割を担っています：左手の`dependency.json`でオープンソースプロジェクトのソースコードを取得し、右手の`build.sh`でOpenHarmonyのコンパイル環境を注入し、最終的に標準的なHNP（Harmony Native Package）ソフトウェアパッケージを生成します。

1. 環境注入：巧みな技術融合

Linuxソフトウェアを移植する際の最大の課題は「環境適合の問題」—通常はコンパイラツールチェーン（Toolchain）とシステムライブラリ（Sysroot）の不一致です。

`build.sh`では、環境変数の巧みな設定を通じて、完璧な「技術融合」を実現しています。以下はその核心コードです：

# build.sh 核心部分

# 1. 対象プラットフォームの指定：aarch64-linux-ohos
export TARGET_PLATFORM=aarch64-linux-ohos

# 2. コンパイラの置き換え：標準コンパイラをOpenHarmony SDK向けに設定
export CC=${COMPILER_TOOLCHAIN}clang
export CXX=${COMPILER_TOOLCHAIN}clang++

# 3. システムルートの注入：OpenHarmonyのシステムルートディレクトリを指定
# これにより、コンパイル時にリンクされるのはホストシステムのライブラリではなく、
# 鴻蒙のlibcであることが保証されます
export CFLAGS="-fPIC -D__MUSL__=1 -D__OHOS__ ... --sysroot=${SYSROOT}"
export LDFLAGS="${LDFLAGS} -fuse-ld=${LD} --target=${TARGET_PLATFORM} --sysroot=${SYSROOT}"

これら数行の設定により、本来Linux向けに書かれた`Makefile`や`CMakeLists.txt`が`$CC`を呼び出す際、実際にはOpenHarmonyのクロスコンパイラを呼び出すことになります。これは、標準的なビルドプロトコルに従っているほとんどのオープンソースソフトウェアが、C/C++ソースコードを一行も修正することなく、OpenHarmony PCで実行可能なバイナリをコンパイルできることを意味します。

2. 依存関係管理：自動化されたスケジューリングシステム

現代のソフトウェアは孤立した存在ではなく、例えば`git`は`openssl`と`zlib`に依存します。このような複雑な依存関係を解決するため、プロジェクトは`dependency.json`と`build_dependency.py`を導入しました。

`dependency.json`は「名簿」のようなもので、適応済みのすべてのソフトウェアのリポジトリアドレスと特定のブランチを記録します：

{
  "dependency": [
    {
      "name": "openssl",
      "branch": "openssl-3.6_ohos",
      "url": "git@gitcode.com:OpenHarmonyPCDeveloper/openssl.git"
    },
    {
      "name": "zlib",
      "branch": "v1.3.1_ohos",
      "url": "git@gitcode.com:OpenHarmonyPCDeveloper/zlib.git"
    }
  ]
}

`build_dependency.py`はスケジューラーとして機能し、このファイルを解析してコードを自動的に取得し、順番にそれぞれのビルドスクリプトをトリガーします。これにより、LLVMやNode.jsのような複雑なツールチェーンのビルドが可能になります。

実践演習：`tree`コマンドの移植例

理論だけでなく、実際の例を見てみましょう。ここでは、古典的なディレクトリツールビューアーである`tree`をOpenHarmony PCに移植するプロセスを説明します。

ステップ1：スカフォールドの取得

まず、ビルドスカフォールドをローカルにクローンします：

git clone git@gitcode.com:OpenHarmonyPCDeveloper/build.git
cd build

ステップ2：ソースコードの適応（魔法の瞬間）

`tree`のソースコードディレクトリに、2つの重要なファイルを追加する必要があります：`build_ohos.sh`と`hnp.json`です。

1. `build_ohos.sh`の追加

これは適応作業の核心です。ビルドシステムがこの特定のプロジェクトをどのようにコンパイルするかを伝えます。`tree`のような単純なプロジェクトでは、スクリプトは非常に直感的です：

# build_ohos.sh

# インストールパスの定義、HNP仕様に準拠
export TREE_INSTALL_HNP_PATH=${HNP_PUBLIC_PATH}/tree.org/tree_2.2.1

# 古いビルド成果物のクリーンアップ
make clean

# コンパイル：PREFIX変数を渡し、上層のbuild.shで注入された
# クロスコンパイル環境を利用
make VERBOSE=1 prefix=${TREE_INSTALL_HNP_PATH}

# インストール：成果物を指定ディレクトリにインストール
make install prefix=${TREE_INSTALL_HNP_PATH}

# パッケージング：hnpツールでパッケージ化
cp hnp.json ${TREE_INSTALL_HNP_PATH}/
pushd ${TREE_INSTALL_HNP_PATH}/../
${HNP_TOOL} pack -i ${TREE_INSTALL_HNP_PATH} -o ${ARCHIVE_PATH}/
# バックアップとして従来のtar.gzパッケージも作成
tar -zvcf ${ARCHIVE_PATH}/ohos_tree_2.2.1.tar.gz tree_2.2.1/
popd

2. `hnp.json`の追加

これはソフトウェアパッケージの「身分証明書」であり、パッケージマネージャーが識別するために使用されます：

{
  "type": "hnp-config",
  "name": "tree",
  "version": "2.2.1",
  "install": {}
}

ステップ3：ワンクリックビルド

`build`ディレクトリに戻り、ビルドコマンドを実行します（SDKが既に設定されていると仮定）：

./build.sh --sdk /path/to/your/ohos-sdk/linux

しばらくすると、`output`ディレクトリに`ohos_tree_2.2.1.tar.gz`が表示されます。このパッケージをOpenHarmony PCにプッシュして解凍すれば、端末で慣れ親しんだ`tree`コマンドを叩けるようになります！

高度化：エコシステム構築のビジョン

現在の`dependency.json`には`openssl`、`libxml2`、`busybox`、`libuv`などの基本ライブラリがリストされていますが、これだけでは不十分です。

OpenHarmony PCのコマンドラインエコシステムの構築は、一人の戦いではなく、オープンソースコミュニティのリレーレースです。

• C/C++に精通しているなら、`ffmpeg`や`nginx`の移植に挑戦してみてください。
• スクリプトのエキスパートなら、`build.sh`の汎用性を向上させることに貢献できます。
• 普通の開発者であっても、Issueを一つ提出するだけでもエコシステムへの貢献になります。

プロジェクトアドレス：https://gitcode.com/OpenHarmonyPCDeveloper/build

一緒に、Linuxの数億規模のエコシステムをOpenHarmonyに「移動」させ、OpenHarmony PCのための豊かな開発者楽園を作り上げましょう。