
M4 Mac miniからM4 MacBook Airへ。開発環境を「コピー」ではなく「復旧できる状態」に移した話
これまで、個人開発やZMK Editorの作業はM4 Mac miniを中心に進めてきました。
M4 Mac miniは、16GBメモリ、512GB SSDの構成です。
最初は問題なく使えていたのですが、Xcode、Simulator、ブラウザ、Terminal、ChatGPT、Codex、Perplexityなどを同時に開きながら作業することが増え、16GBでは少し余裕がないと感じる場面が増えてきました。
そして、もう1つ大きかったのが作業場所です。
Mac miniはデスクトップなので、当然ですが自席でしか作業できません。
家の中で少し場所を変えたいときや、外出先で続きを触りたいときにも、開発環境が完全に机へ固定されていることが少しずつ面倒になってきました。
そこで今回、24GBメモリ、512GB SSDのM4 MacBook Airへ、開発環境を移すことにしました。
ただし、今回はMigration AssistantでMac全体をそのままコピーする方法は選びませんでした。
せっかく移すなら、開発環境を整理し直して、次にMacを買い替えるときにも移行しやすい状態にしておきたかったからです。
ChatGPTとCodexに相談しながら、移行前の確認、データ保全、新しいMacでの復旧確認までを進めました。
1. 今回の移行で重視したこと
今回、特に重視したのは以下です。
開発中のプロジェクトを失わないこと
GitHubに上がっていない作業途中のデータも保全すること
Xcodeの署名環境を確実に移行すること
App Store Connect関連の秘密情報も復旧可能にしておくこと
Obsidianに残している開発メモを引き継ぐこと
大容量のMusicデータを無駄に内蔵SSDへコピーしないこと
最後に、旧Macがなくても本当に開発を再開できることを確認すること
一般的なデータ移行というより、開発環境の引っ越しと、バックアップの見直しを同時にやるような作業でした。
最終的には、MacBook Airだけで各プロジェクトを開き、ビルドやテストを進められる状態まで確認できました。
2. プロジェクトの置き場所を統一
これまでは、プロジェクトがDesktop、ホームディレクトリ直下、Developerフォルダなど複数の場所に分かれていました。
新しいMacでは、開発中のプロジェクトを原則として ~/Developer/ 以下にまとめることにしました。
~/Developer/
├── プロジェクト1/
├── プロジェクト2/
├── プロジェクト3/
├── プロジェクト4/
├── プロジェクト5/
├── Tools/
└── Documentation/すべてのプロジェクトを新しいMacへそのまま持っていったわけではありません。
すでに開発を止めているものは、GitHubと保全データから復旧できる状態にしておき、必要になったときにcloneする形にしています。
ここで改めて感じたのは、フォルダをコピーすることと、プロジェクトを復旧可能にすることは同じではないということです。
3. いきなりコピーせず、まず旧Macを監査
最初に行ったのは、ファイルコピーではなくMac mini側の確認でした。
プロジェクトごとに、以下を確認しています。
現在使っているリポジトリはどれか
branchとHEADはどこを指しているか
GitHub上の状態と一致しているか
staged、unstaged、untrackedの変更はないか
stashが残っていないか
Git worktreeを使っていないか
同じプロジェクトの重複リポジトリがないか
Git管理外の画像、Archive、テスト結果などが残っていないか
Obsidianの開発メモにしか残っていない情報はないか
GitHubにpushされているから安心、と単純には言えませんでした。
たとえばZMK Editorでは、現在使っているリポジトリとは別に、古いリポジトリ、複数のworktree、stash、翻訳作業の途中データなどが残っていました。
別のプロジェクトでも、最新ビルドとは別に、mainブランチへ未commitの作業途中データが残っていました。
GitHubから新しいMacへcloneするだけでは、こうした途中状態の一部を失う可能性があります。
4. GitHubに入れにくい作業途中データは「復元セット」に
正式にcommitすべきものはGitHubへ保存しました。
一方で、意図が完全には確認できない作業途中データを、「移行するため」という理由だけで無理にcommitすることは避けました。
その代わりに、以下をまとめて保全しました。
git bundle
patchファイル
untrackedファイルのアーカイブ
stashの保全
SHA-256チェックサム
復元元になるcommit情報
復元手順のメモ
これを自分の中では「復元セット」と呼んでいます。
現在のbranchへ強引にmergeしなくても、必要になったときに当時の状態へ戻せるようにしておく方法です。
作業途中のデータは、今のコードへ混ぜるべきではないこともあります。
そのため、「消さないこと」と「今すぐ反映すること」を分けて考えられたのはよかったです。
5. コピーできたことではなく、コピー先から読めることを確認
今回の移行では、ずっと以下の順番を意識していました。
Copy
↓
Checksum
↓
Read-back
↓
Accept大事なファイルはSHA-256を取り、転送元と転送先で一致することを確認しました。
XcodeのArchiveについても、ファイルが存在するだけではなく、Bundle ID、Version、Build、dSYM、IPA、Archiveの情報などを確認しています。
少しやりすぎに見えるかもしれません。
ただ、旧Macを消したあとで「実は壊れていた」「必要なデータが入っていなかった」と気づくのが一番困るので、ここは慎重に進めました。
6. XcodeやHomebrewはコピーせず、新しいMacで入れ直し
Xcode、Homebrew、Node.jsなどは、旧Macからそのままコピーしていません。
MacBook Air側で改めて導入しました。
Xcode
Command Line Tools
Homebrew
Node.js / npm
GitHub CLI
Codex CLI
Claude Code
そのほか開発で使うCLIツール
DerivedData、Simulatorの一時データ、Homebrewのインストールディレクトリ、global node_modulesなども、基本的には新しいMacで作り直しています。
その方が、旧Mac固有のキャッシュや設定を持ち込まずに済みます。
次にMacを移行するときも、必要なツールを入れ直せばよい状態に近づけたかったからです。
7. GitHubからcloneしただけで、移行完了にしない
MacBook Airでは、各リポジトリを ~/Developer/ にcloneしました。
その後、以下を確認しました。
正しいbranchか
HEADが期待したcommitを指しているか
originとのahead / behindが0 / 0か
working treeがcleanか
Git integrityに問題がないか
VersionやBuildが想定どおりか
この確認が終わって、初めてsource codeの移行完了としました。
cloneできたことと、作業を再開できることは別です。
新しいMacで同じ状態を再現できるかを確認するところまでが、移行作業だと思います。
8. 一番慎重だったのはAppleの署名環境
iOSアプリ開発では、source codeだけを移しても十分ではありません。
Apple DevelopmentやApple Distributionの証明書に対応する秘密鍵がなければ、同じように署名できません。
今回は、以下を移行対象として確認しました。
Apple Development証明書と秘密鍵
Apple Distribution証明書と秘密鍵
App Store Connect APIの秘密鍵
証明書については、MacBook Airのキーチェーンに表示されたからOK、とはしませんでした。
実際に一時的なファイルへ署名し、検証コマンドまで成功することを確認しています。
さらに、XcodeからRelease Buildを実行し、automatic provisioningと署名が成立するところまで確認しました。
ここまで確認して、初めて新しいMacでApp Store ConnectやTestFlight向けの作業を再開できる状態になりました。
9. 署名情報には、独立したバックアップも作成
新しいMacが故障したら、また同じ問題になります。
そのため署名情報には、MacBook Airとは別のバックアップも用意しました。
暗号化した外部ストレージ1に、以下を保存しています。
Apple Development用の証明書バックアップ
Apple Distribution用の証明書バックアップ
App Store Connect APIの秘密鍵バックアップ
復旧手順のメモ
保全内容を確認するための一覧
さらに別の一時キーチェーンへ証明書バックアップを読み込み、秘密鍵込みで復元できることと、復元した署名情報で署名できることまで確認しました。
つまり、Mac miniがなくても署名環境を復旧できる状態です。
ここまで確認してから、移行完了と判断しました。
10. Obsidianも開発環境の一部として扱う
各プロジェクトでは、GitHubだけでなくObsidianにも、Current Status、Roadmap、Build Closure、Migration Manifestなどのメモを残しています。
そのため、Obsidianも開発環境の一部として移行しました。
MacBook AirへObsidianをインストールし、既存のVaultを開いて、最新のBuildやHEADなどがGitHub側の状態と整合していることを確認しています。
ここでも、新しい同名Vaultを作るのではなく、既存の情報を引き継ぐことを優先しました。
ソースコードだけでなく、「今どこまで進んでいて、次に何をするか」という記録も、開発環境の一部だと思っています。
11. 新しいMacだけでbuildとtestを実行
ファイルや設定がそろっていても、旧Mac依存が残っている可能性はあります。
そこでMacBook Airだけを使って、いくつかのプロジェクトでbuild、test、Simulator、署名などを確認しました。
対象にしたのは、ZMK Editorを含む複数のiOSプロジェクトです。
一部ではStoreKitやUI Testの環境依存エラーも出ました。
ただし、「テストが1件失敗したから移行失敗」と単純には判断していません。
その問題がMac mini時代にも存在していた既知のものなのか、それともMacBook Airへの移行によって新しく発生したものなのかを切り分けました。
たとえば、あるStoreKit Testでは、旧Macでも同じ認証関連のエラーが出ていたことを確認できました。
そのため、そのテスト自体は成功していなくても、Mac移行によって発生した不具合ではないと判断しています。
製品としてのリリース準備と、Mac移行が成功したかどうかは、別々に判断する必要がありました。
12. 古いバックアップも、すぐには削除しない
MacBook AirのDesktopには、以前に自動バックアップされていたと思われる、古いプロジェクトのコピーが残っていました。
容量は約1.7GBです。
いきなり削除するのではなく、古いXcode Archive、dSYM、IPA、テスト結果、ログ、成果物などを確認しました。
その中にしかない過去の証跡は、iCloud Driveへ別途保全しました。
チェックサムや内容を確認し、固有のデータが残っていない状態にしてから、古いDesktop上のリポジトリを削除しました。
「古いから削除」ではなく、必要な固有データが残っていないことを確認してから削除するというルールにしました。
13. Musicは内蔵SSDへコピーせず、外部ストレージをそのまま使う
Musicの移行は、開発環境とは別工程にしました。
音楽ファイル本体は外部ストレージ2に約200GBあります。
MacBook Airの内蔵SSDは512GBなので、これをそのままコピーするとかなりの容量を使います。
そこで、以下の構成にしました。
MacBook Air内蔵SSD
└── Music Library.musiclibrary
外部ストレージ2
└── 約200GBのMusicファイルMusic LibraryのデータベースだけをMacBook Airへ移し、音楽ファイル本体は外部ストレージ2を差し替えて使う形です。
これなら内蔵SSDを圧迫せず、今までの音楽データもそのまま使えます。
14. Music Libraryに残った古い参照は、今回の移行と切り分け
MusicやiTunesのLibraryを確認すると、現在のライブラリ以外にも古いライブラリファイル、XML、Album Artwork、過去のメディアパスなどがかなり残っていました。
さらに、過去のユーザー名や古い外付けディスク名を指す参照も多く残っていました。
最初は「これを全部直さないと移行できないのでは」と思いました。
ただ、調べていくと、古いライブラリ記録が残っていることと、Mac miniにしか存在しない音楽ファイルがあることは別の問題だと分かりました。
実際に確認すると、Mac mini内蔵にしかない音楽ファイルはありませんでした。
そのため、大量の古い参照は今回のMac移行を止める問題ではなく、将来のMusic Library整理として切り離しました。
ここも、すべてを一度に解決しようとしない方がよいと感じた部分です。
15. 最後に旧Mac全体をもう一度監査
Mac miniを初期化する直前に、もう一度以下を確認しました。
Gitリポジトリ
worktree
stash
Xcode Archive
テスト結果
Git管理外の成果物
scratchファイル
試作データ
Music
証明書や秘密情報
必要性をすぐに判断しづらい小容量のファイルや過去の証跡は、無理に削除可否を決めず、アーカイブとSHA-256で保全しました。
最終的には、Mac miniにしかない開発データ、Mac miniにしかない音楽データの両方が残っていないことを確認できました。
16. 「移行完了」と「旧Macを消してよい」は別
今回、特に意識したのはこれです。
データ移行が完了したからといって、すぐに旧Macを初期化してよいわけではない。
最後に以下を確認しました。
Apple Accountの状態
Find My Mac
Activation Lock
FileVault
外部ストレージが取り外されていること
MacBook Airだけで開発環境が独立していること
初期化の手順を確認していること
そのうえで、Mac miniの初期化は、Apple Silicon Macの標準機能である「すべてのコンテンツと設定を消去」を使う方針にしました。
Recovery Modeから手動でディスクを消す方法は、標準機能が使えない場合の予備手段として考えています。
17. 今後のデータ配置を決定
今回の経験から、今後はデータの役割を以下のように分けることにしました。
保存先主な役割GitHubsource code、Git history、正式なプロジェクトの基準点Mac内蔵SSDの~/Developer現在作業中のリポジトリObsidianCurrent Status、Roadmap、Build Closureなどの開発記録iCloud Drive秘密情報を含まないArchive、テスト結果、過去の証跡暗号化した外部ストレージ1Apple証明書、秘密鍵、App Store Connect APIキーなどの復旧用バックアップ外部ストレージ2大容量のMusicファイルHomebrewやnpmなどMacごとにコピーせず、新しいMacで再インストール
この構成なら、次にMacを買い替えるとき、旧Macの~/Libraryを丸ごとコピーしなくても、必要な環境を復元しやすくなります。
18. 今回一番大きかった学び
今回の移行で一番大きかったのは、「コピーできた」ことを移行完了にしないという考え方でした。
ファイルをコピーしただけでは、以下は分かりません。
GitHubに入っていない作業途中データがないか
秘密鍵が本当に使えるか
Archiveが壊れていないか
新しいMacでbuildできるか
Musicが本当に再生できるか
旧Macにしかないデータが残っていないか
そこで今回は、以下の順番で進めました。
Audit
↓
Preserve
↓
Copy
↓
Hash
↓
Read-back
↓
Restore / Build / Test
↓
Old Mac Unique Data Audit最終的な基準は、これです。
旧Macが明日なくなっても、新しいMacとバックアップから必要なものを復旧できるか。
これを満たして初めて、「完全移行」と言えるのだと思います。
19. 次回はワンタッチ化したい
今回かなり多くの確認を行ったため、次にMacを買い替えるときも同じことを手作業でやるのは大変です。
そこで今は、この経験をもとに、仮称「MacMigrationAssistant」という移行監査ツールを作れないか考えています。
理想は、mac-migrate のようなコマンド1つで、以下を確認できる状態です。
リポジトリ監査
dirty状態や作業途中データの検出
重複リポジトリの検出
worktreeやstashの確認
GitHubへの保存状況の確認
Git管理外の成果物探索
SHA-256付きの保全一覧作成
署名環境の準備状況確認
実際に作るかはまだ分かりません。
ただ、今回の移行で「次回も同じ確認をするなら、少しでも自動化したい」と感じました。
Mac miniからMacBook Airへ移ったことで、メモリに少し余裕ができ、作業場所も選べるようになりました。
そして、単にMacを買い替えただけではなく、開発環境やデータ保全の考え方も少し整理できた気がしています。