Repolode
harmoninux

harmoninux/HiSH

スマートフォン、タブレット、2in1/PCでAlpineのシェルを使える、完全なarm64 Linux環境を実行するHarmonyOSアプリ。

スター
673
フォーク
51
未解決の Issue
36
最終コミット
9 日前

これは何?

HiSHはHarmonyOSデバイスでLinuxシェルを使えるようにします。arm64 Linuxカーネル一式とAlpine Linuxのルートファイルシステムを同梱し、HarmonyOS向けに構築されたqemuベースの仮想マシンで実行するため、デバイス上で直接ターミナル環境を利用できます。

タブレット、2in1 PC、スマートフォンに対応しています。JITが利用できるデバイスでは高速に動作し、Phone版では代わりにTCIインタープリターを利用できます。ポートフォワーディング対応のネットワーク、共有フォルダー、Tab、Ctrl、Esc、Shift、Fn、矢印キーの画面上のキーを利用できます。Ubuntu 24.04とDebian 12のルートファイルシステムイメージもインポートできます。

MITライセンスで公開されており、DevEco Studioでソースからビルドできます。オプションのqemuライブラリ、カーネル、ルートファイルシステムのビルド手順は、Alpineベースのカスタムrootfsを作成する流れも含め、段階ごとに説明されています。

主な機能

  • 01Alpine Linuxのルートファイルシステムを備えた完全なarm64 Linuxカーネル
  • 02ポートフォワーディング対応のネットワーク
  • 03デバイスとLinux環境間の共有フォルダー
  • 04Tab、Ctrl、Esc、Shift、Fn、矢印キーの仮想キー
  • 05タブレットと2in1デバイスでのJITアクセラレーション
  • 06Ubuntu 24.04およびDebian 12のイメージをインポート

ユースケース

  • HarmonyOSのタブレットやPCでシェルコマンドやLinuxツールを実行する
  • 別のコンピューターを使わずにLinuxの管理を練習する
  • HarmonyOS上の軽量なLinux VM内で、ポートフォワーディングを使うサービスをテストする

クイックスタート

  1. 1

    リポジトリをクローンする

  2. 2

    サブモジュールを初期化する

    git submodule update --init --recursive
  3. 3

    libs.zip、kernel_aarch64、rootfs_aarch64.qcow2 を指定されたパスにダウンロードする

  4. 4

    DevEco Studio でビルドして署名し、デバイスまたはエミュレーターで実行する

使う前に知っておきたいこと

  • AppGallery 版には JIT がないため、実行効率が低くなります。
  • スマートフォン端末は JIT に対応していません。
  • ソースからビルドするには、大容量の libs、kernel、rootfs ファイルを手動でダウンロードする必要があります。
  • リリース版 HAP をインストールするには、自分で署名する必要があります。

トピック

よくある質問

HiSH とは?
スマートフォン、タブレット、2in1/PCでAlpineのシェルを使える、完全なarm64 Linux環境を実行するHarmonyOSアプリ。 HiSHはHarmonyOSデバイスでLinuxシェルを使えるようにします。arm64 Linuxカーネル一式とAlpine Linuxのルートファイルシステムを同梱し、HarmonyOS向けに構築されたqemuベースの仮想マシンで実行するため、デバイス上で直接ターミナル環境を利用できます。
HiSH は無料で使えますか?ライセンスは?
HiSH は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
HiSH は今もメンテナンスされていますか?
活発にメンテナンス中。HiSH の最終コミットは 2026年10月11日 です。
HiSH は何に使えますか?
HarmonyOSのタブレットやPCでシェルコマンドやLinuxツールを実行する 別のコンピューターを使わずにLinuxの管理を練習する HarmonyOS上の軽量なLinux VM内で、ポートフォワーディングを使うサービスをテストする
HiSH のインストール方法は?
リポジトリをクローンする サブモジュールを初期化する: git submodule update --init --recursive libs.zip、kernel_aarch64、rootfs_aarch64.qcow2 を指定されたパスにダウンロードする DevEco Studio でビルドして署名し、デバイスまたはエミュレーターで実行する
HiSH はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/harmoninux/HiSH

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト