手動確認はもう限界 〜XCUITestでCustom URL Schemeの遷移を起動種別ごとに自動テストする〜 / Testing Custom URL Schemes with XCUITest

iOSDC Japan 2026にて登壇した内容になります。
https://fortee.jp/iosdc-japan-2026/proposal/7d125d0b-f834-49c5-8431-11cf313be2ff
----------------------------------------------------------------

ー「Custom URL Schemeから起動すると正しい画面に遷移しない」ー
そんな不具合に遭遇したことはないでしょうか。

Custom URL Scheme（以下、URLスキーム）は、アプリの特定の画面へ遷移させるために利用されます。
弊社のアプリでも多くのURLスキームがあり、処理の追加や修正があると遷移を手動確認していました。
しかし、URLスキームの確認対象が増えるにつれて工数が膨らみ、確認漏れによる不具合も発生していました。
そこで、この課題を解決するためにXCUITestを利用し、URLスキームの遷移確認を自動化しました。

ただし、URLスキームのテストは単にURLを開くだけでは十分ではありません。
WWDCのセッションでも整理されているように、アプリにはCold Start・Warm Start・Resumeという異なる起動種別があり、呼び出される処理が異なります。
そのため、URLスキームの動作を網羅的にテストするには、起動種別を考慮したテスト設計が重要になります。
さらに、Resumeのテストは単純な方法では期待どおりに再現できず、試行錯誤が必要でした。

このトークで話すこと

本トークでは、混同しがちなアプリの起動種別を整理し、その違いを踏まえたURLスキームのテスト方法を紹介します。

・URLスキームのテストに手間がかかる理由
・アプリの起動種別（Cold Start / Warm Start / Resume）の違い
・起動種別を考慮したテスト設計
・XCUITestでURLスキームの動作を検証する方法
・Resumeを確認するために行った実装

URLスキームは一度実装すると長く利用される一方で、デグレが起きても気付きにくい機能です。
本トークを通じて、URLスキームのデグレを検知するテストの実装方法を知ることができます！

Transcript

1. ⼿動確認はもう限界 〜XCUITestでCustom URL Schemeの 遷移を起動種別ごとに⾃動テストする〜 Arata Goto / @otouto555 2026/09/13 iOSDC Japan 2026 1
2. ⾃⼰紹介 ・Arata Goto （@otouto555） ・株式会社レコチョク ・緊張してます 2
3. Custom URL Schemeとは アプリの特定画⾯へ遷移させるために 使われる仕組み 例: myapp://iosdc 3
4. Custom URL Schemeの確認って ⾯倒じゃないですか・・・︖
5. Custom URL Schemeの確認がつらい •確認を⼿動で⾏っていた •Safariで開く •メモ帳などにURLを貼ってタップする •アプリ内にデバッグ機能をつける •遷移できたかは⽬視で確認していた •Custom URL Schemeの数も 増えていきがち（弊社アプリは30個） 5
6. 🔥SceneDelegate対応🔥
7. Custom URL Schemeの呼び出しメソッドの変更 AppDelegateではCustom URL Scheme で呼ばれるメソッドは1つだった application(_:open:options:) 7
8. Custom URL Schemeの呼び出しメソッドの変更 SceneDelegateでは起動種別に応じて どちらかのメソッドが呼ばれる scene(_:willConnectTo:options:) scene(_:openURLContexts:) 8
9. 起動種別について整理する 起動種別 プロセス メモリ 例 Cold Start なし なし 端末再起動後 Warm Start なし ⼀部キャッシュ 終了直後の起動 Resume あり 全保持 サスペンドから復帰 参考︓WWDC19 "Optimizing App Launch" 9
10. 起動種別について整理する 起動種別 プロセス メモリ 例 Cold Start なし なし 端末再起動後 Warm Start なし ⼀部キャッシュ 終了直後の起動 scene(_:willConnectTo:options:) Resume あり 全保持 サスペンドから復帰 scene(_:openURLContexts:) 10
11. 起動種別について整理する 起動種別 プロセス メモリ 例 Cold Start なし なし 端末再起動後 Warm Start なし ⼀部キャッシュ 終了直後の起動 Launch Resume Resume scene(_:willConnectTo:options:) あり 全保持 サスペンドから復帰 scene(_:openURLContexts:) 11
12. 確認のパターンがLaunchと Resumeで2倍になった
13. 開発しているアプリはCustom URL Schemeが30個ある
14. 60パターンも⾒るのはつらい
15. そこで
16. XCUITest
17. XCUITestで動作を担保する •起動種別に応じた テストができる •ユニットテストは 起動種別まで確認 できない Launch 17 Resume
18. 実装⽅法
19. テストの全体像 1. テストしたい画⾯のスキームと確認 したい要素を定義する 2. Launch・Resumeを再現する 3. 遷移後の画⾯で、要素を確認する 確認の途中で画⾯操作を経由しないので 壊れにくいUITestになる 19
20. テストの全体像 1. テストしたい画⾯のスキームと確認 したい要素を定義する 2. Launch・Resumeを再現する 3. 遷移後の画⾯で、要素を確認する ※ソースコード全体は後ほど共有する 本スライドのAppendixを参照ください 20
21. Launchのテスト /// Launchのテスト func assertLaunch() { app.open(schemeURL) // 要素の検証処理 } 21
22. Launchのテスト /// Launchのテスト func assertLaunch() { app.open(schemeURL) // 要素の検証処理 XCUIApplication } func open(_ url: URL) Launches the application by URL. 22
23. Resumeのテスト /// Resumeのテスト func assertResume() { app.open(url) app.open(url) // 要素の検証処理 } 23
24. Resumeのテスト /// Resumeのテスト func assertResume() { app.open(url) openを⼆回呼ぶことで、 app.open(url) Resumeを再現できる︖ // 要素の検証処理 } 24
25. Resumeのテスト /// Resumeのテスト func assertResume() { app.open(url) openを⼆回呼ぶことで、 app.open(url) Resumeを再現できる︖ // 要素の検証処理 } 25
26. Resumeのテストでつまづいたところ XCUIApplication func open(_ url: URL) Launches the application by URL. open(_:)は呼ぶたびに、アプリを終了 して起動し直す 26
27. Resumeのテスト（修正版） /// Resumeのテスト func assertResume() { app.launch() XCUIDevice.shared.system.open(schemeURL) // 要素の検証処理 } 27
28. Resumeのテスト（修正版） /// Resumeのテスト func assertResume() { app.launch() XCUIDevice.shared.system.open(schemeURL) // 要素の検証処理 XCUIApplication } func launch() Launches the application. 28
29. Resumeのテスト（修正版） /// Resumeのテスト func assertResume() { app.launch() XCUIDevice.shared.system.open(schemeURL) // 要素の検証処理 } XCUISystem func open(_ url: URL) Opens an item in the default application for a URL. 29
30. もう何⼗パターンも ⾒る必要はない
32. まとめ •SceneDelegateでは起動種別によって 呼ばれるメソッドが変わる •テストはLaunchとResumeの両⽅の 観点が必要 •XCUITestを⽤いることで、両⽅の観点 を確認できる 32
33. Appendix
34. テストに必要なプロトコルのコード import XCTest /// Launchのテスト func assertLaunch() { app.open(schemeURL) /// URLスキームテストに必要な要素を定義するプロトコル protocol URLSchemeTestable: XCTestCase { /// スキームのホスト名（例: "iosdc"） var schemeHost: String { get } /// クエリパラメータ var queryItems: [URLQueryItem] { get } /// 遷移先の画⾯要素 var targetElement: XCUIElement { get } /// クエリパラメータの反映を検証する要素 var queryAssertionElement: XCUIElement? { get } } XCTAssertTrue(targetElement.waitForExistence(timeout: 10)) if let element = queryAssertionElement { XCTAssertTrue(element.exists) // クエリの反映も⾒たいスキームだけ } } /// Resumeのテスト func assertResume() { app.launch() XCUIDevice.shared.system.open(schemeURL) extension URLSchemeTestable { var app: XCUIApplication { XCUIApplication() } var queryAssertionElement: XCUIElement? { nil } var schemeURL: URL { var components = URLComponents() components.scheme = "myapp" components.host = schemeHost components.queryItems = queryItems return components.url! } // 起動させ、Launchを検証する // 「起動済み」の状態を作る // システムにURLを開かせる XCTAssertTrue(targetElement.waitForExistence(timeout: 10)) if let element = queryAssertionElement { XCTAssertTrue(element.exists) } } } 34
35. プロトコルを確認したい画⾯に準拠 import XCTest final class IOSDCSchemeTests: XCTestCase { func test_Launch_iosdcスキームで詳細画⾯が表⽰される() { assertLaunch() } func test_Resume_iosdcスキームで詳細画⾯に遷移する() { assertResume() } } extension IOSDCSchemeTests: URLSchemeTestable { var schemeHost: String { "iosdc" } var queryItems: [URLQueryItem] { [URLQueryItem(name: "year", value: "2026")] } var targetElement: XCUIElement { app.otherElements["IOSDCDetailViewController"] } var queryAssertionElement: XCUIElement? { app.staticTexts["iOSDC 2026"] } } 35