Apple Silicon(M1)で iOS 開発環境を爆速構築する方法


はじめに

この記事は、とにかく早く Apple Silicon 環境で iOS アプリ開発環境を整えなければならない方を対象に執筆しました。
Apple Silicon で動かないと業務に支障が出るから買い換えられない…
なんて方を救えたら嬉しいです。

なので、
Rosetta を使うのは嫌!ワークアラウンドも嫌!という方は別記事を参考にしていただければと思います。

検証済み環境

  • Tool
    • CocoaPods
    • Carthage
    • SPM
    • Mint
    • XcodeGen
    • Homebrew
  • Env
    • MacBook Pro 14 inch 2021
      • Apple M1 Pro
    • macOS Monterey 12.2.1
    • mac-auto-setup

Rosetta を使いましょう

サードパーティ製ツールをあまり使っていない場合を除き、Apple Silicon 対応にはある程度の工数が必要になることが多いです。
まずは Rosetta 環境下で動くようにして、快適な環境下で少しずつ Apple Silicon 対応を進めていくことをお勧めします。

Shell commands

お使いのターミナルアプリを Rosetta で起動するようにチェックを入れるか、arch -arch x86_64 を付けてコマンドを実行しましょう。どちらも同じですが、うまく動かないときは前者で試してみてください。

Ruby に関連する問題

rbenv のインストールや rbenv 経由での Ruby インストールを Apple Silicon (No use Rosetta)環境下で実行した場合は特に問題に遭遇する可能性が高いです。その一例をご紹介します。

# 以下エラー発生時に実行
# ffi-X.XX.X/lib/ffi_c.bundle' (mach-o file, but is an incompatible architecture (have 'x86_64', need 'arm64e'))
bundle config --local build.ffi --enable-system-libffi

bundle install を試みた際、rbenv で導入した Ruby と ffi の相性が悪く、エラーが発生する場合があります。その場合、ffi のインストールに必要な libffi をシステム標準の物を使うように強制することで回避可能です。

Xcode

Xcode も Rosetta で起動するようにチェックを入れるか、arch -arch x86_64 を付けて open コマンドを実行しましょう。
ただし、これだけで安心してはいけません。

シミュレータも合わせて Rosetta で起動するように明示的に設定しないと挙動が不安定になります。
/Applications/Xcode.app/Contents/Developer/Applications/Simulator.app に対しても Open using Rosetta を有効化しましょう。

Homebrew の仕様変更

Xcode プロジェクト内で Homebrew でインストールしたコマンドが command not found になる場合があります。これは、Homebrew 経由でのソフトウェアインストール先が変更になったことによるものです。

# mint の場合
sudo sh -c "mkdir -p /usr/local/bin & ln -s $(brew --prefix)/bin/mint /usr/local/bin/mint"

Xcode 内で実行される Shell Script は一部の PATH しか許可されていないため、従来の PATH にシンボリックリンクを作成することで回避可能です。

Mint 経由のコマンド実行に失敗

xcrun --sdk macosx mint run swiftlint
# ↓
/opt/homebrew/bin/swiftlint

mint run コマンドが失敗する事象に遭遇しました。
調査・試行錯誤を行いましたが、まだ解決できていないため、一時的に Homebrew 経由でインストールした物を呼び出すように書き換えて対応しています。今回は特に lint 系だったこともあり、ワークアラウンド対応としました。

ワークアラウンドとしてコミットする場合、一律で書き換えるのではなく Apple Silicon の場合のみコマンドを変えるように分岐処理を追加すると良いでしょう。

さいごに

いかがだったでしょうか。
他にも環境構築系で苦戦することがあるかと思います。その際には私の環境構築スクリプトも参考にしていただけたらと思います(mac-auto-setup)。

最後まで読んでいただき、ありがとうございます。