설치 가이드
iPhone 및 iPad
App Store 버전은 없습니다. Mac에서 Xcode로 앱을 빌드해 내 iPhone이나 iPad에 설치합니다. 앱은 처음 실행할 때 가지고 있는 게임에서 게임 데이터를 복사합니다.
- iOS 및 iPadOS 15 이상
- Xcode 26이 설치된 Mac
- 무료 Apple ID로도 가능
- 기기 여유 공간 약 2 GB
1준비물
- Mac: Mac App Store에서 받은 Xcode 26 이상. Xcode를 한 번 열어 구성 요소를 설치하세요.
- Apple ID: Xcode › Settings › Accounts에서 로그인하세요. 무료 계정도 되지만 앱이 7일 뒤에 열리지 않아 다시 빌드해야 하며, 유료 Developer Program 멤버십은 1년 동안 서명이 유지됩니다.
- iPhone 또는 iPad: iOS 또는 iPadOS 15 이상, 케이블로 연결하거나 Wi-Fi로 Mac과 페어링합니다.
- Total Annihilation 폴더:
totala1.hpi가 있는 폴더로, 두 확장팩과 음악을 포함해 약 1.1 GB입니다. Mac에서 찾는 방법.
2도구 설치
터미널을 열고 Xcode 명령줄 도구를 설치한 다음, Homebrew 등으로 CMake와 Ninja를 설치하세요. Python 3은 명령줄 도구에 함께 들어 있습니다.
$ xcode-select --install$ brew install cmake ninja
3소스 코드 받기
첫 빌드에서는 게임에 필요한 iOS용 라이브러리도 한 번 받아서 빌드합니다.
$ git clone https://github.com/open-annihilation/open-annihilation.git$ cd open-annihilation$ python3 tools/bootstrap_text_fonts.py --fonts-only
4Xcode 프로젝트 만들기
팀 ID를 확인하세요. Xcode › Settings › Accounts에서 Apple ID를 선택하고 1 팀 ID를 확인하세요 2.
그다음 open-annihilation 폴더에서 프로젝트를 만드세요. 프로젝트는 Xcode에서 열립니다.
$ platforms/ios/scripts/xcode.sh --device --team A1B2C3D4E5 --open테스트 기기라면 cmake -B build-ios-xcode -DOA_IOS_BUNDLED_GAME_DIR="$HOME/Games/Total Annihilation" 명령으로 게임 폴더를 앱에 넣어 빌드할 수 있습니다. 앱이 약 1.1 GB 커지지만 설치하자마자 플레이할 수 있습니다.
5빌드와 설치
- iPhone이나 iPad를 연결하고 잠금을 해제하세요. 처음에는 기기에서 신뢰를 탭하세요.
- Xcode 도구 막대에서 oa-game 스킴을 선택하고 1 기기를 선택하세요 2.
- 앱 식별자를 쓸 수 없다고 나오면 Signing & Capabilities의 Bundle Identifier를
net.yourname.open-annihilation처럼 자신만의 값으로 바꾸세요 4. - Product › Run을 선택하세요 3.
oa-game›Commander’s iPhoneReady6기기에서 앱 허용
처음에는 기기가 내 팀에서 만든 앱을 열지 않습니다. iOS 및 iPadOS 16 이상에서는 개발자 모드를 켜세요. 설정 › 개인정보 보호 및 보안 › 개발자 모드로 가서 1 켜고 2, 재시동하라고 하면 기기를 재시동하세요.
그다음 개발자 프로파일을 신뢰하세요. 설정 › 일반 › VPN 및 기기 관리에서 개발자 앱 아래의 Apple ID를 선택하고 1 신뢰를 탭하세요 2. 이제 홈 화면에서 Open Annihilation을 여세요.
7게임 파일 추가
처음 열면 게임 파일 화면에서 Total Annihilation 파일을 기기로 가져오는 세 가지 방법을 보여 줍니다. 어느 방법을 고르든 파일을 확인하며, 파일이 없다고 앱이 닫히는 일은 없습니다.
- Total Annihilation 폴더를 기기가 접근할 수 있는 곳에 두세요. iCloud Drive, USB 드라이브, 컴퓨터의 공유 폴더(먼저 파일 앱에서 연결), 또는 기기 자체도 됩니다.
- 폴더 선택을 탭하고 둘러보기를 탭한 다음, 폴더를 찾아 열고 열기를 탭하세요. 앱은 이름과 크기만 읽으므로 아직 아무것도 다운로드되지 않습니다.
- 복사 준비 완료 화면에 찾은 내용, 선택 항목의 스위치, 제외되는 내용, 복사에 필요한 공간이 표시됩니다. 복사를 탭하세요.
- 복사하는 동안 진행 상황, 남은 시간, 현재 파일이 표시됩니다. 끝날 때까지 앱을 열어 두세요. 앱을 벗어나면 일시 정지했다가 돌아오면 이어서 복사합니다. iCloud에만 있는 파일은 복사하면서 다운로드됩니다.
- 복사한 파일을 게임 자체 검사로 확인한 뒤, 플레이 준비 완료에 게임이 플레이할 내용이 표시됩니다. 플레이를 탭하세요.
- Mac으로: 기기를 연결하고 Finder 사이드바에서 기기를 선택한 다음, 파일 탭을 열고 Total Annihilation 폴더를 Open Annihilation 위로 드래그하세요.
- 기기에서: 파일 앱에서 폴더를 나의 iPhone(또는 iPad) › Open Annihilation에 복사하세요.
복사한 폴더 이름을 Total Annihilation으로 정한 다음 복사 완료를 탭하세요. 이름이 다르면 앱이 폴더를 찾아 제자리에 옮길지 묻습니다.
- 기기에서 데모 설치 프로그램을 다운로드하세요. 보통
Total Annihilation.exe라는 이름의 21.5 MB짜리 Windows 프로그램입니다. 예를 들어 Safari로 받으면 파일 › 다운로드에 저장됩니다. - 설치 프로그램 선택을 탭하고 파일을 고른 다음 복사를 탭하세요.
앱은 체크섬으로 설치 프로그램을 알아보며, 실행하지 않고 20 MB의 게임 데이터를 풉니다. 그다음 플레이를 탭하세요.
8플레이
Open Annihilation을 열고 기기를 가로로 돌리세요. 게임은 가로 화면만 지원합니다. 터치 조작은 탭으로 이동, 건설 패널, 길게 눌러 여는 명령 휠, 핀치로 확대/축소를 지원하며, 키보드, 마우스, 트랙패드는 컴퓨터에서처럼 동작합니다.
✓준비가 끝났습니다, 커맨더
메인 메뉴가 나타나면 게임이 파일을 찾은 것입니다. 캠페인, 스커미시, 네트워크 게임 중 하나를 고르세요.
게임 파일 관리
메인 메뉴의 톱니바퀴 모양 설정 버튼으로 설정을 열고 게임 파일을 선택하세요. 설치된 내용, 크기와 여유 공간, 파일을 기기 백업에 포함할지 여부(약 1.1 GB가 iCloud 용량을 차지하므로 기본값은 꺼짐), 그리고 확장팩, 맵, 모드를 추가하거나 파일을 다시 확인하거나 제거, 교체하는 관리…가 있습니다. 저장된 게임과 설정은 항상 유지됩니다.
네트워크 게임
게임이 처음 네트워크를 쓸 때 iOS가 로컬 네트워크의 기기를 찾고 연결해도 되는지 묻습니다. 허용을 탭하거나, 나중에 설정 › 개인정보 보호 및 보안 › 로컬 네트워크에서 켜세요. 무료 Apple ID로 서명한 빌드는 브로드캐스트로 게임을 검색할 수 없으므로, TCP/IP 화면에서 호스트의 주소를 입력해 참가하세요(기기의 주소는 설정 › Wi-Fi의 정보 버튼에 있습니다). 유료 팀은 Apple의 멀티캐스트 네트워킹 권한을 요청해 --multicast-entitlement 옵션으로 빌드할 수 있습니다.
문제 해결
“신뢰하지 않는 개발자”
일주일 뒤 앱이 열리지 않습니다
“이 폴더에는 Total Annihilation이 설치되어 있지 않습니다”
totala1.hpi가 들어 있는 폴더를 선택하세요.“공간 부족”
“복사 중단됨”
검색해도 게임이 나타나지 않습니다
업데이트와 제거
업데이트하려면 open-annihilation 폴더에서 git pull을 실행하고 다시 빌드해 설치하세요(5단계). 게임 파일, 저장된 게임, 설정은 기기에 그대로 남습니다. 게임을 제거하려면 아이콘을 길게 누르고 앱 제거를 선택하세요. 앱 안에 복사한 게임 파일도 함께 제거됩니다.