3年以上運用しているアプリにUIテストを導入した #orecon_ios #fastlane_study_jp /orecon_ios_ui_test_20171003

俺コン Vol.1 Day.2 にて発表した3年以上運用しているアプリにUIテストを導入した話です。
https://orecon.connpass.com/event/64285/

Transcript

1. 3೥Ҏ্ӡ༻͍ͯ͠ΔΞϓϦʹUIςετΛಋೖͨ͠ iOSDC Japan 2017 Զίϯ Vol.1 / Day. 2 1
2. Profile Kazuya Ueoka Timers inc.ͷiOSΤϯδχΞ Twitter: @fromkk Github: fromkk Qiita: fromkk 2
6. ΤϯδχΞืूத 6
7. ࠓճUIςετΛಋೖͨ͠ΞϓϦ 7
9. Famm • 2014/05ϦϦʔεͷՈ଒޲͚ΫϩʔζυSNSΞϓϦ • iOS/AndroidରԠ • ຖ݄ϑΥτΧϨϯμʔΛҹ࡮ͯ͠Ϣʔβʔʹಧ͚Δ 9
10. UIςετৼΓฦΓ 10
11. WWDC 2015 • UIཁૉΛݕࡧɾΞΫγϣϯΛ࣮ߦ • UIͷϓϩύςΟͱঢ়ଶΛݕূ • UI recording • ςετ݁ՌΛϨϙʔτ 11
12. ʊਓਓਓਓਓਓਓਓਓਓਓਓਓਓਓʊ ʼɹԿ͍͍͔ͯ͠෼͔Βͳ͍ ɹʻ ʉY^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Yʉ 12
13. UIςετͷਏΈ • ͍͖ͳΓॳظը໘͕ىಈ͢Δ • ຖճཁૉΛݕࡧ͢Δͷ͕໘౗ • ஗͍ 13
14. UIςετΛಋೖ͢Δʹ౰ͨͬͯఘΊͨࣄ 14
15. طଘը໘ͷςετΛॻ͘ࣄ͸ఘΊͨ • طଘίʔυ͕ີ݁߹ա͗ͨ(ViewController಺Ͱ௚઀Ϟσϧ Λݺͼग़ͨ͠Γ௚઀URLʹΞΫηεͨ͠Γ...) • ৽نը໘ɾཁૉʹ͸ accessibilityIdentifier Λؤுͬ ͯৼΔ༷ʹҙࣝ 15
16. ΍ͬͨࣄ ͦͷ1 16
17. ΞϓϦىಈ࣌ʹจࣈྻͰViewControllerΛ ࢦఆͯ͠ىಈग़དྷΔ༷ʹͨ͠ • iOSDC 2016ͷ @dealforest ͞ΜͷൃදΛࢀߟ 17
18. ॳظը໘ΛStoryboard͔Β։͘ઃఆΛ࡟আ ↓ 18
19. ViewController༻ͱΦϓγϣϯ༻ͷΩʔΛܾΊ͓ͯ͘ struct LaunchKeys { static let viewController: String = "LAUNCH_VIEW_CONTROLLER" static let userInfo: String = "LAUNCH_USER_INFO" } 19
20. εΩʔϜΛฤू ઌ΄ͲܾΊͨΩʔʹରͯ͠஋Λઃఆ͢Δ 20
21. Creatable protocol protocol Creatable { func create<T>(_ identifier: String, userInfo: [AnyHashable: Any]?) -> T? } 21
22. Adopt to Creatable struct Creator: Creatable { func create<T>(_ identifier: String, userInfo: [AnyHashable : Any]?) -> T? { switch identifier { case "ViewController": return viewController() as? T default: return nil } } } extension Creator { func viewController() -> ViewController { let storyboard = UIStoryboard(name: "Main", bundle: Bundle.main) return storyboard.instantiateInitialViewController() as! ViewController } } 22
23. Launcher struct Launcher { var creator: Creatable init(with creator: Creatable) { self.creator = creator } func launch<T>() -> T? { guard let viewControllerName: String = ProcessInfo.processInfo.environment[LaunchKeys.viewController] else { return nil } var userInfo: [AnyHashable: Any]? = nil if let userInfoString: String = ProcessInfo.processInfo.environment[LaunchKeys.userInfo], let userInfoData: Data = userInfoString.data(using: .utf8) { userInfo = (try? JSONSerialization.jsonObject(with: userInfoData, options: [])) as? [AnyHashable : Any] } return creator.create(viewControllerName, userInfo: userInfo) } } 23
24. AppDelegate.swift let creator = Creator() let rootViewController: UIViewController #if DEBUG if let viewController: UIViewController = Launcher(with: creator).launch() { rootViewController = viewController } else { rootViewController = creator.rootViewController() } #else rootViewController = creator.rootViewController() #endif window?.rootViewController = rootViewController 24
25. ΍ͬͨࣄ ͦͷ2 25
26. UIςετ͔ΒViewControllerΛࢦఆͯ͠ ςετग़དྷΔ༷ʹͨ͠ 26
27. ςετଆͷλʔήοτʹ΋ Launcher Λ࡞੒ 27
28. import XCTest struct Launcher { var viewControllerName: String var userInfo: [AnyHashable: Any]? init(viewControllerName: String, userInfo: [AnyHashable: Any]? = nil) { self.viewControllerName = viewControllerName self.userInfo = userInfo } var env: [String: String] { var result: [String: String] = [LaunchKeys.viewController: self.viewControllerName] if let userInfo: [AnyHashable: Any] = self.userInfo { if let data: Data = try? JSONSerialization.data(withJSONObject: userInfo, options: []), let userInfoString: String = String(data: data, encoding: .utf8) { result[LaunchKeys.userInfo] = userInfoString } } return result } func launch() -> XCUIApplication { let app: XCUIApplication = XCUIApplication() app.launchEnvironment = env app.launch() return app } } 28
29. ΍ͬͨࣄ ͦͷ3 29
30. ϖʔδ಺ͷཁૉΛ੔ཧ • σβΠφʔ͔ΒZeplinͱ͍͏πʔϧͰ UIΛ໯͏ • UIΛ໯ͬͨஈ֊ͰཁૉΛચ͍ग़͠ • ςετλʔήοτͰཁૉϦετΛ࡞੒ ʢPage Object Design Patternʣ 30
31. PageObjectsRepresentable protocol protocol PageObjectsRepresentable { var app: XCUIApplication init(app: XCUIApplication) } 31
32. Adopt to PageObjectsRepresentable struct ViewControllerPage: PageObjectsRepresentable { var app: XCUIApplication init(app: XCUIApplication) { self.app = app } var label: XCUIElement { return app.staticTexts["label"] } } 32
33. Test import XCTest class LunchViewControllerTests: XCTestCase { var viewControllerName: String { return "ViewController" } func testLunchLabel() { let launcher = Launcher(viewControllerName: viewControllerName) let app = launcher.launch() let page = ViewControllerPage(app: app) XCTAssertTrue(page.label.exists) XCTAssertEqual(page.label.label, "Lunch") } } 33
34. ͋Εʁ͜ΕϥΠϒϥϦԽ ग़དྷΔΜ͡Όͳ͍ʁ 34
35. https://github.com/ fromkk/Lunch 35
36. Lunch • Launcher • Creatable • LaunchKeys • PageObjectsRepresentable • ViewControllerTestable ͷΈఆٛ 36
37. ! ͍ͩ͘͞ 37
38. Ԡ༻ฤ 38
39. UIςετͰϞοΫͷ஋Λ൓өͤͯ͞ςετ 39
40. ద౰ͳϞσϧΛఆٛ struct HogeModel { var hoge: String } 40
41. ViewControllerʹϞσϧΛอ࣋ class HogeViewController: UIViewController { @IBOutlet weak var hogeLabel: UILabel! var hogeModel: HogeModel { didSet { hogeLabel.text = hogeModel.hoge } } } 41
42. CreatorΛ֦ு struct Creator: Creatable { func create<T>(_ identifier: String, userInfo: [AnyHashable : Any]?) -> T? { switch identifier { case "HogeViewController": guard let data = (userInfo?["MOCK_JSON"] as? String)?.data(using: .utf8), let json: [String: String] = (try? JSONSerialization.jsonObject(with: data, options: [])) as? [String: String], let hoge = json["hoge"] else { return nil } let model = HogeModel(hoge: hoge) return hogeViewController(with: model) as? T default: return nil } } } extension Creator { func hogeViewController(with hoge: HogeModel) -> HogeViewController { let viewController = HogeViewController() viewController.hogeModel = hoge return viewController } } 42
43. UIςετ͔ΒJSONจࣈྻΛΞϓϦʹ౉ͯ͠ςετ func testModel() { let launcher = Launcher(viewControllerName: viewControllerName, userInfo: ["MOCK_JSON": "{\"hoge\": \"fuga\"}"]) let app = launcher.launch() let page = HogeViewControllerPage(app: app) XCTAssertTrue(page.hogeLabel.exists) XCTAssertEqual("fuga", page.hogeLabel.label) } 43
44. ! 44
45. ͦͷଞͷςΟοϓε 45
46. UIͷ ঢ়ଶ Λςετ͢Δ • ཁૉ Λઃఆ͢Δͷ͸ accessibilityIdentifier • ঢ়ଶ Λઃఆ͢Δͷ͸ accessibilityValue • छྨ Λઃఆ͢Δͷ͸ accessibilityTraits • UIςετଆͰ͸ͦΕͧΕ identifier , value, elementType ͰΞΫηεग़དྷΔ 46
47. CIͰ͸UIςετ͸࣮ߦ͠ͳ͍༷ʹ • CI؀ڥ(Bitrise)ͰUIςετΛ࣮ߦ͢Δͱֻ͕͔࣌ؒΓ͗͢ Δ • xcodebuild test ʹ -only-testing:$UITEST_SCHEME Λ௥Ճ͢ΔࣄͰςετ͢ΔεΩʔϜΛબ୒ • ಉ༷ʹ -skip-testing:$UITEST_SCHEME Ͱಛఆͷςε τͷεΩʔϜΛεΩοϓ͢Δࣄ͕ग़དྷΔ 47
48. ϩʔΧϥΠζରԠ • ϩέʔϧ৘ใΛมߋ͢Δʹ͸ XCUIApplication ͷ launchArguments Λมߋ • ྫ: ["-AppleLanguages", "(ja)", "- AppleLocale", "ja-JP"] Lunch ͷ৔߹ launcher(targetViewController: self, locale: "ja-JP") ͷ༷ʹࢦఆՄೳ 48
49. UIςετΛಋೖͯ͠Έͯ • Ұؾʹશ෦Λςετ͢Δࣄ͸΍͸Γ೉͍͠ • ग़དྷΔࣄ͔Βগͣͭ͠ " • ͕͜͜ಈ࡞͠ͳ͍ͱΞϓϦͱͯ͠੒Γཱͨͳ͍ͱ͍͏࠷௿ݶͷ ॴ͔ΒςετΛॻ͍ͯߦ͘ͷ͕ྑͦ͞͏ • ϢχοτςετͰ΋ςετग़དྷΔՕॴ͸ͳΔ΂͘Ϣχοτςε τΛॻ͍ͨํ͕͍͍͔΋ $ 49
50. Summary • LunchͰUIςετ΁ͷϋʔυϧ͕গ͠Լ͕Γ·ͨ͠ • UIςετͰཁૉΛڞ௨Խ͢ΔࣄͰ࢖͍ճ͕͠؆୯ • ಛఆͷViewController͚ͩ։͖͍ͨ࣌ʹεΩʔϜฤू͚ͩͰ ָνϯ # • ෭࣍తʹΠϯελϯεԽ͢ΔॲཧΛڞ௨Խग़དྷͨ 50
51. ! ͍ͩ͘͞ https://github.com/fromkk/Lunch 51
52. ͝ਗ਼ௌ͋Γ͕ͱ͏͍͟͝·ͨ͠ 52