MaaAssistantArknights/docs/ko-kr/develop/linux-tutorial.md

order, icon

order	icon
2	teenyicons:linux-alt-solid

Linux 컴파일 가이드

이 튜토리얼은 독자가 일정한 Linux 환경 설정 능력과 프로그래밍 기초를 가지고 있다고 가정합니다!, 만약 여러분이 MAA를 직접 컴파일하는 대신에 단순히 설치하길 원한다면 Linux 설명서를 참고하세요.

::: info 정보 MAA의 빌드 방법은 여전히 논의 중입니다. 이 튜토리얼의 내용은 오래되었을 수 있으므로 GitHub workflow file의 스크립트를 참고하세요. 또한 AUR PKGBUILD 및 nixpkgs을 참고할 수 있습니다. :::

::: info Mac은 tools/build_macos_universal.zsh 스크립트를 사용하여 컴파일할 수 있습니다. MaaAssistantArknights/MaaMacGui 프로젝트의 README.md를 참고하는 것을 권장합니다. :::

컴파일 과정

1. 컴파일에 필요한 종속성 다운로드

   • Ubuntu/Debian

   sudo apt install gcc-14 g++-14 cmake zlib1g-dev
   

2. 서드파티 라이브러리 빌드

   사전 빌드된 종속성 라이브러리를 다운로드하거나 직접 빌드할 수 있습니다.

   • 사전 빌드된 서드파티 라이브러리 다운로드 (권장됨)

     Note

     상대적으로 최신의 Linux 배포판 (Ubuntu 22.04)에서 컴파일된 동적 라이브러리가 포함되어 있습니다. 시스템의 libstdc++ 버전이 오래되었을 경우 ABI 호환성 문제가 발생할 수 있습니다.

     python tools/maadeps-download.py
     

   위의 방법으로 다운로드한 라이브러리가 시스템에서 실행되지 않거나 컨테이너와 같은 대안을 사용하지 않고 싶은 경우 직접 빌드해볼 수도 있습니다.

   • 서드파티 라이브러리 직접 빌드 (시간이 오래 걸릴 수 있음)

     git submodule update --init --recursive
     cd MaaDeps
     python build.py
     

3. MAA 컴파일

   CC=gcc-14 CXX=g++-14 cmake -B build \
       -DINSTALL_RESOURCE=ON \
       -DINSTALL_PYTHON=ON
   cmake --build build
   

   경로에 MAA를 설치하기 위해 위의 명령을 사용합니다. MAA는 LD_LIBRARY_PATH를 지정하여 실행하는 것이 좋으며, MAA를 /usr에 설치하지 마세요.

   cmake --install build --prefix <target_directory>
   

통합 문서

문서가 아닐수도 있습니다

Python

Python demo에서 __main__의 구현을 참조하세요.

C++

CppSample의 구현을 참조하세요.

C Sharp

MaaWpfGui의 구현을 참조하세요.