Tess's Android Wayland Compositor
Tess's Android Wayland Compositor (github.com)
要約
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)。
アプリにバンドルされているすべてのコンポーネントの個別の帰属表示は、アプリ内の設定 → 情報 → ライセンスの下にあります。