コンテンツにスキップ

English · 日本語

showcase 群

Bajutsu がプラットフォームをまたいで使う唯一のテストフィクスチャは、 demos/showcase/ にあります。同じ画面契約を 5 回実装しています。iOS の SwiftUI と UIKit、Android の Jetpack Compose と Views、そして両方のプラットフォームを対象とする 1 つの Flutter コードベースです。ほとんどのツールキットは、アクセシビリティ有と無の対で作られています (Flutter の iOS 版は今のところアクセシビリティ有のみです)。5 つのコードベースは、 demos/showcase/showcase.config.yaml に 12 個の targets.<name> を登録しています。

このフィクスチャは、実アプリが持つ操作面を、その全体を語れる最小のアプリに収めています。その操作面とは、 push ナビゲーションを伴う 5 タブ、全コードベース共通の 4 種のモーダルと iOS 限定のネイティブアラート (あわせて 5 種)、テキスト入力、ジェスチャ、非同期ロード、実通信とモック可能な通信、OS アラートを出す画面です。

BE-0079 でこれを唯一の iOS フィクスチャとし、旧来の demo / sample / sample2 を退役させました。 その後 BE-0007 と BE-0008 が、この iOS フィクスチャを今日のプラットフォームをまたぐ姿へと広げ、Android と Flutter の双子アプリを加えました。画面ごとの正式な契約(各識別子と各シナリオの対応)は demos/showcase/SPEC.md にあります。本ページは、その契約への入り口を まとめたものです。

関連:シナリオ · 設定 · codegen · cli


なぜ 2 ツールキット × アクセシビリティ 2 変種なのか

showcase は、Bajutsu の設計が依って立つ 2 つの軸を可視化します。

  • ツールキット軸(UIKit と SwiftUI):アクセシビリティ ON の 2 プロダクト(showcase-swiftui / showcase-uikit)は同一の識別子契約を露出するので、共有の demos/showcase/scenarios/ がどちらに対しても変更なしで動きます。 異なるのは backend が見る要素ツリーです。この差異こそ、クロスツールキットのドライバが吸収すべきものです。
  • アクセシビリティ軸(サフィックス無し ↔ -noax):-noax ビルドは識別子を一切持ちません (subject.idNamespaces: [])。-noax ビルドはセレクタ安定性の対照実験です(DESIGN §5)。同じゴールを 両方のビルドに対して記録すると、アクセシビリティ作業の価値が具体的な差分として現れます。-noax ビルドは、 record / doctor が「アクセシビリティ欠如」を扱うときの題材でもあります。

ビルドと実行

中核となる iOS の 4 ターゲットは、もとの bundle id(com.bajutsu.showcase.ios.{swiftui,uikit}[.noax])と deeplink scheme(showcase{swiftui,uikit}[noax])をそのまま使います。XcodeGen + xcodebuild でビルドします (project.yml が信頼できる唯一の情報源で、.xcodeproj / build/ は gitignore 対象です)。5 つめの iOS ターゲット showcase-swiftui-bundled は同じ SwiftUI アプリを使いますが、driver.runner の設定を持ちません。 そのため、Simulator 上の実行は、ローカルビルドのランナーではなく wheel に同梱されたランナー(BE-0292)に 解決されます。実際にどちらのランナーが使われているかは、bajutsu doctor --target showcase-swiftui-bundled で確認できます。残る 7 ターゲットは、Android の双子アプリ(android/、 Jetpack Compose と Views、BE-0007)と、両プラットフォーム向けの Flutter の双子アプリ (flutter/、BE-0008)です。それぞれ Gradle と Flutter SDK でビルドします。

make -C demos/showcase swiftui-build       # SwiftUI a11y プロダクトを Simulator 向けにコンパイル
make -C demos/showcase run-swiftui         # ビルド → インストール → 起動中 Simulator に対し bajutsu run(XCUITest)
make -C demos/showcase doctor              # アクセシビリティ A/B:a11y は Ready、-noax は Blocked
make -C demos/showcase ui-test             # codegen 経路:シナリオ → XCUITest → xcodebuild test
make -C demos/showcase run-flutter         # Flutter の iOS 版:ビルド → インストール → bajutsu run(XCUITest)
make -C demos/showcase run-flutter-android # Flutter の Android 版:ビルド → インストール → bajutsu run(adb)
make -C demos/showcase/android e2e-codegen # Android 版:シナリオ → UI Automator → connectedAndroidTest(起動済みエミュレータが必要、BE-0294)

bajutsu run / serve は各ターゲットの subject.build コマンドでアプリを必要時にビルドするので、先に手動で ビルドする必要はほとんどありません。

起動環境フック

これらの変数は、ターゲットの subject.launch.env(またはシナリオの preconditions.subject.launch.env)で 注入します。アプリには SIMCTL_CHILD_<NAME> として渡ります(drivers)。

BE-0079 で、データ状態と push で開く画面への起動時ショートカットを取り除きました。カタログは固定で(シードする 手段はありません)、deeplink が詳細へ直接飛ぶこともありません(詳細は行のタップでのみ到達します)。 BE-0107 では、画面への最後の起動時ショートカットである SHOWCASE_TAB を廃止して、この作業を完了しました。 アプリはつねに Stable タブで起動し、ほかのタブへはネイティブのタブバーをタップして移動します。XCUITest backend はネイティブのタブバーの個々のタブをタップできるので、タブをまたぐシナリオは --backend ios で 実行します。

起動タブより先の画面は、すべて UI を操作して辿ります。シナリオはデータを注入せず、アプリ自身の状態を観測します。

変数 効果
SHOWCASE_UITEST=1 アニメーションを無効化(条件待機を締める)
SHOWCASE_API_URL / SHOWCASE_HTTP_BASE カタログ GET とエコー POST/DELETE エンドポイントの base URL

識別子カタログの全体、deeplink 文法、プリミティブとシナリオの対応は demos/showcase/SPEC.md にあります。