[非エンジニア向け] Fabric（Crashlytics beta）でアプリをインストールするためのマニュアル

## 目的

非エンジニアがFabric（Crashlytics beta）により配信されたアプリを利用するためのマニュアルです。

ぼくが現在関わっているプロジェクト向けにマニュアルを作成する必要があったのですが、せっかくですのでこちらに共有させていただきます。

エンジニアの場合は事細かに説明しなくても自分で解決してくれることが多いですが、非エンジニアにインストールをお願いする場合は、予想外のところで止まってしまうこともありますので、実際のスクリーンショットを元に事細かな手順を記載しています。

また、実際にこの手順に従ってインストールしてもらい、トラブルが発生した場合は [トラブルシューティング](#トラブルシューティング) にその内容を追記していきます。

### 前提条件

以下、EnterpriseアカウントによるInHouseな配信を前提とし、UDIDの登録周りについては言及しません。

本記事には2016/5/6時点のFabric及びiOS9.3のスクリーンショットを添付しています。

## はじめに 招待メール or URL共有?

管理者から事前にメールアドレスを聞かれて招待メールを送られた場合は [メールは届いていますか？](#メールは届いていますか) までスキップしてください。

もしくは、管理者からURLを連絡された場合はこの後の [URLを共有された場合](#urlを共有された場合) から順にお読みください。

## URLを共有された場合

管理者から共有されたURLをiPhone/iPadのSafariで開くと、

![beta_url.png](https://qiita-image-store.s3.amazonaws.com/0/7883/82a89032-28fe-8c3a-87a7-d554f50f72d8.png)

このページが表示されます。このページで、

- `Email address` の欄にあなたのメールアドレスを入力（今後、このアドレスにバージョンアップの通知が送られます）
- `Sign Up`ボタンをタップ

してください。

少し待つと、入力したメールアドレスに招待メールが届くはずです。

## メールは届いていますか？

![invitation_mail.png](https://qiita-image-store.s3.amazonaws.com/0/7883/af33364a-6f09-2993-ee59-3938c5568921.png)

管理者 or 前項のURLから招待メールが送られた場合、上記のように ``You`ve been invited to test XXX`` もしくは `Confirm your email to test XXX` というメールが届いているはずです。

メールが見つからない場合は迷惑メールフォルダなどもご確認のうえ、管理者にお問い合わせください。

メールが届いている場合、`Let Me In` ボタンをタップしてください。

### よくあるトラブル

ここで `Safari is required` `PRESS & HOLD TO COPY URL` などと表示されて先に進めない場合は [コチラ](#リンクはsafariで開かないといけない) をご参照ください。

## 名前の入力

![enter_your_name.png](https://qiita-image-store.s3.amazonaws.com/0/7883/1c975b3c-b453-f4a8-dc77-3326e4cc6375.png)

すると、上記の名前の入力をする画面が表示されますので、

- `Enter your name...` 欄に名前を入力（ニックネームなどで構いません）
- `Next` ボタンをタップ

してください。

## インストール

![install.png](https://qiita-image-store.s3.amazonaws.com/0/7883/bb5492da-29e4-bece-c979-7f9daaa07770.png)

すると、上記のようなアプリのインストール画面が表示されますので、無事に `Install` ボタンからアプリのインストールができるようになりました！
２回目以降はこのボタンを押すだけで良いのですが、初回のみ、もう少し雑務が残っています。

### よくあるトラブル

ここで `Download problem detected :(` などと表示されて先に進めない場合は [コチラ](#download-problem-detected) をご参照ください。

## （初回のみ）プロファイルのインストール

`Install` ボタンをタップして少し待つと、

![cert_install.png](https://qiita-image-store.s3.amazonaws.com/0/7883/c6e63974-431b-5ed2-69e4-a52eeeca5b05.png)

と表示されますので、 `Next`で次に進んでください。

![profile_install.png](https://qiita-image-store.s3.amazonaws.com/0/7883/bf928b65-3270-b4a7-0300-fa4da2e19d32.png)

以降、 `インストール` > `インストール` > `完了` > `Next` と順に進めていただくだけで大丈夫です。

この後、インストール画面に戻りますので、`Install`ボタンからインストールしてください。

## インストール確認

プロファイルがインストール済みの場合、`Install` ボタンをタップすると、

![confirm_to_install.png](https://qiita-image-store.s3.amazonaws.com/0/7883/60c29ab1-b8d9-57c5-ed62-969462478070.png)

と確認ダイアログが表示されますので、 `インストール` を選んでください。

この後、しばらく待つとホーム画面にインストールされたアプリのアイコンが表示されているはずです。

## インストールされたアプリアイコンをタップ

インストールされたアプリアイコンをタップすると、もしかすると何事もなくアプリが起動するかもしれませんが、人によっては（iOSのバージョンが9.0以降の場合）、

![developer.png](https://qiita-image-store.s3.amazonaws.com/0/7883/ba666928-ac4f-49c9-4f1e-b58e14404fb1.png)

と表示される場合があります。その場合は次の [開発元の信頼](#開発元の信頼) をご参照ください。

## 開発元の信頼

開発元を信頼設定するには、

![confirm_dev.png](https://qiita-image-store.s3.amazonaws.com/0/7883/1e945874-7ecd-29cd-78b6-9b8ec55dcd69.png)

iPhoneの設定から `一般` > `プロファイルとデバイス管理` > `エンタープライズAPP`の承認したい開発元XXX > `XXXを信頼` と順に選択してください。

この設定が完了すると、以降は問題なくアプリが起動するはずです。

## バージョンアップしたアプリのインストール（次回から）

以降は、アプリがバージョンアップされるとメールで通知されるようになりますので、そのメールからアプリのバージョンアップが可能です。

もしくは、ホーム画面に、

![beta.png](https://qiita-image-store.s3.amazonaws.com/0/7883/fcecfa1a-a4fb-f003-4f8d-7d73dfe7682c.png)

`Beta`という歯車マークのアイコンが追加されていますので、これをタップしてインストール可能なアプリのリストをいつでも確認可能です。

## トラブルシューティング

### リンクはSafariで開かないといけない

よくある例としてiPhone標準のメールアプリでなくGmailなどを使っている場合、Crashlyticsからのメールのリンク（ボタン）をタップした時にSafariでなくChromeなどで開いてしまうことがあります。

![13148330_10208393686573836_664207493_o.jpg](https://qiita-image-store.s3.amazonaws.com/0/7883/06884563-d200-f333-e84c-dc7b8d3a2d84.jpeg "13148330_10208393686573836_664207493_o.jpg")

その場合、上記のように英語で「Safariで開く必要があります。URLをコピーしてSafariで開いてください。」というメッセージが表示されていると思いますので、その通り、同じURLをSafariで開いてみてください。

### Download problem detected

![problem_detected.png](https://qiita-image-store.s3.amazonaws.com/0/7883/2db5af16-6040-5ce8-c2d3-6984de4917d1.png "problem_detected.png")

Installボタンを押した後、`Download problem detected :(` というメッセージが表示され、インストールに失敗することがあります。

このエラーが出る理由として、

- アップロードされているアプリ自体が悪い場合
- 古いアプリが邪魔してインストールできない場合
- Fabric（Crashlytics beta）の調子が悪い場合

の３種があります。そのため、

- 他からインストールした同名の古いアプリがある場合は、それを削除する
- しばらく待ってからリトライする

を試して、それでもうまくいかない場合は、上記を試しても `Download problem detected :(` が出る旨を管理者にお問い合わせください。

## それでもうまくいかない場合

トラブルシューティングを参照してもインストールがうまくいかない場合、管理者にお問い合わせください。
（うまくいかない画面のスクリーンショットを添付すると解決が早くなることがあります）