mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-15 17:30:27 +08:00
build: 改为 SelfContained 发布模式 (#16019)
<img width="3190" height="208" alt="07832262dcc66157005c08cc95a03fd1" src="https://github.com/user-attachments/assets/84630506-c595-4999-ac7b-9c79f200bb16" /> <img width="1753" height="91" alt="b8ee23114f21ed1047697a77e713f1e5" src="https://github.com/user-attachments/assets/6d781864-9c65-4774-85c7-8c22a1210285" /> 完整包体积 +67 M 更新包第一次也会大差不多这么多，后面因为增量的原因不会影响 ## Summary by Sourcery 记录迁移到自包含（self-contained）的 .NET 部署方式，并相应更新运行时和操作系统支持要求。 新功能： - 通过自包含部署，将 .NET 运行时打包进 Windows GUI 构建中，从而不再需要单独安装 .NET。 增强改进： - 在所有支持的语言中明确说明：安装时仅需要 Visual C++ 运行时，因为 .NET 现在已随程序一同提供。 - 更新 Linux/Wine 使用文档，以反映 Windows 构建已包含 .NET 运行时这一事实。 - 重新措辞操作系统支持说明，解释由于运行时和系统组件依赖，MAA 需要 Windows 10 或更高版本。 构建： - 调整 WPF GUI 项目和依赖设置脚本以使用自包含发布模式，并停止安装外部的 .NET Desktop Runtime。 文档： - 更新所有语言的常见问题（FAQ）、安装说明和新手指南，使其与新的自包含部署方式和运行时要求保持一致。 <details> <summary>Original summary in English</summary> ## Summary by Sourcery Document the switch to self-contained .NET deployment and update runtime and OS support requirements accordingly. New Features: - Bundle the .NET runtime into the Windows GUI build via self-contained deployment to remove the need for a separate .NET installation. Enhancements: - Clarify across all supported languages that only the Visual C++ runtime is required at install time, as .NET is now included. - Update Linux/Wine usage docs to reflect that the Windows build already contains the .NET runtime. - Reword OS support notes to explain that MAA requires Windows 10 or later due to its runtime and system component dependencies. Build: - Adjust the WPF GUI project and dependency setup script to use self-contained publish mode and stop installing the external .NET Desktop Runtime. Documentation: - Refresh FAQ, installation, and newbie guides in all languages to match the new self-contained deployment and runtime requirements. </details>
This commit is contained in:
uye
@@ -15,11 +15,21 @@ Choose one of the following installation methods:
|
||||
|
||||
### Using Wine
|
||||
|
||||
The MAA WPF GUI can currently be run through Wine.
|
||||
The MAA WPF GUI can currently be run through Wine. MAA now uses self-contained deployment with the .NET runtime included.
|
||||
|
||||
#### Installation Steps
|
||||
|
||||
1. Go to the [.NET download page](https://dotnet.microsoft.com/en-us/download/dotnet/10.0) and download/install the Windows version of .NET **Desktop** Runtime.
|
||||
1. Install Visual C++ Redistributable:
|
||||
|
||||
Download and install [Visual C++ Redistributable](https://aka.ms/vc14/vc_redist.x64.exe):
|
||||
|
||||
```shell
|
||||
wine vc_redist.x64.exe
|
||||
```
|
||||
|
||||
::: tip
|
||||
`DependencySetup_依赖库安装.bat` relies on winget and Windows privilege escalation, which typically doesn't work properly in Wine, so manual installation of runtime libraries is required.
|
||||
:::
|
||||
|
||||
2. Download the Windows version of MAA, extract it, and run `wine MAA.exe`.
|
||||
|
||||
|
||||
@@ -12,16 +12,17 @@ If this is your first time using MAA, please read [Getting Started](./newbie.md)
|
||||
If MAA fails to run after an update, or if you've arrived here from MAA's error window, it's most likely due to outdated runtime libraries.
|
||||
The most common issue is related to runtime libraries, and many people keep asking about it without reading the documentation, so we changed the pinned message to this. It's frustrating.
|
||||
|
||||
MAA now uses self-contained deployment with the .NET runtime included, but still requires Visual C++ runtime libraries.
|
||||
|
||||
Please run `DependencySetup_依赖库安装.bat` in the MAA directory, or execute the following command in terminal:
|
||||
|
||||
```sh
|
||||
winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements && winget install "Microsoft.DotNet.DesktopRuntime.10" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
|
||||
winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
|
||||
```
|
||||
|
||||
Or manually download and install these <u>**two**</u> runtime libraries to solve the problem:
|
||||
Or manually download and install this runtime library to solve the problem:
|
||||
|
||||
- [Visual C++ Redistributable](https://aka.ms/vc14/vc_redist.x64.exe)
|
||||
- [.NET Desktop Runtime 10](https://aka.ms/dotnet/10.0/windowsdesktop-runtime-win-x64.exe)
|
||||
|
||||
:::
|
||||
|
||||
@@ -51,7 +52,7 @@ For Windows N/KN (European/Korean versions), you also need to install the [Media
|
||||
|
||||
#### Windows 7/8/8.1
|
||||
|
||||
.NET 10 doesn't support Windows 7/8/8.1 systems<sup>[source](https://github.com/dotnet/core/issues/7556)</sup>, so MAA no longer supports them either.
|
||||
Due to runtime libraries and system components requiring Windows 10 or above, MAA no longer supports Windows 7/8/8.1 systems.
|
||||
|
||||
## Connection errors
|
||||
|
||||
|
||||
@@ -25,7 +25,7 @@ Quick start guide!
|
||||
|
||||
4. Install runtime libraries
|
||||
|
||||
MAA requires VCRedist x64 and .NET 10. Please run `DependencySetup_依赖库安装.bat` in the MAA directory to install them.
|
||||
MAA now includes the .NET runtime (self-contained deployment), but still requires VCRedist x64. Please run `DependencySetup_依赖库安装.bat` in the MAA directory to install it.
|
||||
|
||||
For more information, please refer to the pinned section in [FAQ](./faq.md).
|
||||
|
||||
|
||||
@@ -7,20 +7,79 @@ icon: teenyicons:linux-alt-solid
|
||||
|
||||
## 準備作業
|
||||
|
||||
### 1. MAA をインストールする
|
||||
以下のインストール方法から一つを選択してください：
|
||||
|
||||
1. Linux ダイナミック ライブラリを [MAA ウェブサイト](https://maa.plus/) からダウンロードし、解凍します
|
||||
### maa-cli を使用する
|
||||
|
||||
2. `./MAA-v{バージョン}-linux-{アアーキテクチャ}/Python/` ディレクトリに移動します、 `sample.py` ファイルを開け
|
||||
[maa-cli](https://github.com/MaaAssistantArknights/maa-cli) は Rust で書かれたシンプルな MAA コマンドラインツールです。関連するインストールと使用方法については、[CLI 使用ガイド](../cli/) をご覧ください。
|
||||
|
||||
::: tip
|
||||
プリコンパイル済みバージョンには、比較的新しいLinuxディストリビューション(Ubuntu 22.04)でコンパイルされた動的ライブラリが含まれており、システムに古いバージョンのlibstdc++がある場合、ABIの非互換性に遭遇する可能性があります
|
||||
[Linuxコンパイル・チュートリアル](../../develop/linux-tutorial.md) を参照して再コンパイルまたはコンテナを使用して実行できます
|
||||
### Wine を使用する
|
||||
|
||||
MAA WPF GUI は現在 Wine を通じて実行できます。MAAは.NETランタイムを内蔵しています（自己完結型デプロイ）。
|
||||
|
||||
#### インストール手順
|
||||
|
||||
1. Visual C++ Redistributable をインストールする：
|
||||
|
||||
[Visual C++ 再頒布可能パッケージ](https://aka.ms/vc14/vc_redist.x64.exe) をダウンロードしてインストールします：
|
||||
|
||||
```shell
|
||||
wine vc_redist.x64.exe
|
||||
```
|
||||
|
||||
::: tip
|
||||
`DependencySetup_依赖库安装.bat` は winget と Windows の権限昇格機構に依存しているため、Wine では通常正常に動作しません。そのため、ランタイムライブラリは手動でインストールする必要があります。
|
||||
:::
|
||||
|
||||
2. Windows 版 MAA をダウンロードし、解凍した後、`wine MAA.exe` を実行します。
|
||||
|
||||
::: info 注意
|
||||
接続設定で ADB パスを [Windows 版 `adb.exe`](https://dl.google.com/android/repository/platform-tools-latest-windows.zip) に設定する必要があります。
|
||||
|
||||
ADB 経由で USB デバイスに接続する必要がある場合は、まず Wine の外で `adb start-server` を実行し、Wine を通じてネイティブ ADB サーバーに接続してください。
|
||||
:::
|
||||
|
||||
- Arch Linuxシリーズのリリース版は、aur パッケージ [maa-assistant-arknights](https://aur.archlinux.org/packages/maa-assistant-arknights)を選択する使用し、インストール後のプロンプトに従ってファイルを編集することができる
|
||||
#### Linux ネイティブ MaaCore の使用（実験的機能）
|
||||
|
||||
### 2. `adb` 構成
|
||||
[MAA Wine Bridge](https://github.com/MaaAssistantArknights/MaaAssistantArknights/tree/dev/src/MaaWineBridge) のソースコードをダウンロードしてビルドし、生成された `MaaCore.dll`（ELF ファイル）で Windows 版を置き換え、Linux ネイティブ動的ライブラリ（`libMaaCore.so` および依存関係）を同じディレクトリに配置します。
|
||||
|
||||
この状態で Wine を通じて `MAA.exe` を実行すると、Linux ネイティブ動的ライブラリが読み込まれます。
|
||||
|
||||
::: info 注意
|
||||
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 を使用する
|
||||
|
||||
#### MAA 動的ライブラリのインストール
|
||||
|
||||
1. Linux ダイナミック ライブラリを [MAA ウェブサイト](https://maa.plus/) からダウンロードし、解凍します、または以下のソフトウェアリポジトリからインストールします：
|
||||
- AUR：[maa-assistant-arknights](https://aur.archlinux.org/packages/maa-assistant-arknights)、インストール後のプロンプトに従ってファイルを編集します
|
||||
- Nixpkgs: [maa-assistant-arknights](https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/by-name/ma/maa-assistant-arknights/package.nix)
|
||||
|
||||
2. `./MAA-v{バージョン}-linux-{アアーキテクチャ}/Python/` ディレクトリに移動し、`sample.py` ファイルを開きます
|
||||
|
||||
::: tip
|
||||
プリコンパイル済みバージョンには、比較的新しいLinuxディストリビューション(Ubuntu 22.04)でコンパイルされた動的ライブラリが含まれており、システムに古いバージョンのlibstdc++がある場合、ABIの非互換性に遭遇する可能性があります。
|
||||
[Linuxコンパイル・チュートリアル](../../develop/linux-tutorial.md) を参照して再コンパイルまたはコンテナを使用して実行できます。
|
||||
:::
|
||||
|
||||
#### ADB 構成
|
||||
|
||||
1. [`if asst.connect('adb.exe', '127.0.0.1:5554'):`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L48) セクションを見つける
|
||||
|
||||
@@ -50,9 +109,9 @@ icon: teenyicons:linux-alt-solid
|
||||
|
||||
4. この時点で、 `$ python3 sample.py` をテストでき、 `接続成功` が返されれば、基本的に成功です
|
||||
|
||||
### 3. タスク構成
|
||||
#### タスク構成
|
||||
|
||||
カストムタスク： 必要に応じて [統合ドキュメント](../../protocol/integration.md) を参照し、 `sample.py` の [`# タスクとパラメーターについては 統合ドキュメント`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L54) 欄を変更する
|
||||
カスタムタスク：必要に応じて [統合ドキュメント](../../protocol/integration.md) を参照し、`sample.py` の [`# タスクとパラメーターについては docs/integration.md 参照`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L54) 欄を変更します
|
||||
|
||||
## エミュレータのサポート
|
||||
|
||||
|
||||
@@ -12,16 +12,17 @@ icon: ph:question-fill
|
||||
MAAがアップデート後に動作しなくなった場合、またはエラーメッセージウィンドウを経由してここにたどり着いた場合、それは大体ランタイムが更新されていないことが原因です。
|
||||
最も多い問題はランタイム関連であり、それにもかかわらず多くの人がドキュメントを読まずに質問するため、トップメッセージをこれに変更しました。とてもイライラします。
|
||||
|
||||
MAAは.NETランタイムを内蔵しています（自己完結型デプロイ）が、Visual C++ランタイムが必要です。
|
||||
|
||||
MAAディレクトリ内の `DependencySetup_依赖库安装.bat` を実行するか、以下のコマンドを端末で実行するか、
|
||||
|
||||
```sh
|
||||
winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements && winget install "Microsoft.DotNet.DesktopRuntime.10" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
|
||||
winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
|
||||
```
|
||||
|
||||
以下の<u>**2つ**</u>のランタイムライブラリを手動でダウンロードしてインストールして問題を解決してください。
|
||||
以下のランタイムライブラリを手動でダウンロードしてインストールして問題を解決してください。
|
||||
|
||||
- [Visual C++ 再頒布可能パッケージ](https://aka.ms/vc14/vc_redist.x64.exe)
|
||||
- [.NET デスクトップランタイム 10](https://aka.ms/dotnet/10.0/windowsdesktop-runtime-win-x64.exe)
|
||||
|
||||
:::
|
||||
|
||||
@@ -51,7 +52,7 @@ Windows N/KN（ヨーロッパ/韓国）の場合、[メディア機能パック
|
||||
|
||||
#### Windows 7 / 8 / 8.1 関連
|
||||
|
||||
.NET 10 は Windows 7 / 8 / 8.1 システムをサポートしていないため<sup>[ソース](https://github.com/dotnet/core/issues/7556)</sup>、MAA も同様にサポートしていません。
|
||||
MAA が依存するランタイムライブラリとシステムコンポーネントは Windows 10 以上が必要なため、MAA は Windows 7 / 8 / 8.1 システムをサポートしていません。
|
||||
|
||||
#### 公式統合パック（確信）
|
||||
|
||||
|
||||
@@ -23,7 +23,7 @@ icon: ri:guide-fill
|
||||
|
||||
4. ランタイムライブラリをインストールする
|
||||
|
||||
MAAはVCRedist x64と.NET 10が必要です。MAAディレクトリ内の `DependencySetup_依赖库安装.bat` を実行してインストールしてください。
|
||||
MAAは.NETランタイムを内蔵しています（自己完結型デプロイ）が、VCRedist x64が必要です。MAAディレクトリ内の `DependencySetup_依赖库安装.bat` を実行してインストールしてください。
|
||||
|
||||
5. エミュレータのサポートを確認
|
||||
|
||||
|
||||
@@ -15,11 +15,21 @@ icon: teenyicons:linux-alt-solid
|
||||
|
||||
### Wine 사용
|
||||
|
||||
MAA WPF GUI는 현재 Wine을 통해 실행할 수 있습니다.
|
||||
MAA WPF GUI는 현재 Wine을 통해 실행할 수 있습니다. MAA는 .NET 런타임을 내장하고 있습니다(자체 포함 배포).
|
||||
|
||||
#### 설치 단계
|
||||
|
||||
1. [.NET 릴리스 페이지](https://dotnet.microsoft.com/en-us/download/dotnet/10.0)에서 Windows용 .NET **데스크톱** 런타임을 다운로드하고 설치합니다.
|
||||
1. Visual C++ Redistributable 설치:
|
||||
|
||||
[Visual C++ 재배포 가능 패키지](https://aka.ms/vc14/vc_redist.x64.exe)를 다운로드하고 설치합니다:
|
||||
|
||||
```shell
|
||||
wine vc_redist.x64.exe
|
||||
```
|
||||
|
||||
::: tip
|
||||
`DependencySetup_依赖库安装.bat`는 winget 및 Windows 권한 상승 메커니즘에 의존하므로 Wine에서 정상적으로 작동하지 않습니다. 따라서 런타임 라이브러리를 수동으로 설치해야 합니다.
|
||||
:::
|
||||
|
||||
2. Windows용 MAA를 다운로드하고 압축을 푼 후 `wine MAA.exe`를 실행합니다.
|
||||
|
||||
|
||||
@@ -12,16 +12,17 @@ MAA를 처음 사용하는 경우 [초보자 가이드](./newbie.md)를 읽어
|
||||
MAA가 업데이트 후 실행되지 않거나 MAA의 오류 창을 통해 여기에 도달했다면, 이는 대부분 실행 라이브러리가 업데이트되지 않은 문제 때문입니다.
|
||||
가장 자주 발생하는 문제는 실행 라이브러리 문제이며, 많은 사람들이 문서를 읽지 않고 질문만 하기 때문에 공지 내용을 이걸로 교체했습니다.
|
||||
|
||||
MAA는 .NET 런타임을 내장하고 있습니다(자체 포함 배포). 하지만 Visual C++ 런타임이 필요합니다.
|
||||
|
||||
MAA 디렉토리에서 `DependencySetup_依赖库安装.bat`를 실행하거나, 터미널에서 아래 명령을 실행하거나,
|
||||
|
||||
```sh
|
||||
winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements && winget install "Microsoft.DotNet.DesktopRuntime.10" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
|
||||
winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
|
||||
```
|
||||
|
||||
아래<u>**두 개**</u>의 실행 라이브러리를 수동으로 다운로드하여 설치하여 문제를 해결하세요.
|
||||
아래 실행 라이브러리를 수동으로 다운로드하여 설치하여 문제를 해결하세요.
|
||||
|
||||
- [Visual C++ 재배포 가능 패키지](https://aka.ms/vc14/vc_redist.x64.exe)
|
||||
- [.NET 데스크톱 런타임 10](https://aka.ms/dotnet/10.0/windowsdesktop-runtime-win-x64.exe)
|
||||
|
||||
:::
|
||||
|
||||
@@ -51,7 +52,7 @@ Windows 8/8.1/10/11 N/KN(유럽/한국) 버전을 사용하는 경우, [미디
|
||||
|
||||
#### Windows 7 / 8 / 8.1 관련
|
||||
|
||||
.NET 10은 Windows 7 / 8 / 8.1 시스템을 지원하지 않으므로<sup>[출처](https://github.com/dotnet/core/issues/7556)</sup>, MAA도 더 이상 지원하지 않습니다.
|
||||
MAA가 의존하는 런타임 라이브러리와 시스템 구성 요소가 Windows 10 이상을 필요로 하기 때문에, MAA는 Windows 7 / 8 / 8.1 시스템을 더 이상 지원하지 않습니다.
|
||||
|
||||
## 연결 오류
|
||||
|
||||
|
||||
@@ -27,7 +27,7 @@ icon: ri:guide-fill
|
||||
|
||||
4. 런타임 설치
|
||||
|
||||
MAA는 VCRedist x64 및 .NET 10이 필요합니다. MAA 디렉토리의 `DependencySetup_依赖库安装.bat`를 실행하여 설치하세요.
|
||||
MAA는 .NET 런타임을 내장하고 있습니다(자체 포함 배포). 하지만 VCRedist x64가 필요합니다. MAA 디렉토리의 `DependencySetup_依赖库安装.bat`를 실행하여 설치하세요.
|
||||
|
||||
자세한 정보는 [FAQ](./faq.md#런타임-문제)를 참조하세요.
|
||||
|
||||
|
||||
@@ -15,11 +15,21 @@ icon: teenyicons:linux-alt-solid
|
||||
|
||||
### 使用 Wine
|
||||
|
||||
MAA WPF GUI 当前可以通过 Wine 运行。
|
||||
MAA WPF GUI 当前可以通过 Wine 运行。MAA 已采用自包含部署方式，内置了 .NET 运行时。
|
||||
|
||||
#### 安装步骤
|
||||
|
||||
1. 前往 [.NET 发布页](https://dotnet.microsoft.com/en-us/download/dotnet/10.0)下载并安装 Windows 版 .NET **桌面**运行时。
|
||||
1. 安装 Visual C++ Redistributable：
|
||||
|
||||
下载并安装 [Visual C++ 可再发行程序包](https://aka.ms/vc14/vc_redist.x64.exe)：
|
||||
|
||||
```shell
|
||||
wine vc_redist.x64.exe
|
||||
```
|
||||
|
||||
::: tip
|
||||
`DependencySetup_依赖库安装.bat` 基于 winget 和 Windows 提权机制，通常无法在 Wine 中正常工作，因此需要手动安装运行库。
|
||||
:::
|
||||
|
||||
2. 下载 Windows 版 MAA，解压后运行 `wine MAA.exe`。
|
||||
|
||||
|
||||
@@ -12,16 +12,17 @@ icon: ph:question-fill
|
||||
若 MAA 在某次更新后无法运行，或者单纯是从 MAA 的报错窗口来到这的，那八成是由于运行库未更新导致的问题。
|
||||
出现次数最多的问题都是运行库问题，而总是有人看不到文档到处问，所以我们把置顶换成了这个。很气。
|
||||
|
||||
MAA 已采用自包含部署方式，内置了 .NET 运行时，但仍需要 Visual C++ 运行库。
|
||||
|
||||
请运行 MAA 目录下的 `DependencySetup_依赖库安装.bat`，或在终端中运行以下命令，
|
||||
|
||||
```sh
|
||||
winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements && winget install "Microsoft.DotNet.DesktopRuntime.10" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
|
||||
winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
|
||||
```
|
||||
|
||||
或手动下载并安装以下<u>**两个**</u>运行库来解决问题。
|
||||
或手动下载并安装以下运行库来解决问题。
|
||||
|
||||
- [Visual C++ 可再发行程序包](https://aka.ms/vc14/vc_redist.x64.exe)
|
||||
- [.NET 桌面运行时 10](https://aka.ms/dotnet/10.0/windowsdesktop-runtime-win-x64.exe)
|
||||
|
||||
:::
|
||||
|
||||
@@ -51,7 +52,7 @@ winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /nore
|
||||
|
||||
#### Windows 7 / 8 / 8.1
|
||||
|
||||
.NET 10 不支持 Windows 7 / 8 / 8.1 系统<sup>[源](https://github.com/dotnet/core/issues/7556)</sup>，所以 MAA 也同样不再支持。
|
||||
由于 MAA 依赖的运行库和系统组件要求 Windows 10 及以上版本，MAA 不再支持 Windows 7 / 8 / 8.1 系统。
|
||||
|
||||
## 连接错误
|
||||
|
||||
|
||||
@@ -70,7 +70,7 @@ MAA GUI **暂未支持** Linux 和其他操作系统。你可以使用 **maa-cli
|
||||
|
||||
1.请不要将 MAA 解压到如 `C:\`、`C:\Program Files\` 等需要 UAC 权限的路径。
|
||||
|
||||
2.MAA 需要 Visual C++ Redistributable x64（VCRedist x64）和 .NET 10 。请在解压后的 MAA 目录中以管理员身份运行 `DependencySetup_依赖库安装.bat` 来安装这些依赖。安装完成后再运行 `maa.exe`。
|
||||
2.MAA 已内置 .NET 运行时（自包含部署），但仍需要 Visual C++ Redistributable x64（VCRedist x64）。请在解压后的 MAA 目录中以管理员身份运行 `DependencySetup_依赖库安装.bat` 来安装该依赖。安装完成后再运行 `MAA.exe`。
|
||||
|
||||
更多信息请参考[常见问题](./faq.md)置顶。
|
||||
|
||||
|
||||
@@ -15,11 +15,21 @@ icon: teenyicons:linux-alt-solid
|
||||
|
||||
### 使用 Wine
|
||||
|
||||
MAA WPF GUI 當前可以透過 Wine 執行。
|
||||
MAA WPF GUI 當前可以透過 Wine 執行。MAA 已採用自包含部署方式，內建了 .NET 執行環境。
|
||||
|
||||
#### 安裝步驟
|
||||
|
||||
1. 前往 [.NET 發佈頁](https://dotnet.microsoft.com/en-us/download/dotnet/10.0) 下載並安裝 Windows 版 .NET **桌面**執行環境 (Runtime)。
|
||||
1. 安裝 Visual C++ Redistributable：
|
||||
|
||||
下載並安裝 [Visual C++ 可再發行套件](https://aka.ms/vc14/vc_redist.x64.exe)：
|
||||
|
||||
```shell
|
||||
wine vc_redist.x64.exe
|
||||
```
|
||||
|
||||
::: tip
|
||||
`DependencySetup_依赖库安装.bat` 基於 winget 和 Windows 提權機制，通常無法在 Wine 中正常工作，因此需要手動安裝執行庫。
|
||||
:::
|
||||
|
||||
2. 下載 Windows 版 MAA，解壓縮後執行 `wine MAA.exe`。
|
||||
|
||||
|
||||
@@ -12,16 +12,17 @@ icon: ph:question-fill
|
||||
若 MAA 在某次更新後無法執行，或是因為報錯視窗而導引至此，通常是因為執行庫未更新所致。
|
||||
執行庫問題是最常見的錯誤原因，且經常被忽略，因此我們將此說明置頂。
|
||||
|
||||
MAA 已採用自包含部署方式，內建了 .NET 執行環境，但仍需要 Visual C++ 執行庫。
|
||||
|
||||
請執行 MAA 目錄下的 `DependencySetup_依赖库安装.bat`，或在終端機中執行以下指令：
|
||||
|
||||
```sh
|
||||
winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements && winget install "Microsoft.DotNet.DesktopRuntime.10" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
|
||||
winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
|
||||
```
|
||||
|
||||
也可以手動下載並安裝以下<u>**兩個**</u>執行庫來解決問題：
|
||||
也可以手動下載並安裝以下執行庫來解決問題：
|
||||
|
||||
- [Visual C++ 可再發行套件](https://aka.ms/vc14/vc_redist.x64.exe)
|
||||
- [.NET 桌面執行階段 10](https://aka.ms/dotnet/10.0/windowsdesktop-runtime-win-x64.exe)
|
||||
|
||||
:::
|
||||
|
||||
@@ -52,7 +53,7 @@ winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /nore
|
||||
|
||||
#### Windows 7 / 8 / 8.1
|
||||
|
||||
.NET 10 不支援 Windows 7 / 8 / 8.1 系統<sup>[來源](https://github.com/dotnet/core/issues/7556)</sup>，所以 MAA 也同樣不再支援。
|
||||
由於 MAA 依賴的執行庫和系統元件要求 Windows 10 及以上版本，MAA 不再支援 Windows 7 / 8 / 8.1 系統。
|
||||
|
||||
## 連線錯誤
|
||||
|
||||
|
||||
@@ -28,7 +28,7 @@ icon: ri:guide-fill
|
||||
|
||||
4. 安裝執行庫
|
||||
|
||||
MAA 需要 VCRedist x64 和 .NET 10，請執行 MAA 目錄下的 `DependencySetup_依赖库安装.bat` 進行安裝。
|
||||
MAA 已內建 .NET 執行環境（自包含部署），但仍需要 VCRedist x64，請執行 MAA 目錄下的 `DependencySetup_依赖库安装.bat` 進行安裝。
|
||||
|
||||
更多資訊請參閱 [常見問題](./faq.md) 置頂內容。
|
||||
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
<Project Sdk="Microsoft.NET.Sdk">
|
||||
<Project Sdk="Microsoft.NET.Sdk">
|
||||
|
||||
<!-- Project -->
|
||||
<PropertyGroup>
|
||||
@@ -22,8 +22,9 @@
|
||||
<PublishReadyToRun>false</PublishReadyToRun>
|
||||
<PublishSingleFile>false</PublishSingleFile>
|
||||
<PublishTrimmed>false</PublishTrimmed>
|
||||
<SelfContained>false</SelfContained>
|
||||
<SelfContained Condition="'$(RuntimeIdentifier)' != ''">true</SelfContained>
|
||||
<BeautyLibsDir>./externals</BeautyLibsDir>
|
||||
<BeautyUsePatch Condition="'$(RuntimeIdentifier)' != ''">true</BeautyUsePatch>
|
||||
<AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
|
||||
<AppendRuntimeIdentifierToOutputPath>false</AppendRuntimeIdentifierToOutputPath>
|
||||
<PostBuildEvent>
|
||||
|
||||
@@ -82,6 +82,8 @@ public class Bootstrapper : Bootstrapper<RootViewModel>
|
||||
// 因为经常有人把 MAA 和别的东西解压到一起然后发生 DLL 劫持然后报错，遂检测
|
||||
var maaDlls = new HashSet<string>(StringComparer.OrdinalIgnoreCase)
|
||||
{
|
||||
"hostfxr.dll",
|
||||
"hostpolicy.dll",
|
||||
"libloader.dll",
|
||||
"DirectML.dll",
|
||||
"fastdeploy_ppocr.dll",
|
||||
|
||||
@@ -1439,8 +1439,13 @@ With save file: farm points through crafting (advanced).
|
||||
<system:String x:Key="UnknownDllDetected" xml:space="preserve">Unknown DLL files have been detected in the MAA runtime directory, which may cause DLL hijacking and unexpected consequences.
|
||||
Please extract MAA into a separate new folder, or remove any DLL files that do not belong to MAA.
|
||||
</system:String>
|
||||
<system:String x:Key="VC++NotInstalled" xml:space="preserve">Detected that Microsoft Visual C++ V14 Redistributable (x64) is NOT installed or the version is too low.
|
||||
Click "{key=Confirm}" to execute the installation script and exit MAA. Click "{key=Cancel}" to exit MAA directly.
|
||||
<system:String x:Key="VC++NotInstalled" xml:space="preserve">Failed to load MaaCore.dll. Possible reasons include:
|
||||
• Archive not fully extracted, missing necessary DLL files
|
||||
• Microsoft Visual C++ V14 Redistributable (x64) not installed or version too low
|
||||
• Other system dependencies missing
|
||||
|
||||
Please verify that the archive has been fully extracted.
|
||||
Click "{key=Confirm}" to attempt installing/updating VC++ runtime and exit MAA (ineffective for other causes). Click "{key=Cancel}" to exit directly.
|
||||
</system:String>
|
||||
<system:String x:Key="MultiInstanceUnderSamePath" xml:space="preserve">Only one instance can be launched under the same path!
|
||||
If you want to run multiple MAA at the same time, please copy the whole MAA and start under different path with the same adb and different connect address.
|
||||
|
||||
@@ -1440,8 +1440,13 @@ DEBUGディレクトリに保存される画像には数量制限があり、超
|
||||
<system:String x:Key="UnknownDllDetected" xml:space="preserve">MAA の実行ディレクトリに不明な DLL ファイルが検出されました。DLL ハイジャックが発生し、予期しない結果を招く可能性があります。
|
||||
MAA を新しい独立したフォルダーに解凍するか、MAA に属さない DLL ファイルを削除してください。
|
||||
</system:String>
|
||||
<system:String x:Key="VC++NotInstalled" xml:space="preserve">Microsoft Visual C++ V14 Redistributable (x64) がインストールされていないか、バージョンが低すぎることが検出されました。
|
||||
「{key=Confirm}」をクリックするとインストールスクリプトが実行され、MAA が終了します。「{key=Cancel}」をクリックすると MAA が直接終了します。
|
||||
<system:String x:Key="VC++NotInstalled" xml:space="preserve">MaaCore.dll の読み込みに失敗しました。考えられる原因：
|
||||
• アーカイブが完全に解凍されておらず、必要な DLL ファイルが不足している
|
||||
• Microsoft Visual C++ V14 Redistributable (x64) がインストールされていないか、バージョンが低すぎる
|
||||
• その他のシステム依存関係が不足している
|
||||
|
||||
まず、アーカイブが完全に解凍されているかご確認ください。
|
||||
「{key=Confirm}」をクリックすると VC++ ランタイムのインストール/更新を試みて MAA を終了します（他の原因の場合は無効）。「{key=Cancel}」をクリックすると直接終了します。
|
||||
</system:String>
|
||||
<system:String x:Key="MultiInstanceUnderSamePath" xml:space="preserve">同じパスの下で起動できるのは1つのインスタンスのみ！
|
||||
MAA を複数開くには、新しい MAA を他のフォルダにコピーし、異なる MAA、同じ adb、異なるシミュレータアドレスを使用して複数の操作を行うように設定します。
|
||||
|
||||
@@ -1441,8 +1441,13 @@ DEBUG 디렉토리에 저장된 이미지는 수량 제한이 있으며 초과
|
||||
<system:String x:Key="UnknownDllDetected" xml:space="preserve">MAA 실행 폴더에서 알 수 없는 DLL 파일이 감지되었습니다. 이는 DLL 하이재킹을 일으켜 예상치 못한 결과를 초래할 수 있습니다.
|
||||
MAA를 독립된 새 폴더에 압축 해제하거나, MAA에 속하지 않는 DLL 파일을 제거해 주세요.
|
||||
</system:String>
|
||||
<system:String x:Key="VC++NotInstalled" xml:space="preserve">Microsoft Visual C++ Redistributable 2015-2022(x64)가 설치되지 않았거나 버전이 너무 낮은 것으로 감지되었습니다..
|
||||
"{key=Confirm}"을 클릭하여 설치 스크립트를 실행하고 MAA를 종료하세요. "{key=Cancel}"를 클릭하여 MAA를 바로 종료하세요.
|
||||
<system:String x:Key="VC++NotInstalled" xml:space="preserve">MaaCore.dll 로드 실패. 가능한 원인:
|
||||
• 압축 파일이 완전히 압축 해제되지 않아 필요한 DLL 파일 누락
|
||||
• Microsoft Visual C++ V14 Redistributable (x64)가 설치되지 않았거나 버전이 너무 낮음
|
||||
• 기타 시스템 종속성 누락
|
||||
|
||||
먼저 압축 파일이 완전히 압축 해제되었는지 확인하세요.
|
||||
"{key=Confirm}"을 클릭하면 VC++ 런타임 설치/업데이트를 시도하고 MAA를 종료합니다(다른 원인인 경우 무효). "{key=Cancel}"을 클릭하면 바로 종료합니다.
|
||||
</system:String>
|
||||
<system:String x:Key="MultiInstanceUnderSamePath" xml:space="preserve">동일한 경로에서는 하나의 인스턴스만 실행할 수 있습니다!
|
||||
여러 개의 MAA를 동시에 실행하려면 MAA 전체 폴더를 복사한 뒤, 같은 adb를 사용하되 연결 주소는 다르게 설정하여 서로 다른 경로에서 실행하세요.
|
||||
|
||||
@@ -1440,8 +1440,13 @@ DEBUG 目录下保存的图片有数量限制，超出后会自动清理旧图
|
||||
<system:String x:Key="UnknownDllDetected" xml:space="preserve">检测到 MAA 运行目录下存在未知 DLL 文件，可能导致 DLL 劫持并产生意外后果。
|
||||
请将 MAA 解压到一个独立的新文件夹中，或移除不属于 MAA 的 DLL 文件。
|
||||
</system:String>
|
||||
<system:String x:Key="VC++NotInstalled" xml:space="preserve">检测到 Microsoft Visual C++ V14 Redistributable (x64) 未安装或版本过低,
|
||||
点击 "{key=Confirm}" 执行安装脚本并退出 MAA, 点击 "{key=Cancel}" 将直接退出.
|
||||
<system:String x:Key="VC++NotInstalled" xml:space="preserve">MaaCore.dll 加载失败，可能的原因包括：
|
||||
• 压缩包未完整解压，缺少必要的 DLL 文件
|
||||
• 未安装 Microsoft Visual C++ V14 Redistributable (x64) 或版本过低
|
||||
• 其他系统依赖缺失
|
||||
|
||||
请先确认是否已将压缩包完整解压。
|
||||
点击 "{key=Confirm}" 将尝试安装/更新 VC++ 运行库并退出 MAA（若为其他原因则无效），点击 "{key=Cancel}" 将直接退出。
|
||||
</system:String>
|
||||
<system:String x:Key="MultiInstanceUnderSamePath" xml:space="preserve">同一路径下只能启动一个实例！
|
||||
如需多开 MAA，请复制一份新的 MAA 到其他文件夹下，并设置使用不同的 MAA，相同的 adb 和不同的模拟器地址进行多开操作。
|
||||
|
||||
@@ -1440,8 +1440,13 @@ DEBUG 目錄下儲存的圖片有數量限制，超出後會自動清理舊圖
|
||||
<system:String x:Key="UnknownDllDetected" xml:space="preserve">偵測到 MAA 執行目錄下存在未知的 DLL 檔案，可能導致 DLL 劫持並產生意外後果。
|
||||
請將 MAA 解壓縮到一個獨立的新資料夾中，或移除不屬於 MAA 的 DLL 檔案。
|
||||
</system:String>
|
||||
<system:String x:Key="VC++NotInstalled" xml:space="preserve">偵測到 Microsoft Visual C++ V14 Redistributable (x64) 未安裝或版本過低。
|
||||
點擊 ｢{key=Confirm}｣ 將執行安裝腳本並結束 MAA；點擊 ｢{key=Cancel}｣ 將直接結束 MAA。
|
||||
<system:String x:Key="VC++NotInstalled" xml:space="preserve">MaaCore.dll 載入失敗，可能的原因包括：
|
||||
• 壓縮檔未完整解壓縮，缺少必要的 DLL 檔案
|
||||
• 未安裝 Microsoft Visual C++ V14 Redistributable (x64) 或版本過低
|
||||
• 其他系統依賴缺失
|
||||
|
||||
請先確認是否已將壓縮檔完整解壓縮。
|
||||
點擊 ｢{key=Confirm}｣ 將嘗試安裝/更新 VC++ 執行庫並結束 MAA（若為其他原因則無效），點擊 ｢{key=Cancel}｣ 將直接結束 MAA。
|
||||
</system:String>
|
||||
<system:String x:Key="MultiInstanceUnderSamePath" xml:space="preserve">同一路徑下只能啟動一個執行個體！
|
||||
如需多開 MAA，請複製一份新的 MAA 到其他資料夾，並設定使用不同的 MAA，搭配相同的 ADB 與不同的模擬器位址進行多開操作。
|
||||
|
||||
@@ -41,18 +41,6 @@ if %errorlevel% neq 0 (
|
||||
)
|
||||
echo %BLUE%====================================================================================================%RESET%
|
||||
|
||||
echo.
|
||||
echo %BLUE%====================================================================================================%RESET%
|
||||
echo %BOLD%%CYAN%正在安装 .NET Desktop Runtime 10.0%RESET%
|
||||
echo %BOLD%%CYAN%Installing .NET Desktop Runtime 10.0%RESET%
|
||||
echo.
|
||||
|
||||
winget install "Microsoft.DotNet.DesktopRuntime.10" --override "/repair /passive /norestart" --uninstall-previous --accept-package-agreements --force
|
||||
if %errorlevel% neq 0 (
|
||||
set "ErrorOccurred=1"
|
||||
)
|
||||
echo %BLUE%====================================================================================================%RESET%
|
||||
|
||||
echo.
|
||||
if %ErrorOccurred% equ 0 (
|
||||
echo %BOLD%%GREEN%运行库修复完成，请重启电脑后再次尝试运行 MAA。%RESET%
|
||||
@@ -65,15 +53,12 @@ if %ErrorOccurred% equ 0 (
|
||||
echo %YELLOW%如果提示%RESET% %WHITE%'winget' is not...%RESET% %YELLOW%说明您的电脑版本太老了，没有自带 winget%RESET%
|
||||
echo %YELLOW%If the prompt shows%RESET% %WHITE%'winget' is not...%RESET% %YELLOW%it means your system is too old and don't include winget by default.%RESET%
|
||||
echo.
|
||||
echo %YELLOW%您可以手动将以下两个链接复制到浏览器中打开，下载并安装所需组件。如果安装成功，无需再次运行本依赖库安装脚本。%RESET%
|
||||
echo %YELLOW%You can manually copy the following two links into your browser to download and install the required components.%RESET%
|
||||
echo %YELLOW%您可以手动将以下链接复制到浏览器中打开，下载并安装所需组件。如果安装成功，无需再次运行本依赖库安装脚本。%RESET%
|
||||
echo %YELLOW%You can manually copy the following link into your browser to download and install the required components.%RESET%
|
||||
echo %YELLOW%If the installation is successful, you don't need to run this dependency installation script again.%RESET%
|
||||
echo.
|
||||
echo %WHITE%Microsoft Visual C++ Redistributable:%RESET%
|
||||
echo %CYAN%https://aka.ms/vc14/vc_redist.x64.exe%RESET%
|
||||
echo.
|
||||
echo %WHITE%.NET Desktop Runtime 10.0:%RESET%
|
||||
echo %CYAN%https://aka.ms/dotnet/10.0/windowsdesktop-runtime-win-x64.exe%RESET%
|
||||
echo %RED%====================================================================================================%RESET%
|
||||
)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user