準備作業

以下のインストール方法から一つを選択してください：

maa-cli を使用する

maa-cli は Rust で書かれたシンプルな MAA コマンドラインツールです。関連するインストールと使用方法については、CLI 使用ガイド をご覧ください。

Wine を使用する

MAA WPF GUI は現在 Wine を通じて実行できます。MAAは.NETランタイムを内蔵しています（自己完結型デプロイ）。

インストール手順

1. Visual C++ Redistributable をインストールする

   Visual C++ 再頒布可能パッケージ をダウンロードしてインストールします：

   wine vc_redist.x64.exe

   ヒント

   DependencySetup_依赖库安装.bat は winget に依存しているため、Wine では通常正常に動作しません。そのため、ランタイムライブラリは手動でインストールする必要があります。

2. MAA をダウンロード

   Windows 版 MAA をダウンロードし、解凍した後、wine MAA.exe を実行します。

注意

接続設定で ADB パスを Windows 版 adb.exe に設定する必要があります。

ADB 経由で USB デバイスに接続する必要がある場合は、まず Wine の外で adb start-server を実行し、Wine を通じてネイティブ ADB サーバーに接続してください。

Linux ネイティブ MaaCore の使用（実験的機能）

MAA Wine Bridge のソースコードをダウンロードしてビルドし、生成された MaaCore.dll（ELF ファイル）で Windows 版を置き換え、Linux ネイティブ動的ライブラリ（libMaaCore.so および依存関係）を同じディレクトリに配置します。

この状態で Wine を通じて MAA.exe を実行すると、Linux ネイティブ動的ライブラリが読み込まれます。

注意

Linux ネイティブ MaaCore を使用する場合は、接続設定で ADB パスを Linux ネイティブ ADB に設定する必要があります。

Linux デスクトップ統合（実験的機能）

デスクトップ統合は、ネイティブデスクトップ通知サポートと fontconfig フォント設定を WPF にマッピングする機能を提供します。

MAA Wine Bridge で生成された MaaDesktopIntegration.so を MAA.exe と同じディレクトリに配置すると有効になります。

既知の問題

• Wine DirectWrite は強制的にヒンティングを有効にし、DPI を FreeType に渡さないため、フォント表示が良くありません。
• ネイティブデスクトップ通知を使用しない場合、通知がポップアップするとシステム全体のマウスフォーカスを奪うため、他のウィンドウを操作できなくなります。winecfg で仮想デスクトップモードを有効にするか、デスクトップ通知を無効にすることで緩和できます。
• Wine-staging ユーザーは、MAA が Wine 環境を正しく検出できるように、winecfg の Wine バージョンを隠す オプションを無効にする必要があります。
• Wine の Light テーマは WPF で一部のテキストカラーに異常を引き起こすため、winecfg でテーマなし（Windows クラシックテーマ）に切り替えることをお勧めします。
• Wine は古い XEmbed トレイアイコンを使用しており、GNOME では正常に動作しない可能性があります。
• Linux ネイティブ MaaCore を使用している場合、自動更新はサポートされていません（更新プログラム：Windows 版をダウンロードすべきでしょうか）

Python を使用する

1. MAA 動的ライブラリのインストール

   以下のいずれかの方法を選択してください：

   • MAA 公式サイト からビルド済みの Linux 動的ライブラリ圧縮ファイルをダウンロードし、展開後に Python/sample.py ファイルを編集します
   • AUR：maa-assistant-arknights、インストール後の ｢Alternative usage｣ の指示に従ってファイルを編集します
   • Nixpkgs: maa-assistant-arknights

   ヒント

   事前ビルドされた動的ライブラリは MaaLinuxToolchain ツールチェーンを使用してクロスコンパイルされており、glibc 2.31 (Ubuntu 20.04) のみに依存します。ABI の非互換性問題（glibc 以外のディストリビューションなど）が発生した場合は、コンテナで実行するか、Linux コンパイル チュートリアル を参照して再コンパイルしてください。

2. ADB 構成

   1. 上の手順で開いた sample.py の中で、if asst.connect("adb.exe", "127.0.0.1:5555"): の行を見つけます。

   2. adb ツール呼び出し

      • エミュレータが Android Studio に avd を使用している場合は、 adb が付属します。 adb.exe の欄に直接 adb パスを記入することができ、一般的には $HOME/Android/Sdk/platform-tools/ で見つけることができます。例：

      if asst.connect("/home/foo/Android/Sdk/platform-tools/adb", "エミュレータの adb アドレス"):

      • 他のエミュレータを使用する場合は、最初に adb をダウンロードして： $ sudo apt install adb 次に、パスを入力するか、 PATH 環境変数を使用して adb を直接入力します

   3. エミュレータの adb パス取得

      • adb ツールを直接使用できます： $ adbパス devices ，例：

      $ /home/foo/Android/Sdk/platform-tools/adb devices
      List of devices attached
      emulator-5554 device

      • 返された emulator-5554 がエミュレータの adb アドレスです。127.0.0.1:5555 をこれで上書きします。例：

      if asst.connect("/home/foo/Android/Sdk/platform-tools/adb", "emulator-5554"):

   4. ここでテストを実行できます：$ python3 sample.py。 ｢连接成功｣（接続成功）と返されれば基本的に準備完了です。

3. タスク構成

   インテグレーション - タスク タイプ一覧 を参照し、必要に応じて sample.py の asst.append_task(…) 関数の呼び出しを変更します。

エミュレータのサポート

AVD

必須構成： 16:9 の画面解像度で、解像度は 720p より大きい必要がある

推奨構成： x86_64 のフレームワーク (R - 30 - x86_64 - Android 11.0) と MAA のLinux x64 ダイナミック ライブラリ

スクリーンショット強化モードの追加サポートもあります。

• Android 10 以降、SELinux が Enforcing モードの場合、Minitouch は使用できません、別のタッチモードに切り替えてください。または SELinux を 一時的に Permissive モードに切り替え。

Genymotion

高バージョンの Android は x86_64 フレームワークを搭載しており、軽量ですがアークナイツを実行するとフラッシュバックしやすい

厳格なテストは行われておらず、 adb 機能とパス取得に問題はありません

コンテナー化された Android のサポート

ヒント

以下のソリューションには通常、カーネルモジュールに関する特定の要件がありますので、特定のスキームとディストリビューションに従って適切なカーネルモジュールをインストールしてください

Waydroid

インストール後に解像度（または 720P より大きく 16:9 の解像度）をリセットしてから、再起動する必要があります：

waydroid prop set persist.waydroid.width 1280
waydroid prop set persist.waydroid.height 720

adb の IP アドレスを設定する： 設定 - バージョン情報 - IPアドレス を開き、最初の IP を記録するし、sample.py の adb IP に ${記録したIP}:5555 を入力する。

アークナイツは ARM アーキテクチャのみサポートしています。x64 アーキテクチャ上では libhoudini や libndk の arm64 変換レイヤーをインストールする必要があります。waydroid_script や Waydroid Helper を参照してください。

Waydroid には Minitouch に必要な /dev/input/eventN がないため、Minitouch は利用できません。他のタッチモードに切り替えてください。

redroid

Android 11 バージョンのイメージは正常に動作し、5555 adb ポートを公開する必要があります。

このページを編集