HN 日本語サマリー

← 一覧へ戻る
Web開発

Tess's Android Wayland Compositor

Tess's Android Wayland Compositor (github.com)

69 pointsby schmorptron11 コメント

要約

Tess's Android Wayland Compositor (tawc) は、root権限なしでAndroid上でLinuxのCLIおよびグラフィカルプログラムを実行できるプロジェクトです。このシステムは、パフォーマンスの高いPRoot代替であるtawcroot、Waylandコンポジタ、およびUIで構成されており、Linuxディストリビューション(Arch Linux ARMやDebianなど)をAndroidデバイスに展開します。これにより、ネイティブのグラフィックススタックを利用したハードウェアアクセラレーション付きのグラフィカルアプリ実行や、Androidデータとの連携が可能になります。

全文翻訳

Tess's Android Wayland Compositor

TAWCは、root権限なしでAndroid上でLinuxのCLIおよびグラフィカルプログラムを実行できるようにします。グラフィカルアプリは、スマートフォンのネイティブグラフィックススタックによるハードウェアアクセラレーションを利用できます。このプロジェクトは、PRootの高性能な代替であるtawcroot、Waylandコンポジター、およびそれらを統合するUIで構成されています。

特長

  • アプリは、Termuxのウィジェットを組み込んでおり、使い慣れたターミナルUIを提供します(Termuxアプリ自体は不要です)。
  • グラフィカルアプリがインストールされると、TAWCのランチャーメニューから実行できます。
  • Linuxアプリはスマートフォンのホーム画面に追加でき、アプリスイッチャーではAndroidアプリと並んで表示されます。
  • XWaylandが含まれており、ハードウェアアクセラレーション対応のX11サポートのために接続されています。
  • 内蔵のタスクマネージャーで、実行中のLinuxプロセスを表示・終了できます。
  • andoコマンドとストレージバインドにより、必要に応じてLinuxプログラムがAndroidデータとやり取りできます。

高レベル設計

  • Arch Linux ARMやDebianのような標準的なLinuxディストリビューションがダウンロードされ、展開されます。
  • ディストリビューションのネイティブパッケージマネージャーを含むLinuxプログラムは、tawcrootを使用してディストリビューションのrootfsの「内部」で実行されます。
  • tawcrootは、rootレスAndroidの制限を克服するためにchrootやその他のシステムコールをエミュレートします(PRootに似ていますが、単一プロセスを使用するため高速です)。
  • SmithayベースのWaylandコンポジターがAndroidとの統合を提供します(通常のAndroidキーボードからの入力の受け渡しなど)。
  • libhybrisにより、glibc Linuxプログラムが標準のAndroidグラフィックスドライバーをロードできるようになります。
  • アップストリームのlibhybrisは標準のAndroidでは動作しませんが、私たちのフォークは動作します。

制限事項

  • Android自身のメカニズムを超えた、Linuxアプリの真のサンドボックス化はありません。単一プロセス設計のため、tawcrootは脱出される可能性があります。
  • デスクトップGLサポートはありません。電話が提供するグラフィックスAPI(一般的にはGLESとVulkan)のみが利用可能です。
  • (関連)ゲームについては、まだテストまたは最適化されていません。
  • パフォーマンスは他の代替手段より優れていますが、ネイティブではありません。
  • 現時点ではarm64の公式ビルドのみです。x86用にビルドすることも可能ですが、私たちのlibhybrisのトリックはarmに依存しています。
  • Android 10以降が必要です。
  • Android 12以降では、rootfsプロセスが約32を超えると(ファントムプロセスキラー)、プロセスが終了する可能性があります。重い並列ジョブは失敗することがあります。Android 14以降では、開発者向けオプション → "子プロセス制限を無効にする" を有効にしてください。

詳細については、AGENTS.mdを参照してください。

貢献

PRよりもIssueを優先します。バグレポートや機能リクエストは歓迎しますが、特定のタイムラインで対応できる保証はありません。LLMで書かれたコンテンツを含むIssueの場合は、それを明確にマークしてください(理想的にはどのLLMが書いたかを示す)。常に人間が書いた説明を含めてください。アプリのバージョン、電話、Androidバージョン、ディストリビューション(関連する場合)を含めてください。

要するに、良い例:

Issueタイトル: プログラム foo がクラッシュする

Pixel 10 で stock Android 17 を実行しており、TAWC v1 を使用しています。

pacman で foo v1.2 をインストールしましたが、起動時にクラッシュします。この問題について fable に尋ねたところ、次のように言われました。

[CLAUDESLOP]

悪い例:

PRタイトル: [CLAUDESLOP]

[CLAUDESLOP]

コード:

UNEXPLAINED CLAUDESLOP

ライセンス

deps/ 以外のすべてのコードはMITライセンスです(LICENSE.MIT)。バンドルされている依存関係(termux-shared の extra-keys ウィジェット)には一部GPLv3のコードが含まれているため、プロジェクト全体としてはGPLv3ライセンスです(LICENSE)。

アプリにバンドルされているすべてのコンポーネントの個別の帰属表示は、アプリ内の設定 → 情報 → ライセンスの下にあります。