マルチモジュールアーキテクチャと開発プロセス改善の取り組み

iOSDC 2023 day1での発表資料です。
https://fortee.jp/iosdc-japan-2023/proposal/6a594106-bb92-4599-b28c-ada0a899eb13

Transcript

1. マルチモジュールアーキテクチャへの移⾏と 開発プロセス改善の取り組み Sep 2nd, 2023 Natsumi Oishi Rakuten Group, Inc.
2. 2 Natsumi Oishi Rakuten Group, Inc. Rakuten Rakuma
3. 3 ラクマのこれまで
4. 4 Objective-C to Swift Conversion (~2022) 👋
5. 5 Architecture MVC MVP MVVM シンプルな ViewController のみ UIHostingController (SwiftUI) UIKit 製の ViewController
6. 6 これから何をしていくか 🤔
7. 7 Topics 1. SwiftUI の拡⼤、Interface Builder の削除 2. マルチモジュールアーキテクチャへの移⾏ 3. Gitブランチ戦略とリリースプロセスの⾃動化 4. リリースプロセスにおけるドキュメンテーション
8. 8 SwiftUI の拡⼤、Interface Builder の削除
9. 9 新しい技術を 積極的に取り⼊れていきたい 💪
10. 10 Interface Builder は メンテナンスしづらい 🥺
11. 11 How to proceed • ViewController / Viewコンポーネントを SwiftUI へ • 新規画⾯は SwiftUI で検討 • 残りの xib / storyboard をリストアップ • ⼿が空いている⼈が⾃由に着⼿ • UIKit or SwiftUI → 実装者が選択 SwiftUIの拡⼤、Interface Builderの削除
12. 12 How to proceed • 現状の SwiftUI で実装が困難なものをすり合わせ • TextField 系 • Pull to refresh (iOS 16未満) • スクロールによる追加読み込み（ページング） SwiftUIの拡⼤、Interface Builderの削除
13. 13 UI Framework (ViewController) UIKit SwiftUI SwiftUIの拡⼤、Interface Builderの削除
14. 14 SwiftUI SwiftUIの拡⼤、Interface Builderの削除
15. 15 UIKit TextField × Pull to refresh × ページング × SwiftUIの拡⼤、Interface Builderの削除
16. 16 The number of Interface Builder files 0 40 80 120 160 2021年8⽉ 2022年8⽉ 2023年8⽉ storyboard xib • LaunchScreen • 廃⽌予定の ViewController SwiftUIの拡⼤、Interface Builderの削除
17. 17 Problems 🤔 • 仕様の把握漏れによるバグがテスト中に発覚 • Interface Builder 上の設定を忘れがち • 実装途中に SwiftUI で実装不可能と判明 • 代替のコンポーネントで実装 • 実装前に実装可能か調査が必要 SwiftUIの拡⼤、Interface Builderの削除
18. 18 Problems 🤔 • 親の View (UIKit) のコードが複雑になる • UIHostingController の view を UIView として扱うとシンプルに • サイズ可変な View コンポーネントのレイアウト崩れ • 画⾯全体を SwiftUI に書き換えてしまった⽅が楽 SwiftUIの拡⼤、Interface Builderの削除
19. 19 マルチモジュールアーキテクチャへの移⾏
20. 20 Purpose 🖊 • 責務の分離 • ローカルのテストの⾼速化 マルチモジュールアーキテクチャへの移⾏
21. 21 AS-IS マルチモジュールアーキテクチャへの移⾏
22. 22 Multi-Module Ph1 マルチモジュールアーキテクチャへの移⾏
23. 23 Multi-Module Ph2 マルチモジュールアーキテクチャへの移⾏
24. 24 Multi-Module Ph3 マルチモジュールアーキテクチャへの移⾏
25. 25 Multi-Module Ph4, Ph5 Ph4 Ph5 マルチモジュールアーキテクチャへの移⾏
26. 26 Migration Policy 🧭 • ⼀気に理想の形へ進めない • 前のフェーズが完了していなくても次のフェーズに進む • 現在 Ph3 の状態だが、 前段階の移⾏作業も同時並⾏で⾏なってい る マルチモジュールアーキテクチャへの移⾏
27. 27 Good 👍 • 責務を分離できた • 移⾏時に Unit Test の実装漏れに気づけた • テストカバレッジ向上 💪 • モジュールごとに Unit Test を実⾏できる • ローカルでのUnit Testが⾼速化 マルチモジュールアーキテクチャへの移⾏
28. 28 Problems 🤔 • CIのビルド時間が増加 • M1マシンで許容範囲に • 同時の移⾏作業で project.pbxproj がコンフリクト • モジュール追加時に必要な設定を忘れがち • 移⾏時のみの悩みになるはず マルチモジュールアーキテクチャへの移⾏
29. 29 Gitブランチ戦略と リリースプロセスの⾃動化
30. 30 Previous Gitブランチ戦略とリリースプロセスの⾃動化
31. 31 Previous • develop ブランチで開発・QA • リリース直前に master へマージ • リリースは master からアーカイブ Gitブランチ戦略とリリースプロセスの⾃動化
32. 32 Previous Gitブランチ戦略とリリースプロセスの⾃動化
33. 33 NEW Gitブランチ戦略とリリースプロセスの⾃動化
34. 34 NEW • develop ブランチを廃⽌ • QA開始時に release ブランチを作成 • リリースは tag からアーカイブ Gitブランチ戦略とリリースプロセスの⾃動化
35. 35 NEW Gitブランチ戦略とリリースプロセスの⾃動化
36. 36 Problems 🤔 • Pull Request の⼀覧が取得できず • バージョンに含まれる差分 ≠ master / release ブランチ間の差分 • リリース作業にも変更が必要 • できるだけアクション数を減らしたい Gitブランチ戦略とリリースプロセスの⾃動化
37. 37 リリースプロセスの⾃動化 (Bitrise) 1. tag を⽣成 2. アプリのアーカイブ 3. AppStore へアップロード 4. GitHub のリリースページ作成 Bitrise Gitブランチ戦略とリリースプロセスの⾃動化
38. 38 リリースプロセスの⾃動化 (Bitrise) 1. Slack から workflow を実⾏ 2. ⼿動でAppStoreに submit 🚀 Gitブランチ戦略とリリースプロセスの⾃動化
39. 39 リリースプロセスの⾃動化 (GitHub Actions) • 差分があれば Pull Request を⾃動⽣成 • PR の description にリストアップ • 最新のタグと⽐較 GitHub Actions Gitブランチ戦略とリリースプロセスの⾃動化
40. 40 Gitブランチ戦略とリリースプロセスの⾃動化
41. 41 Problems & Next Action 🌟 • Bitrise と GitHub Actions のメンテナーが偏りがち • ハンズオン等で触れる機会を作る
42. 42 リリースプロセスにおけるドキュメンテーション
43. 43 Problems 🤔 • 仕様の把握漏れでバグ発⽣ • 影響範囲があいまい → QAに時間が掛かる • 不必要な確認作業が増加 • 実装からリリースまでのタイムラグは増加 リリースプロセスにおけるドキュメンテーション
44. 44 Problems 🤔 • 修正内容の社内への共有不⾜ • GitHub の Milestone : アプリエンジニア以外不向き • iOS / Android で共通の修正を確認しにくい リリースプロセスにおけるドキュメンテーション
45. 45 Document for release details リリースプロセスにおけるドキュメンテーション
46. 46 Document for release details • 変更の種別 • 新機能・仕様変更 • 不具合修正 • リファクタリング リリースプロセスにおけるドキュメンテーション
47. 47 Document for release details • Pull Request のリンク • QAの要否 • Impact Level • QAのターゲットOS / デバイス リリースプロセスにおけるドキュメンテーション
48. 48 Impact Level リリースプロセスにおけるドキュメンテーション
49. 49 まとめ
50. 50 Summary 1. SwiftUI の拡⼤、Interface Builder の削除 2. マルチモジュールアーキテクチャへの移⾏ 3. Gitブランチ戦略とリリースプロセスの⾃動化 4. リリースプロセスにおけるドキュメンテーション
51. 51 円滑かつ安全にやっていきたい 💪
52. Thank you for listening!