MOTO+4 Applocations のブログ

前記事でiOS用アプリパッケージ：.ipaファイルを iPhone にインストールしるため、Windows版iTunes をインストールしました。 引続き.ipaファイルを iPhone へインストールしていきます。

０． iPhone側を、デベロッパーモードに切り替えます。「設定」→「プライバシーとセキュリティ」を開き、一番したまでスクロールし、「デベロッパーモード」開きます。デベロッパーモード画面から「デベロッパーモード」をON( 右にスワイプ )します。iPhone再起動が求められるのでOKします。再起動後、「本当にデベロッパーモードしますか」にOKで応答します。当モードがOFFでもインストール自体は可能ですが、アプリ実行時に必要です。

１． iTunesを起動します。

２．iPhone をUSBケーブルでPCに接続します。

３．以下のよう App メニューを有効にします。

４．以下のようにモードを「App」に切替え、「iPhone App」を選択し、.ipaファイルをドラックします。

５．以下のようにインストールを指定します。「インストール」ボタンが「インストールする」に切替わります。

６．画面右端に、インストール後のホーム画面の状態が表示されます。「適用」を押すとインストールが開始されます。この時、iPhone側でパスコードの入力を求められるので、それを入力します。

【補足】iPhone側のアイコンの並びと非表示状態がデフォルトに戻ってしまいます。これはAppleの仕様の模様(バグ？)です。

７．インストール中は以下の表示になります。

８．インストール後、以下のように「インストールする」ボタンが「削除」に切り替わります。

説明は以上です。うまくいきましたでしょうか? 後は iPhone 側でアプリを実行します。iPhone はデベロッパーモードのままである必要があります。

アンインストール手順は以下のとおりです。この時は iPhone側はデベロッパーモードである必要があります。デベロッパーモードOFFでも受付けされますが、さりげなくスルーされます。

.ipa(iOS用アプリのパッケージ、作成方法はこちら)を、アプリのテスト用に、MAC Book無でiPhoneにインストールするための手順です。色々なサイトで解説されていますが、投稿時期によって違いがあるようです。2023.11月の状態としまとめなおしました。

0. 前提条件

今回の説明の条件は以下のとおりです。

PC	Windows11 Pro 64bot	概ねWindows10 64bit でも同様と思います
iPhone	iPhone 8 / iOS 16.7.1	デベロッパーモードON

１．Windows PCの確認

iTunes の当作業の対象バージョンインストーラは、32bit OS と 64 bit OS を厳格にチェックします。64 bit OSで、32 bit用インストーラを実行すると以下のメッセージが表示されます。

PCにインストールされているWindowsが 32bit か 64bit か確認します。尚、本投稿では現在主流である64bit Windows で説明していきます。

２．Windows版iTunesの入手

入手が必要な iTunes のバージョンは 12.6.x.x です。他同件の投稿では「12.7以前はOK」「12.7以降はNG」という記述がありますが、後者が正しい情報です。加えて古すぎるバージョンもNGです。Apple公式で公開されている 12.4.3.1 では、iPhone接続時にエラーとなってしまいます。(以下メッセージ中の「12.7以降」の記述は当作業においては対象外の模様です)

Windows用iTunes バージョン 12.6.x.x は、現在Apple公式ダウンロードページからは削除されています。よって有志ダウンロードページから入手することになります。やや怪しいので機密情報のないPCでダウンロードすることをお勧めします。仮想OSでダウンロードし、ダウンロード後ロールバックするのも良いでしょう。インストーラそのもの改ざんは困難なのでその安全性は問題ないと思います。

3．インストール済みiTunesの削除

PCに他バージョンの iTunes がインストール済みの場合、いろいろとエラーが出ます。以下のようにアンインストールします。

① Windowsの「設定」→「 アプリ」→「 インストールされているアプリ」 から以下のアプリをアンインストールします。なお 「コントロールパネル」→「プログラムと機能」からは正しくアンインストールできないようです。

② 以下左図のフォルダを、削除する(名称変更でもOK)します。削除しない場合は、以下右図のメッセージが表示されます。

4．iTunes 12.6.x.x のインストール

iTunes64Setup.exe を以下のように実行します。実行ファイル名は、インストーラの入手方法によって異なる場合がありますので、適宜に読替えてください。

初回起動時は、Microsoft Store のモードで立ち上がります。下にスクロールして「Microsoft Store以外からのインストールを続行する」をクリックして、一旦、終了します。

もう一度以下左図のように iTunes64Setup.exe を起動します。Windowsからの「実行を許可しますか」のメッセージに「許可」で応答すると、インストーラの起動が始まります。以下右図の画面が表示されます。「次へ」をクリックします。

後はインストーラのガイダンスに従いインストールを進めます。下右図に到達したら「完了」を押します。

ライセンス許諾が表示れるので、その内容を読んで「同意する」を押します。その後、お知らせに「OK」で応答します。

ここでようやく iTunes が起動します。念のため メニュー「ヘルプ(H)」→ 「バージョン情報(A)」を選択し、バージョンが 12.6.x.x か確認します。バージョンがエンドロールのように流れるのがAppleらしい(いい意味で何の役に持たない演出) ですね。

以下のメッセージが表示された場合は、「キャンセル」もしくは「いいえ」で進めます。

さらに自動Updateを避けるため、メニュー「編集(E)」→ 「環境設定(F)」を選択し、「詳細」タブを選び、「新しいソフトウェア更新 . . .」のチェックを外しておきます。

次に、iPhoneと接続確認をします。iPhoneを USB(ライトニング ケーブル で接続します。以下メッセージ(以下左図)が表示されるので「OK」で進み、同時に、iPhone側に「このコンピュータを信頼しますか」とメッセージ(以下右図)が表示されるので「許可」で応答します。

メニューのiPhoneアイコンを選択し、以下のような表示となればOKです。

しかし iPhone X を接続すると以下のメッセージが表示されました。

取り急ぎ 12.6.3.6 を用いましたが、 iTunes 12.6.x.x の最終 12.6.5.3 のインストーラを入手し、アップデートしてみます。そうすると iTunes は iPhone X と接続できました。

iPhone Xの発売時期は2017年9月、iTunes 12.6.3.6 のリリースは2017年9月22日。もしかすると iTunes リリース以降に発売された機種には対応していないのかもしれません。 Apple公式情報では取り立てそのような説明はないのですが、、、

もしそのとおりなら iPhone 11、13、14 は、iTunes でのインストールは出来ない可能性が考えられます。上記エラーが12.6.3.6 のみの問題であることを祈ります。

Visual Studio For MACにて、iOSアプリのテスト配布用にAd Hoc用.ipaファイルを作成する手順は、Microsoftのオンラインヘルプに記載されていますが、Apple Developer ページとVisual Studioのキャプチャや説明が古く、説明の足りずよく分かりません。そこで2023.11月編としてまとめなおしました。

０．システムフロー

Apple や Windows のこの手の仕組みの説明は、システムフロー的なものが無いからでは? まず全体像をこんな感じまとめてみました。

注意点はBuildするMAC毎に証明書が異なる点です。これは別記事にて解説いたします。

１．前提条件

今回の説明の条件は以下のとおりです。Apple Developerへの加入も必須です。

MAC book	2015 early	MAC OS 12.6.5
Visual Studio 2019 for MAC	8.10.25 build2
Xcode	14.1
iPhone	iPhone 8 / iOS 16.7.1	デベロッパーモードON

Apple Developerページにて、アプリ名とID( バンドルID )の登録も済ませておきます。

２．証明書の作成

Apple Developerページのトップページにて、一番下にスクロールし、「Certificates, IDs, & Profiles（英語）」を選択します。

「Certificates」を選択し、「+」をクリックします。

「iOS Distribution (App Store and Ad Hoc)」を選択します。(左下図、もしかすると Apple Distribution の方かも) 証明書要求ファイル を選択ページに移ります。(右下図)

証明書要求ファイルは、MAC Bookの「キーチェーンアクセスツール」で以下のように作成します。拡張子は、.certSigningRequest です。

証明書要求ファイルにローカルディスクに保存後(左下図)、ブラウザ上のApple Developerページに戻り 、「Choose file」を選択し、証明書要求ファイルを選択します。(右下図)

Apple Developerページに証明書要求ファイルがUploadされたら「Continue」を押します。(左下図) 右下図のページに移れば証明書ができました。証明書ファイル(.cer) は、Visual Studio側が自動ダウンロードするため 、 当ページでダウンロードは不要です。

「Certificates, IDs, & Profiles」のトップページに戻り、「Certificates」を選択すると生成された証明書が確認できます。

注意事項: MAC上でFirefoxを使った場合、一回目のログインは成功しますが、二回目はスルーされログイン画面に戻り続ける事象が発生しました。MAC上では safari を使用した方がよさそうです。Windows上なら Edge / Firefox でも大丈夫でした。(‘24.7月追記)

４．アプリ定義の変更

アプリの設定 「Identifiers」は以下のように「App Attest」に変更します。

３．プロビジョニング プロファイルの作成

「プロビジョニング プロファイル」とは何か難しそうでに取っつきにくい感じですが、「アプリ、証明書、テスト端末を紐付けたもの」といったニュアンスかと思います。これが Visual Studio に読ませるのもになります。「Certificates, IDs, & Profiles」のトップページに戻り、「Profile」を選択します。(左下図) する。次に「Ad Hoc」を選択し、「Continue」をクリックします。(右下図)

次に「APP ID」に登録しているアプリのプルダウンメニューにリスト表示されるので、対象のアプリを選択し、「Continue」をクリックします。(下図) 「Offline support」はよくわかりません。デフォルト「No」のままで進めてみます。

次に「Select Certificates」エリアに生成した証明書がリストされるます。その中から「Distribution」の方を選択し、「Continue」をクリックします。(下図) 「iOS Distribution」の方かと思いきや、こちらを選択すると Visual Studio側の iOS のプロジェクトオプション「ビルト」->「iOSバンドル署名」->「プロビジョニング プロファイル」にて、「プロビジョニング プロファイルが見つかりません」と表示され、同ファイルの選択ができませんでした。

次に「Select Devices」エリアに、Apple Developerアカウントに紐づけられた iPhone がリストされます。なおこのページはTestFlight時には表示されません。「Select All」か 「XXXのiPhone」「iPhone (XXX)」 それぞれを選択し、「Continue」をクリックします。(下図) Apple Developerアカウントと iPhone の紐付けは、正式なApple Developerページで行うようですが、Xcode で iPhone に一度接続すると自動で登録されるようです。

次に「Provisioning Profile Name」の欄に名称を指定し、「Generate」をクリックします。(左下図) プロビジョニング プロファイルが生成され、右下図のページに移ります。 生成されたプはVisual Studio (Xamarin)内でダウンロードされるため、このページで「Download」の操作は不要です。

５．IPAファイルの作成

操作を Visual Studio For Mac に移します。メニューバー「Visual Studio」-> 「ユーザ設定」-> 「発行」-> 「Apple Developerのアカウント」を開きます。(ここではアカウントは追加済みであることを前提に説明します) 「証明書の表示」をクリックします。(下図)

次に「すべてのプロファイルのダウンロード」をクリックします。(下図) 「証明書」と「プロビジョニング プロファイル」一覧表に、追加した 証明書 と プロビジョニング プロファイル が表示されます。

ユーザ設定の画面を閉じて、左側のツリーからiOSプロジェクトを開き、info.plist をダブルクリックして開きます。プロパティ「ハンドル識別子」の値の欄に、Apple Developerページで割当てた APP ID を指定します。

info.plist のウインドウの下端から、「アプリケーション」のタブを開き、インストール後のアイコンを指定します。これ指定しないとビルドエラーになってしまいます。png形式で「1x」の方は 512 x 512 dot、「2x」の方は 1024 x 1024 dot を割当てます。お試しで弊方は大きな✖としています。そしてinfo.plist を閉じます。

次に、左側のツリーからiOSプロジェクトを選択し、メニューバー「プロジェクト」->「オプション」を選択します。オプション画面から「ビルド」->「iOSハンドル署名」を開きます。「署名ID：」から「配布(自動)」を選び、「プロビジョニング プロファイル：」にて「アドホック(自動)」を選択し、「OK」を押します。

【補足】MicrosofrのXmarinの公式ドキュメントには、 「Ad Hoc」という ビルド構成 が掲載されていますが、古い Visual Studio の仕様のようです。2019では「Debug」構成のまま内容を Ad Hoc に設定し直しました。「Ad Hoc」で ビルド構成 を追加しても、ビルド時に指定できませんでした。

次にオプション画面から「ビルド」->「iOS IPAオプション」を開きます。「iTunes Package Active (IPA)をビルドする」にチェックを入れて「OK」を押します。

次にメニューバー「プロジェクト」->「スタートアップ プロジェクトの設定」を選択し(次図)、iOSをデフォルトのビルト構成に設定します。(次々図)

次にメニューバー「プロジェクト」->「ビルド」-> 「公開のためアーカイブ」を選択します。(次図)

ビルドが完了するとアーカイブのウインドウが開きます。「署名と配布」を押します。

後は下図のように順当に選択していきます。

ファインダーでファイルを確認します。ファイル種「iOSパッケージアーカイブ」となっていますね。

６．iOSに持って行ってみる

IPAファイルのインストール方法は色々あるようですが、Android や Windows 的な発想であれば、これを実機上にコピーすればインストールできるはず？？？

試しに .ipa ファイルを iPhone に転送して開いてみます。

ipaの形式もapkと同じくzipらしいので、リネームして解凍してみます。

.app ファイルがでてきました。これを開いみると、、、

なんとiOS自体はインストール機能を持っていない！？ ipa用にiTunesをセットアップに続きます。

先刻の開発アプリでネット接続中に接続していないという事象が発生するのか継続調査です。

AppleIDに対するインストールのパターンは以下が考えられます。

a．AppleIDが、Apple Developerを割当てたAppleIDと同じiPhoneへのインストール。

b．AppleIDが、AppleIDを未割当てiPhoneへのインストール。

c． AppleIDが、Apple Developerを割当てたAppleID以外のiPhoneへのインストール。

上記c．は試していませんでした。厳格なApple的には弾かれそうな予感がします。試してみました。

１．iPhoneの初期化

過去のインストールやAppleIDに影響を受ける可能性があるため、一度iPhoneを初期化&最新化します。

2．AppleIDの追加作成

会社用開発用とは別に、個人用にニックネームでAppleIDを作成しました。Apple機器一つに対して一つ作っていいようです。TELの割当ては自宅固定電話を割当てました。固定電話でも音声対応でAppleIDに使えるようです。

3．XcodeでのiPhoneの認識

とくに問題なく認識します。

4．Xcodeでの開発アプリのインストール

問題なくインストールでき、開発用アプリは起動できました。

以上、予想に反した結果となりました。先刻の事象の原因はわからずじまいです。