インストールガイド

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があるもので、拡張パック2本と音楽を含めて約1.1 GBです。Macでの探し方。

2ツールをインストール

ターミナルを開き、Xcodeのコマンドラインツールをインストールしてから、CMakeとNinjaをHomebrewなどでインストールします。Python 3はコマンドラインツールに含まれています。

Terminal
$ xcode-select --install$ brew install cmake ninja
図解

3ソースコードを入手

最初のビルドでは、ゲームがiOSで必要とするライブラリの取得とビルドも、一度だけ行います。

Terminal
$ 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を読み取ります。

Accounts
GeneralAccountsBehaviorsNavigationThemes
Apple IDs
you@example.com
TeamRole
Your Name (Personal Team)User
A1B2C3D4E5
図解

次に、open-annihilationフォルダーからプロジェクトを作成します。プロジェクトはXcodeで開きます:

Terminal
$ 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ビルドとインストール

  1. iPhoneかiPadを接続し、ロックを解除します。初回は、デバイスで信頼をタップします。
  2. Xcodeのツールバーで、oa-gameスキーム 1と自分のデバイス 2を選びます。
  3. アプリの識別子が使えないとXcodeに表示されたら、Signing & CapabilitiesのBundle Identifierを、net.yourname.open-annihilationのような自分のもの 4に変更します。
  4. Product › Run 3を選びます。
▶oa-game›Commander’s iPhoneReady
open-annihilation
oa-game
platforms
src
GeneralSigning & CapabilitiesInfoBuild Settings
Automatically manage signing
Your Name (Personal Team)
net.yourname.open-annihilation
図解

6デバイスでアプリを許可

初回は、自分のチームのアプリをデバイスが開こうとしません。iOS・iPadOS 16以降ではデベロッパモードをオンにします。設定 › プライバシーとセキュリティ › デベロッパモード 1でオンにし 2、求められたらデバイスを再起動します。

9:41
‹ 設定プライバシーとセキュリティ
位置情報サービスオン›
トラッキング›
ローカルネットワーク›
セキュリティ
デベロッパモードオフ›
9:41
‹ 戻るデベロッパモード
デベロッパモード
デベロッパモードをオンにすると、デバイスが再起動します。
図解

続いて、デベロッパプロファイルを信頼します。設定 › 一般 › VPNとデバイス管理で、デベロッパAppの下にある自分のApple ID 1を選び、信頼 2をタップします。これで、ホーム画面からOpen Annihilationを開けます。

9:41
‹ 一般VPNとデバイス管理
VPN未接続›
デベロッパApp
Apple Development: you@example.com›
9:41
‹ 戻るApple Development
“Apple Development: you@example.com”を信頼
このデベロッパのApp:Open Annihilation
図解

7ゲームファイルを追加

初めて開くと、Game files画面に、Total Annihilationのファイルをデバイスに持ってくる3つの方法が表示されます。どれを選んでもファイルはチェックされ、ファイルがないせいでアプリが終了することはありません。

The Game files screen on an iPad
スクリーンショットiPadのGame files画面。
  1. Total Annihilationのフォルダーを、デバイスから見える場所に置きます。iCloud Drive、USBドライブ、コンピューターの共有フォルダー(先に「ファイル」Appで接続しておきます)、またはデバイス本体です。
  2. CHOOSE FOLDER、ブラウズの順にタップし、フォルダーを見つけて開き、開くをタップします。アプリは名前とサイズしか読まないので、この時点では何もダウンロードされません。
  3. Ready to copyには、見つかったもの、任意の部分のスイッチ、コピーしないもの、コピーに必要な容量が表示されます。COPYをタップします。
Ready to copy
スクリーンショットReady to copy(コピーの準備完了)。
  1. コピー中は、進行状況、残り時間、処理中のファイルが表示されます。終わるまでアプリを開いたままにしてください。アプリから離れると一時停止し、戻ると再開します。iCloudにしかないファイルは、コピーするときにダウンロードされます。
Copying
スクリーンショットCopying(コピー中)。
  1. コピーはゲーム自身のチェックで確認され、続いてReady to playに、ゲームがプレイする内容が表示されます。PLAYをタップします。
Ready to play
スクリーンショットReady to play(プレイの準備完了)。

8プレイ

Open Annihilationを開き、デバイスを横向きにします。ゲームは横画面専用です。タッチ操作には、タップで移動、建設ドロワー、長押しで命令ホイール、ピンチでズームがあります。キーボード、マウス、トラックパッドは、コンピューターと同じように使えます。

✓準備完了、コマンダー

メインメニューが表示されれば、ゲームはファイルを見つけています。キャンペーン、スカーミッシュ、ネットワーク対戦から選んでください。

Open Annihilation main menu
スクリーンショット

ゲームファイルの管理

メインメニューの歯車の設定ボタンで設定を開き、ゲームファイルを選びます。インストールされている内容、そのサイズと空き容量、ファイルをデバイスのバックアップに含めるかどうか(約1.1 GBがiCloudの容量に数えられるため、初期設定ではオフ)、そしてMANAGE…があります。MANAGE…では、拡張パック、マップ、MODの追加、ファイルの再チェック、削除や置き換えができます。セーブデータと設定は常に残ります。

Managing the game files on an iPhone
スクリーンショットiPhoneでのゲームファイルの管理。

ネットワーク対戦

ゲームが初めてネットワークを使うとき、ローカルネットワーク上のデバイスを検出して接続することを許可するか、iOSが尋ねます。許可をタップするか、あとで設定 › プライバシーとセキュリティ › ローカルネットワークでオンにします。無料のApple IDで署名したビルドは、ブロードキャストでゲームを検索できません。TCP/IP画面でホストのアドレスを入力して参加してください(デバイスのアドレスは設定 › Wi-Fiの情報ボタンで確認できます)。有料のチームなら、Appleにマルチキャストネットワーキングのエンタイトルメントを申請し、--multicast-entitlementを付けてビルドできます。

トラブルシューティング

「信頼されていないデベロッパ」
デベロッパプロファイルを信頼してください(手順6)。
1週間後にアプリが開かなくなった
無料のApple IDの署名は7日間有効です。ビルドしてインストールし直してください(手順5)。
「This folder does not hold a Total Annihilation installation」
totala1.hpiがあるフォルダーを選んでください。
「Not enough space」
設定 › 一般 › iPhoneストレージで空き容量を作るか、任意の部分をオフにしてから、CHECK AGAINかCONTINUEをタップします。コピー済みの分は残ります。
「The copy stopped」
ドライブ、共有フォルダー、またはネットワークが切断されました。接続し直してCONTINUEをタップしてください。
検索してもゲームが表示されない
TCP/IP画面でホストのアドレスを入力するか、マルチキャストネットワーキングのエンタイトルメント付きでビルドしてください。

アップデートと削除

アップデートするには、open-annihilationフォルダーでgit pullを実行し、ビルドしてインストールし直します(手順5)。ゲームファイル、セーブデータ、設定はデバイスに残ります。ゲームを削除するには、アイコンを長押ししてAppを削除を選びます。アプリにコピーしたゲームファイルも一緒に削除されます。

ほかのプラットフォーム

説明と違うところがありますか? Discord · GitHub Issues