#はじめに
テスト業界が長い人なら一度は体験したことがあると思う。
###テスト端末にipaのインストールが出来ねぇ…
そうです。
Provisioning Profileに新しく購入した端末の「UDID」が登録されておらず、
アプリのインストールが蹴られてしまう恐怖の「アレ」です(´・ω・`)
※Provisioning ProfileへのUDID登録漏れというのもありますね...
開発に再ビルド依頼してもスグに対応してくれないし、
どうにかならないものか…と考えている人のために！
自力で新しいProvisioning Profileをipaへ再署名してインストールできるようにする！
というのを「Xcode無し・再ビルド無し」で実行する手順を書いてみたいと思います。
#準備するもの
- Mac ※1
- ipa ※2
- 新しい端末(UDID)が含まれているProvisioning Profile ※3
- Provisioning Profileに紐づく証明書(p12) ※4
※1 mac os10.12 以降
※2 ipaファイル名を「sample001.ipa」とします。
※3 新しく作成したProvisioning Profileを「new.mobileprovision」とします。
※4 証明書(p12)がキーチェーンに登録されていること。
証明書(p12)の名称を「Sample Co., Ltd.」とします。
#実行環境
#####macOS 10.15 Catalina
私は上記の環境にて実行しましたが、「macOS 10.12 Sierra」以降なら恐らく動作すると思います。
では、実際の手順を書いていきます！
#手順
####１． ipaファイルとProvisioning Profileを同一フォルダに格納する
####２． ターミナルを起動して手順1のフォルダをカレントディレクトリにする
ココまでは手順を書くまでも無いですね。
なんとなく誰でも出来ると思います。
では、次の手順から実際にターミナル上でコマンドを入力して再署名していきましょう。
####３． ipaファイル(sample001.ipa)を展開する
unzip sample001.ipa
ここではipaファイルを解凍・展開しているとでも思ってください。
これからやることは、ipaを解凍して新しいProvisioning Profileに差し替える！
ということをターミナルを使ってやっていきますので、まず最初にipaを解凍しております。
では、次の手順にいきましょう。
####４．「codesign」から署名時に必要な資格情報ファイルを作成する。
codesign --display --entitlements :- Payload/Sample001.app > entitlements.plist
急にややこしくなった雰囲気がしますが、簡単に説明するとここでは再署名時に必要となる、
「Entitlementsファイル」というものを作成しています。
このEntitlementsはiPA(アプリ)が出来るまでの工程でも、基本中の基本になります。
もっと詳しく知りたい！という方は、Apple公式のEntitlementsページを見てみましょう。
上記のページを見れば、どんなものがEntitlementsに設定できるのか理解できると思います。
####５． Provisioning Profileを更新する
cp -p new.mobileprovision Payload/Sample001.app/embedded.mobileprovision
「cp」コマンドを利用してProvisioning Profileを上書きしています。
「cp」コマンドは見たまんま「コピー」です(´・ω・`)
凄く簡単に書くと、「new.mobileprovision」を「Sample001.app」へ上書き(コピー)して！
というコマンドになっております。
これでipaに新しいProvisioning Profileが上書きされました
####６． 再署名を実施
codesign --force --sign 'iPhone Distribution: Sample Co., Ltd.' --entitlements entitlements.plist 'Payload/Sample001.app'
このコマンドを実行するとMacOSへのログインパスワードを求められます。
※これは再署名するために「キーチェーン」にアクセスしようとしているため入力を求められます
コマンドを実行し、MacOSへのログインパスワードを入力すると、
成功時は「replacing existing signature」という祝福の文字が表示されます。
表示されない場合は、残念ながら失敗しています(´・ω・`)
失敗してしまう！という方は下記の点をご確認ください。
■証明書(Sample Co., Ltd)がキーチェーンに登録されていない
→この手順で失敗した場合は、「'iPhone Distribution: Sample Co., Ltd.'」が
キーチェーンに登録されていない可能性が高いです。
※キーチェーンってなんですか？という方は、Google先生に聞くか誰かに聞いてください
ここまで来たらあと一歩！
####７． 新しいipaを作成する
zip -ry New.ipa Payload'
これが最後の手順です。
これまでの行った「Provisioning Profileの更新、再署名」したipaをZipで固めます。
このコマンドを実行したら、最初に古いipaと新しいProvisioning Profileを格納したフォルダに
「new.ipa」という新しいipaが新規に作られてると思います。
そのipaをインストールできなかった端末にインストールしてみてください。
きっと…インストール出来るようになってるはずです。
これで手順終了となります
#さいごに
・証明書(p12ファイル)
・Provisioning Profile
・キーチェーン
・Entitlements
本記事で記載した上記の4つについては、勝手に設定変更したり削除したりすると
アプリがインストール出来なくなるだけじゃなく、会社(もしくは個人)で所持している
証明書やProvisioning Profileが全て機能しなくなる可能性もあります。
そうなると、１から作り直し…なんてこともありますので、Provisioning Profileの更新は、
慣れるまで管理者の方と実行することをオススメします。
We are recruiting !
株式会社GENZではソフトウェアのテストサービス業務を行っています。
キャリア採用も行っておりますので、ご興味がある方は以下をご確認ください！
[株式会社GENZ - スマホアプリ検証]
(https://www.genz.jp/test-service-menu/mobile-testing/?qi=20210218)
[株式会社GENZ - 採用情報]
(https://www.genz.jp/recruit/?qirecruit=20210218)