Xcode OrganizerによるTestFlightクラッシュのトリアージ

Xcode OrganizerによるTestFlightクラッシュのトリアージ

Xcode Organizerを使用して、クラッシュのトリアージと修正をより簡単かつ迅速に行う方法を確認しましょう。クラッシュの発生直後に、クラッシュの情報やTestFlightテスターからのフィードバックにアクセスする方法を探ります。また、クラッシュを分析し、メトリクスを表示し、さらにチーム間でクラッシュ情報を共有する方法を紹介します。クラッシュログの入門編として、WWDC18の「クラッシュとクラッシュログについて理解する」をご確認いただくことをお勧めします。

リソース
- Diagnosing issues using crash reports and device logs
- - HDビデオ
  - SDビデオ
関連ビデオ

Tech Talks
- TestFlightの概要
WWDC21
- 究極のAppパフォーマンスサバイバルガイド
- Appのパワーとパフォーマンスに関する不具合の診断
WWDC20
- MetricKitの新機能
WWDC18
- クラッシュとクラッシュログについて理解する
ダウンロード

こんにちは "Xcode Organizerにおける TestFlightクラッシュのトリアージ" へようこそ Xcodeエンジニアのマットと申しますこのセッションでお見せするのはすべてのAppターゲットのクラッシュをトリアージするのに役立つ Xcode Organizerに搭載された新しいツールの一部と TestFlightユーザーからのフィードバックを活用してクラッシュ修正をより早く反映させる方法です
そして新しい Terminations Organizerと MetricKitの進化をご紹介します
あなたのAppがベータ版のテストに TestFlightを活用していればテスターからのクラッシュフィードバックが非常に貴重であることをご存知でしょうテスターがクラッシュを起こした後フィードバックを書いた場合 App Store Connectでそのフィードバックを確認したりクラッシュログをダウンロードし何が起こったかの分析できます後ほどこのワークフローを超高速化するために Xcodeで行った変更を紹介します
まず Xcode 13以前の機能を簡単にご紹介します
Crashes Organizerでは App StoreのAppと TestFlightの両方のクラッシュをサポートしていますクラッシュはApp Clipや App Extensionを含めすべてのプラットフォームで表示されます
Organizerは問題をランク付けして優先度の高いクラッシュを表示しそれらのクラッシュが異なるデバイスやOSバージョンにどのように分布しているかを示しますそしてクラッシュを修正することに決めたら Xcodeプロジェクトで直接開くことができますこれらの優れた機能は開発者アカウントで Xcodeにサインインするだけですぐに利用できます良いAppを作るための旅は長く険しいものですというのも一度公開するとユーザーは開発者が想像もしなかった方法で Appをクラッシュさせるからです Xcode 13ではクラッシュを起こさないという目標に近づくため Crashes Organizerをさらに改良しましたこれによりクラッシュログの配信をほぼ瞬時に行いクラッシュに関するより豊富なデータを提供予想外の問題の解決に役立つ情報を提供するという使命を果たすことができました Xcode 13に追加された Crashes Organizerの素晴らしい新機能を皆さんにお見せできることを嬉しく思います皆さんに大きく分けて 6つの改良をお見せします 1つ目はTestFlightのクラッシュを即発見しますテスターがTestFlightのビルドをクラッシュさせた場合直後にオーガナイザーでそのクラッシュを発見することができますこのquick crash deliveryでは過去1日に発生した TestFlightのクラッシュをすべて表示可能になりました選択したクラッシュがいつ発生したかを示す 1時間ごとのグラフも表示されます Xcode 13では 1年分のクラッシュ履歴が利用可能になりました
過去1年間に発生したすべてのクラッシュを確認するため期間別のフィルタリングも可能です 1年分のクラッシュが表示可能になりインスペクタのグラフエリアには月ごとのクラッシュ発生率を示す時間分布が表示されます私たちはAppの状態を隅々まで把握するためのツールを提供したいと考えましたそこで今年はCrashes Organizerにフィルタを追加 Appの特定の部分にフォーカス可能になりました
クラッシュリスト全バージョンとビルドでのフィルタリングや過去のリリースを個別にドリルダウンも可能になりましたまたWatch Appや Share Extensionなど Appに同梱されている Extensionでフィルタリングも可能です Apple Silicon Mac上であなたのiOS Appの動作確認も可能です Appの問題をトリアージするためには特定のクラッシュの影響を受けるのは何かクラッシュはさまざまなカテゴリに分散しているかなどの全体像の把握が必要です
そこで今年はクラッシュが Appのバージョン間 TestFlightとApp Store間でどのように分布しているかを確認できる機能を追加しました皆さんは一人であるいは大きなチームであるいはその中間で Appを発表してきました Xcode 13ではOrganizerから直接クラッシュレポートを共有できる機能を追加しコラボレーションのための新しい方法を導入していますツールバーの新しい共有ボタンを使えばチームのメンバーと直接クラッシュを共有したり単にToDoリストに追加することができます
これらのリンクをクリックすると Organizerが問題をダウンロードしこのクラッシュにゼロインし調査を開始します TestFlightは開発者が新機能や修正プログラムを迅速にテスターの手に渡し新たなクラッシュやバグの発見に役立ててもらうための貴重なツールです TestFlightでAppをベータテストすることで開発者はApp Storeに自信持ってアップデートを配信できます Xcode 13では TestFlightのクラッシュフィードバックを Crashes Organizerに直接取り込むことができるようになりました
App Store Connectではフィードバックを含む TestFlightの全フィードバックが表示されますフィードバックやクラッシュログは引き続きApp Store Connectから直接ダウンロード可能また今年は新たに Open in Xcodeボタンが追加され関連するクラッシュを Organizerで確認できます
クラッシュフィードバックの閲覧がより簡単になり Crashes OrganizerにTestFlightのフィードバック専用の新しいインスペクタを追加インスペクタを開くと選択したクラッシュを実行したテスターから寄せられたフィードバックがすべて表示されますこれによりクラッシュレポートと共に統一されたフィードバックリストが表示されクラッシュを修正するために必要な情報をすぐに探し出すことができます予想外の問題を解決するためにはこのような情報が必要だと考えています必ず役に立つでしょう早速新しい Crashes Organizerでクラッシュのトリアージをしてみましょう
私はFrutaという名前のチームAppを開発中です最近新バージョンを App Storeにアップしましたが Xcode Cloudを使って TestFlightにも継続的に新バージョンをデプロイしています今日はApp Clipで最近クラッシュがあったか否か確認したいので Organizerを開いて何が起こっているのかを見てみましょうメニューバーのウィンドウを選択しオーガナイザを選択します
左側のサイドバーで Xcodeが私のiOS App Frutaの Crashes Organizerを開いたことがわかりますウィンドウ上部のツールバーには今年新たに加わったフィルタオプションがすべて表示されていますフィルタバーの下にはクラッシュリストがありバージョンビルド製品を問わず過去2週間のすべてのクラッシュが表示されますこのリストをざっと見るとさまざまな種類の問題があることがわかりますリストに表示されるクラッシュは App Clipから来たのか Watch AppからかそれともExtensionからかを示すバッジが表示されます
これによりクラッシュが Appのどの領域に影響しているかを迅速に特定することができます
リストの右側にはログビューが表示されますこれはリストで選択したクラッシュのシンプルな確認ビューを表示します最後にログビューの右側にはインスペクタがあり選択したクラッシュに関する様々な興味深い情報が表示されています Organizerに慣れたところで App Clipの最近の問題点をすべて見ていきたいと思いますツールバーの製品フィルタを開くと Watch App App Clip App Extensionなど同梱されているすべての製品が一覧表示されますここでApp Clipを選択してみます
App Clipを選択するとクラッシュリストがフィルタリングされ過去2週間に発生した App Clipのクラッシュのみが表示されますリストの最初のクラッシュがトップクラッシュですこのクラッシュが過去2週間で21台 1日で7台のデバイスに影響を及ぼしていることを Organizerがレポートしていますコードを調べ始める前に調査の指針となるような質問を自分に投げかけ文脈の手がかりを得るようにしていますまず問題がどの程度の期間起きているのかウィンドウの右側にあるインスペクタのグラフ領域に移動するとグラフの凡例からこのクラッシュがバージョン2.0で初めて発生し最新のTestFlight ビルド2.0.1に影響を与えていることがわかります次の質問ですがこれは実際Appに影響するのかそれともTestFlightだけに影響するのでしょうかフィルタを Release に変更すると TestFlight と App Store ビルドの両方に影響があることがわかりますこの問題は非常に重要ですなぜならユーザーがこの問題を経験しており最新のApp Storeリリースに影響しているからです
次はログビューに焦点を当てますログビューではクラッシュの正確なフレームがハイライトされるので便利ですまたバックトレースの上にあるスレッド番号を見てバックグラウンドのスレッドで起こったことがわかります
お気に入りの同期中にクラッシュしているのはわかりますが私が頻繁に扱うコード領域ではないので再現方法がよくわかりませんこのクラッシュについての疑問がこれ以上思い浮かばないのでもう少し状況が分かると助かります幸いなことにリストのこのクラッシュの横にはフィードバックのアイコンがあるのでテスターの1人がこのクラッシュを経験してフィードバックを提出したことがわかりますこれがクラッシュ解決に必要な情報かもしれませんインスペクタエリアに移動して新しいフィードバックインスペクタを開くとフィードバックを見ることができます
数名同じクラッシュに遭遇しているようですがその中には1分前にアクセスした人もいます
インスペクタでは各フィードバックレポートのプレビューを見ることができレポートをクリックするとポップオーバーで詳細を見ることができますこの最新のフィードバックをクリックするとポップオーバーが表示されインストールしたバージョンビルドデバイスのモデルバッテリー残量使用可能なディスク容量などこのテスターのクラッシュに関する豊富な情報が表示されますこれらはすべてクラッシュを診断する際のヒントですこのケースではテスターがセルラー通信を使用していたことがわかりそのコメントには "トンネルを抜けお気に入りボタンを押し数秒後に-- クラッシュした"とありますトンネルを通ったのなら回線が悪かったことが想像できますこれらの情報があればお気に入りボタンを押したことが何らかの引き金となりクラッシュが起きたという背景が把握できますコードを読み解くのに十分な情報が得られたと思います Open in Projectボタンを使ってこのクラッシュを Fruta Xcodeプロジェクトで直接開くことにします
さてXcodeが開き左のDebug Navigatorにバックトレースが表示されエディタにソースファイルとクラッシュしたコードの正確な箇所がハイライトされていますなぜこのクラッシュが起きたんでしょうか？わざと決定的なエラーでクラッシュさせているように見えますがこれはこれで面白い選択だと思います syncFavorites関数が何をしようとしているのかを理解するために簡単に説明します
まずバックグラウンドのスレッドへアクセスし次にこのスムージーをお気に入りとしてディスクに保存しているように見えます次にバックエンドを更新しこの操作を同期させるため DispatchGroupを使用します
これらの操作を 10秒のタイムアウトで待ちそれ以上かかるとクラッシュしてしまいますこれは不親切ですねフェードバックを振り返るとトンネルを抜けてお気に入りを登録したらクラッシュしたとありましたトンネルを通っていたということはネットワークの質が悪かったのでしょうつまりバックエンドとの同期に10秒以上かかった可能性があるということですクラッシュの原因がはっきりしましたタイムアウトの時間が短すぎて適切に処理できないことがわかったのでこれを修正しましょう最近Combineのスキルの練習をしているのでそれを使って修正したいと思います
完璧ですそしてタイムアウトした場合 "現在は30秒修正済み" その処理をクラッシュではなく完了ハンドラを呼び出します Organizerに戻ってこの問題を解決したことにしましょうボスからのメッセージだ
ああクレイグのデモでクラッシュだありがたいことに彼は Organizerの新共有機能を使ってクレイグがヒットした正確なクラッシュを報告したので私が探し回る必要はありませんここをクリックすると Organizerはリンクに埋め込まれた単一のクラッシュに焦点を当てたビューを作成しますこのクラッシュは過去にもありました先日この件を修正し解決済みとしましたまた根本的な問題を思い出せるようにクラッシュに親しみやすい名前をつけました修正完了の報告をボスにします
Organizerの新しいフィルタを使って App Clipのクラッシュをトリアージする方法でしたインスペクタの新しい分布グラフの使い方や TestFlightのフィードバックを利用して再現が困難な問題を修正する方法などをご紹介しましたそれでは新しい Terminations Organizerと MetricKitの改良点をご紹介します新しい Terminations Organizer はユーザーに影響を与えている可能性のあるApp終了の傾向を表示します Crashes Organizerに表示されるクラッシュはプログラミングの失敗によるものですが Appのプロセスが終了する方法は他にもあります
終了は"起動時のタイミングアウト"や "システムのメモリ制限にかかった "などの理由で分類されます Appの終了イベントのこれらのカテゴリを以前のバージョンと比較してリグレッションを見つけることができます
これらの終了はバックグラウンドで発生するものもありますが場合によっては画面上に表示されている間に発生することもあります Terminations Organizerはその違いを理解することでそれらを解決するための計画を立てることができますリグレッションについて深く知りたい方は今年のセッション "究極のAppパフォーマンスサバイバルガイド" ターミネーションについて詳しく知りたい方は 2020年のセッション "Appが強制終了される理由"をチェックすることをお勧めします馴染みがない場合 Appleのフレームワークである MetricKitを使ってコード内のクラッシュログを収集することができます MetricKitをインポートするだけです MetricKit Managerのリスニングを開始します MetricKit Diagnostic Payloadsを受信したら crashDiagnostics プロパティを使用します
今年の新機能としてクラッシュ診断は従来の1日1回の集計・配信ではなく次回のApp起動時に配信されるようになったためより早くクラッシュログにアクセス可能になりましたまた嬉しいことにこの度macOSにも対応しました MetricKitの使い方については 2020年のセッション "MetricKitの新機能"がおすすめですクラッシュを追跡する方法は他にもたくさんあります接続されているデバイスのクラッシュにはデバイスウィンドウからアクセスできるほかデバイスから直接ログを共有することもできます XCTestはテスト実行時に発生したクラッシュを収集し Console Appを使って MacやSimulatorからクラッシュを確認することができますこれらの追加ツールについては2018年の "クラッシュとクラッシュログについて理解する"をご覧ください今日はいくつかの素晴らしい新機能を紹介しましたスピーディなクラッシュログを期待しています TestFlightのフィードバック統合配信メトリクスはクラッシュ修正を改善し最終的なAppの安定性とユーザーの体験を向上させますご覧いただきありがとうございました成功への道はそこにあることを忘れないでください [音楽]

//  Capture crash logs in your code

import MetricKit

class Subscriber: NSObject {
    override init() {
        super.init()
        MXMetricManager.shared.add(self)
    }
    
    deinit {
        MXMetricManager.shared.remove(self)
    }
}

extension Subscriber: MXMetricManagerSubscriber {
    func didReceive(_ payloads: [MXDiagnosticPayload]) {
        payloads.forEach {
            if let crashDiagnostics = $0.crashDiagnostics {
                // Begin analyzing crash diagnostic payload.      
            }
        }
    }
}

特定のトピックをお探しの場合は、上にトピックを入力すると、関連するトピックにすばやく移動できます。

クエリの送信中にエラーが発生しました。インターネット接続を確認して、もう一度お試しください。

リソース

関連ビデオ

Tech Talks

WWDC21

WWDC20

WWDC18