安裝及編譯
約 1054 字大約 4 分鐘
maa-cli 提供多種方式安裝,包括預編譯執行檔、套件管理員以及透過 cargo 自行編譯安裝。
預編譯執行檔
安裝 maa-cli 最簡單的方式是使用安裝指令碼一鍵安裝:
curl -fsSL https://raw.githubusercontent.com/MaaAssistantArknights/maa-cli/main/install.sh | bashInvoke-WebRequest -Uri "https://raw.githubusercontent.com/MaaAssistantArknights/maa-cli/main/install.ps1" -OutFile install.ps1; .\install.ps1後續您可以透過 maa self update 來更新 maa-cli。
如果您的平台不在上述列表中,可以嘗試自行編譯安裝。
透過套件管理員安裝
對於 macOS 和受支援的 Linux 發行版使用者,可以使用套件管理員安裝 maa-cli。
macOS
Homebrew 使用者可以透過非官方的 tap 安裝 maa-cli:
brew install MaaAssistantArknights/tap/maa-clibrew install MaaAssistantArknights/tap/maa-cli-betaLinux
Arch、Nix 以及 Linux Homebrew 使用者可以透過套件管理員安裝 maa-cli。
Arch Linux
可以安裝 AUR 套件:
paru -S maa-cliyay -S maa-cli❄️ Nix
使用者可以直接執行:
nix run nixpkgs#maa-clinix run github:Cryolitia/nur-packages#maa-cli-nightly穩定版本已收錄至 nixpkgs 中,並使用 nixpkgs 中的 Rust 工具鏈;Nightly 版本則位於 NUR,使用 Beta 分支的 Rust 工具鏈,且每日經由 GitHub Actions 自動更新與驗證建置結果。
Homebrew
對於在 Linux 上使用 Homebrew 的使用者,請參考上述 macOS 的安裝方式。
其他发行版
我們也歡迎各位有興趣的開發者將 maa-cli 提交到更多發行版的官方倉庫或是使用者倉庫!
編譯安裝
Rust 開發者可以透過 cargo 自行編譯安裝 maa-cli:
cargo install --git https://github.com/MaaAssistantArknights/maa-cli.git --bin maa --tag stable --lockedcargo install --git https://github.com/MaaAssistantArknights/maa-cli.git --bin maa --locked注意
maa-cli 目前的最低支援 Rust 版本 (MSRV) 為 1.88。請注意,MSRV 可能隨時發生變化,我們建議始終使用最新的 Rust 工具鏈以獲得最佳體驗。
編譯選項
從原始碼編譯時,您可以透過 --no-default-features 停用預設的特性,然後透過 --features 來啟用特定的特性。目前可用的特性有:
cli_installer: 啟用maa self update指令,用於更新自身,這個特性預設啟用。core_installer: 啟用maa install和maa update指令,用於安裝和更新 MaaCore 及資源,這個特性預設啟用。git2: 提供libgit2資源更新後端,這個特性預設啟用。
安裝 MaaCore 及資源
maa-cli 只提供了一個命令列介面,它需要 MaaCore 和資源來執行任務。
根據安裝方式和平台的不同,您的操作也會有所區別:
對於使用預編譯執行檔或者自行編譯的使用者,maa-cli 可以協助您安裝和更新:
maa install對於 Windows 使用者,在執行 maa install 指令前,請以管理員身份在命令提示字元或 PowerShell 中執行以下指令,以安裝必要組件 VC++ 執行環境 (Redistributable):
winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --uninstall-previous --accept-package-agreements --force然後再執行 maa install。
您可以使用 maa-cli 安裝預編譯的 MaaCore:
maa install您也可以透過 AUR 安裝 maa-core
paru -S maa-assistant-arknights或者
yay -S maa-assistant-arknightsNix 上的 maa-cli 強制依賴 MaaCore,因此 Nix 使用者無需、也不應該手動安裝 MaaCore。
注意
maa install 下載的是 MAA 官方預編譯的 MaaCore,而套件管理員安裝的 MaaCore 可能使用與官方預編譯版本不同的編譯選項和依賴版本,這也許會導致效能和功能上的些微差異。
