Javier Cicchelli
9bcdaa697b
This PR contains all the work related to setting up this project as required to implement the [Assignment](https://repo.rock-n-code.com/rock-n-code/deep-linking-assignment/wiki/Assignment) on top, as intended. To summarise this work: - [x] created a new **Xcode** project; - [x] cloned the `Wikipedia` app and inserted it into the **Xcode** project; - [x] created the `Locations` app and also, its `Libraries` package; - [x] created the `Shared` package to share dependencies between the apps; - [x] added a `Makefile` file and implemented some **environment** and **help** commands. Co-authored-by: Javier Cicchelli <javier@rock-n-code.com> Reviewed-on: rock-n-code/deep-linking-assignment#1
426 lines
17 KiB
Swift
426 lines
17 KiB
Swift
import XCTest
|
||
|
||
// Details: see `README.md` in same folder as this file.
|
||
|
||
class WikipediaUITests: XCTestCase {
|
||
|
||
let app = XCUIApplication()
|
||
var snapshotIndex = 0
|
||
|
||
override func setUp() {
|
||
super.setUp()
|
||
|
||
// Put setup code here. This method is called before the invocation of each test method in the class.
|
||
|
||
// In UI tests it is usually best to stop immediately when a failure occurs.
|
||
continueAfterFailure = false
|
||
|
||
snapshotIndex = 0
|
||
|
||
// uncomment one of these as needed when testing (useful when adding new screenshots to ensure `tapButton` works with non-EN)
|
||
/*
|
||
app.launchArguments = [
|
||
"-AppleLanguages",
|
||
"(de)",
|
||
"-AppleLocale",
|
||
"de_DE"
|
||
]
|
||
|
||
app.launchArguments = [
|
||
"-AppleLanguages",
|
||
"(zh)",
|
||
"-AppleLocale",
|
||
"zh_Hans"
|
||
]
|
||
|
||
app.launchArguments = [
|
||
"-AppleLanguages",
|
||
"(ja)",
|
||
"-AppleLocale",
|
||
"ja_JA"
|
||
]
|
||
*/
|
||
|
||
|
||
setupSnapshot(app, waitForAnimations: false)
|
||
|
||
// UI tests must launch the application that they test. Doing this in setup will make sure it happens for each test method.
|
||
app.launch()
|
||
|
||
// In UI tests it’s important to set the initial state - such as interface orientation - required for your tests before they run. The setUp method is a good place to do this.
|
||
}
|
||
|
||
override func tearDown() {
|
||
// Put teardown code here. This method is called after the invocation of each test method in the class.
|
||
super.tearDown()
|
||
}
|
||
|
||
// Prepends an auto-incremented numeric prefix to screenshot names so they appear on the index html page in the order they were captured.
|
||
func wmf_snapshot(_ name: String, timeWaitingForIdle timeout: TimeInterval = 45) {
|
||
snapshot("\(String(format: "%04d", snapshotIndex))-\(name)", timeWaitingForIdle: timeout)
|
||
snapshotIndex = snapshotIndex + 1
|
||
}
|
||
|
||
// This UI test is used as a harness to navigate to various parts of the app and record screenshots. Fastlane snapshots don't seem to play nice with multiple tests taking snapshots, so we have all of them in this single test.
|
||
func testRecordAppScreenshots() {
|
||
|
||
|
||
// WECOME
|
||
wmf_snapshot("Welcome1")
|
||
|
||
app.wmf_tapFirstButton(withTranslationIn: ["welcome-intro-free-encyclopedia-more"])
|
||
wmf_snapshot("Welcome2")
|
||
|
||
app.wmf_tapFirstButton(withTranslationIn: ["welcome-explore-tell-me-more-done-button"])
|
||
|
||
app.wmf_tapFirstButton(withTranslationIn: ["button-next"])
|
||
wmf_snapshot("Welcome3")
|
||
|
||
app.wmf_tapFirstButton(withTranslationIn: ["button-next"])
|
||
wmf_snapshot("Welcome4")
|
||
|
||
app.wmf_tapFirstButton(withTranslationIn: ["welcome-languages-add-or-edit-button"])
|
||
wmf_snapshot("Welcome5")
|
||
|
||
app.wmf_tapFirstCloseButton()
|
||
|
||
app.wmf_tapFirstButton(withTranslationIn: ["button-next"])
|
||
wmf_snapshot("Welcome6")
|
||
|
||
app.wmf_tapFirstSwitch(withTranslationIn: ["preference-title-eventlogging-opt-in"])
|
||
wmf_snapshot("Welcome7")
|
||
|
||
app.wmf_tapFirstButton(withTranslationIn: ["welcome-explore-continue-button"])
|
||
|
||
|
||
// Useful if you temporarily comment out the welcome screens above.
|
||
// app.wmf_tapFirstButton(withTranslationIn: ["button-skip"])
|
||
|
||
|
||
// Scroll down a ways then back up to increase odds that feed elements are in place and won't be freshing underneath us while the code below scrolls and attempts to tap on elements.
|
||
app.wmf_scrollDown(times: 20)
|
||
app.wmf_scrollToTop()
|
||
|
||
|
||
// EXPLORE
|
||
app.wmf_tapFirstButton(withTranslationIn: ["home-title"])
|
||
wmf_snapshot("Explore1")
|
||
|
||
let iPhoneXSafeTopOffset: CGFloat = 0.04 // As of Xcode 9.4 an offset of 0 drags elements a little too far up.
|
||
|
||
app.wmf_scrollToFirstElements(matching: .link, yOffset: iPhoneXSafeTopOffset, items:
|
||
[
|
||
// Picture of the day / Gallery
|
||
ScrollItem(key: "explore-potd-heading") { element in
|
||
self.wmf_snapshot("ExplorePicOfTheDay")
|
||
element.wmf_tap()
|
||
self.wmf_snapshot("Gallery")
|
||
self.app.wmf_tapFirstCloseButton()
|
||
},
|
||
|
||
// Featured article
|
||
ScrollItem(key: "explore-featured-article-heading") { element in
|
||
self.wmf_snapshot("ExploreFeaturedArticle")
|
||
},
|
||
|
||
// Top read
|
||
ScrollItem(key: "explore-most-read-generic-heading") { element in
|
||
self.wmf_snapshot("ExploreMostRead")
|
||
element.wmf_tap()
|
||
self.wmf_snapshot("MostReadDetail")
|
||
self.app.wmf_tapFirstCloseButton()
|
||
},
|
||
|
||
// On this day
|
||
ScrollItem(key: "on-this-day-title") { element in
|
||
self.wmf_snapshot("ExploreOnThisDay")
|
||
element.wmf_tap()
|
||
self.wmf_snapshot("OnThisDayDetail")
|
||
self.app.wmf_tapFirstCloseButton()
|
||
},
|
||
|
||
// Nearby
|
||
ScrollItem(key: "explore-nearby-placeholder-heading") { element in
|
||
self.wmf_snapshot("ExploreNearbyPlaces")
|
||
},
|
||
|
||
// Random article
|
||
ScrollItem(key: "explore-random-article-heading") { element in
|
||
self.wmf_snapshot("ExploreRandom")
|
||
element.wmf_tap()
|
||
sleep(8)
|
||
self.wmf_snapshot("RandomDetail")
|
||
self.app.wmf_tapFirstButton(withTranslationIn: ["button-save-for-later"])
|
||
self.wmf_snapshot("RandomDetailSaved")
|
||
self.app.wmf_tapFirstNavigationBarBackButton()
|
||
},
|
||
/*
|
||
// Main page
|
||
ScrollItem(key: "explore-main-page-heading") { element in
|
||
self.wmf_snapshot("ExploreMainPage")
|
||
element.wmf_tap()
|
||
self.wmf_snapshot("MainPageDetail")
|
||
self.app.wmf_tapFirstNavigationBarBackButton()
|
||
},
|
||
*/
|
||
// In the news
|
||
ScrollItem(key: "in-the-news-title") { element in
|
||
self.wmf_snapshot("ExploreInTheNews")
|
||
element.wmf_tap()
|
||
self.wmf_snapshot("InTheNewsDetail")
|
||
self.app.wmf_tapFirstCloseButton()
|
||
}
|
||
]
|
||
)
|
||
|
||
|
||
// SEARCH
|
||
app.wmf_scrollToTop()
|
||
if let searchField = app.wmf_firstSearchField(withTranslationIn: ["search-field-placeholder-text"]) {
|
||
if searchField.wmf_tap() {
|
||
wmf_snapshot("Search1")
|
||
if searchField.wmf_typeText(text: "a") {
|
||
wmf_snapshot("Search2")
|
||
}
|
||
}
|
||
}
|
||
|
||
|
||
// ARTICLE
|
||
app.wmf_tapFirstCollectionViewCell()
|
||
sleep(6)
|
||
wmf_snapshot("Article1")
|
||
sleep(8) // give popover time to disappear
|
||
|
||
// TOC and ARTICLE FOOTERS
|
||
if UIDevice.current.userInterfaceIdiom != .pad {
|
||
// TOC
|
||
app.wmf_tapFirstButton(withTranslationIn: ["table-of-contents-button-label"])
|
||
wmf_snapshot("ArticleTOC")
|
||
|
||
app.wmf_scrollToFirstElements(matching: .staticText, yOffset: 0.1, items:
|
||
[
|
||
ScrollItem(key: "article-about-title") { element in
|
||
// `About this article` footer
|
||
element.wmf_tap()
|
||
self.wmf_snapshot("ArticleFooterAboutThisArticle")
|
||
|
||
// Article history
|
||
self.app.wmf_tapFirstStaticText(withTranslationIn: ["page-last-edited"], convertTranslationSubstitutionStringsToWildcards: true)
|
||
self.wmf_snapshot("ArticleFooterArticleHistory")
|
||
self.app.wmf_tapFirstCloseButton()
|
||
}
|
||
]
|
||
)
|
||
|
||
app.wmf_tapFirstButton(withTranslationIn: ["table-of-contents-button-label"])
|
||
|
||
app.wmf_scrollToFirstElements(matching: .staticText, yOffset: 0.1, items:
|
||
[
|
||
ScrollItem(key: "article-read-more-title") { element in
|
||
// `Read more` footer
|
||
element.wmf_tap()
|
||
self.wmf_snapshot("ArticleFooterReadMore")
|
||
}
|
||
]
|
||
)
|
||
} else {
|
||
app.wmf_scrollToFirstElements(matching: .staticText, yOffset: 0.1, items:
|
||
[
|
||
ScrollItem(key: "article-about-title") { element in
|
||
// `About this article` footer
|
||
element.wmf_tap()
|
||
self.wmf_snapshot("ArticleFooter")
|
||
}
|
||
]
|
||
)
|
||
}
|
||
|
||
|
||
// Article theme panel
|
||
app.wmf_tapFirstButton(withTranslationIn: ["article-toolbar-reading-themes-controls-toolbar-item"])
|
||
wmf_snapshot("ArticleThemesLight")
|
||
|
||
app.wmf_tapFirstButton(withTranslationIn: ["reading-themes-controls-accessibility-sepia-theme-button"])
|
||
wmf_snapshot("ArticleThemesSepia")
|
||
|
||
app.wmf_tapFirstButton(withTranslationIn: ["reading-themes-controls-accessibility-dark-theme-button"])
|
||
wmf_snapshot("ArticleThemesDark")
|
||
|
||
app.wmf_tapFirstButton(withTranslationIn: ["reading-themes-controls-accessibility-black-theme-button"])
|
||
wmf_snapshot("ArticleThemesBlack")
|
||
|
||
app.wmf_tapFirstButton(withTranslationIn: ["reading-themes-controls-accessibility-light-theme-button"])
|
||
app.dismissPopover()
|
||
|
||
// Article find in page
|
||
app.wmf_tapFirstButton(withTranslationIn: ["action-find-in-page"])
|
||
wmf_snapshot("ArticleFindInPage1")
|
||
if let textField = app.textFields.element(boundBy: 0).wmf_waitUntilExists() {
|
||
if textField.wmf_tap() {
|
||
if textField.wmf_typeText(text: "a") {
|
||
wmf_snapshot("ArticleFindInPage2")
|
||
}
|
||
}
|
||
}
|
||
app.wmf_scrollToTop()
|
||
app.wmf_tapFirstCloseButton()
|
||
app.wmf_tapFirstButton(withTranslationIn: ["button-save-for-later"])
|
||
|
||
app.wmf_tapFirstButton(withTranslationIn: ["home-button-explore-accessibility-label"])
|
||
|
||
// SETTINGS
|
||
app.wmf_tapFirstButton(withTranslationIn: ["settings-title"])
|
||
wmf_snapshot("Settings1")
|
||
app.wmf_scrollDown()
|
||
wmf_snapshot("Settings2")
|
||
app.wmf_scrollToTop()
|
||
|
||
|
||
app.wmf_scrollToFirstElements(matching: .staticText, yOffset: 0.13, items:
|
||
[
|
||
// Login
|
||
ScrollItem(key: "main-menu-account-login") { element in
|
||
element.wmf_tap()
|
||
self.wmf_snapshot("Login1")
|
||
|
||
// Create account
|
||
self.app.wmf_tapFirstStaticText(withTranslationIn: ["login-no-account"], convertTranslationSubstitutionStringsToWildcards: true)
|
||
self.wmf_snapshot("CreateAccount1")
|
||
self.app.wmf_scrollDown(times: 2, dragStartY: 0.25) // when keyboard is onscreen need to override dragStartY to be above keyboard
|
||
self.wmf_snapshot("CreateAccount2")
|
||
self.app.wmf_scrollToTop()
|
||
self.app.wmf_tapFirstCloseButton()
|
||
|
||
// Forgot password
|
||
element.wmf_tap()
|
||
self.app.wmf_tapFirstStaticText(withTranslationIn: ["login-forgot-password"])
|
||
self.wmf_snapshot("ForgotPassword1")
|
||
self.app.wmf_tapFirstCloseButton()
|
||
},
|
||
// My languages
|
||
ScrollItem(key: "settings-my-languages") { element in
|
||
element.wmf_tap()
|
||
self.wmf_snapshot("MyLanguages1")
|
||
self.app.wmf_tapFirstCloseButton()
|
||
},
|
||
// Notifications
|
||
ScrollItem(key: "settings-notifications") { element in
|
||
element.wmf_tap()
|
||
self.wmf_snapshot("Notifications1")
|
||
self.app.wmf_tapFirstButton(withTranslationIn: ["settings-title"])
|
||
},
|
||
// Reading preferences
|
||
ScrollItem(key: "settings-appearance") { element in
|
||
element.wmf_tap()
|
||
self.wmf_snapshot("ReadingPreferences1")
|
||
self.app.wmf_scrollDown()
|
||
self.wmf_snapshot("ReadingPreferences2")
|
||
self.app.wmf_scrollToTop()
|
||
self.app.wmf_tapFirstButton(withTranslationIn: ["settings-title"])
|
||
},
|
||
// Article storage and syncing
|
||
ScrollItem(key: "settings-storage-and-syncing-title") { element in
|
||
element.wmf_tap()
|
||
self.wmf_snapshot("StorageAndSyncing1")
|
||
self.app.wmf_scrollDown()
|
||
self.wmf_snapshot("StorageAndSyncing2")
|
||
self.app.wmf_scrollToTop()
|
||
self.app.wmf_tapFirstButton(withTranslationIn: ["settings-title"])
|
||
},
|
||
// Clear cached data
|
||
ScrollItem(key: "settings-clear-cache") { element in
|
||
element.wmf_tap()
|
||
self.wmf_snapshot("ClearCache1")
|
||
},
|
||
// Help and feedback
|
||
ScrollItem(key: "settings-help-and-feedback") { element in
|
||
element.wmf_tap()
|
||
sleep(4)
|
||
self.wmf_snapshot("HelpAndFeedback1")
|
||
self.app.wmf_tapFirstButton(withTranslationIn: ["settings-title"])
|
||
},
|
||
// About the app
|
||
ScrollItem(key: "main-menu-about") { element in
|
||
element.wmf_tap()
|
||
self.wmf_snapshot("AboutTheApp1")
|
||
self.app.wmf_scrollDown()
|
||
self.wmf_snapshot("AboutTheApp2")
|
||
self.app.wmf_scrollDown()
|
||
self.wmf_snapshot("AboutTheApp3")
|
||
|
||
self.app.wmf_scrollToTop()
|
||
self.app.webViews.element(boundBy: 0).wmf_waitUntilExists(timeout: 1.0)?.wmf_scrollToFirstElements(matching: .staticText, yOffset: 0.1, items:
|
||
[
|
||
// Libraries used
|
||
ScrollItem(key: "about-libraries-complete-list") { element in
|
||
element.wmf_tap()
|
||
self.wmf_snapshot("AboutTheAppLibrariesUsed")
|
||
self.app.wmf_tapFirstCloseButton()
|
||
}
|
||
]
|
||
)
|
||
|
||
self.app.wmf_tapFirstButton(withTranslationIn: ["settings-title"])
|
||
self.app.wmf_tapFirstCloseButton()
|
||
},
|
||
// Explore feed
|
||
ScrollItem(key: "welcome-exploration-explore-feed-title") { element in
|
||
element.wmf_tap()
|
||
self.wmf_snapshot("ExploreCustomization1")
|
||
self.app.wmf_scrollDown()
|
||
self.wmf_snapshot("ExploreCustomization2")
|
||
self.app.wmf_scrollToTop()
|
||
self.app.wmf_tapFirstButton(withTranslationIn: ["settings-title"])
|
||
},
|
||
// Search
|
||
ScrollItem(key: "search-title") { element in
|
||
element.wmf_tap()
|
||
self.wmf_snapshot("SearchCustomization1")
|
||
self.app.wmf_tapFirstButton(withTranslationIn: ["settings-title"])
|
||
}
|
||
]
|
||
)
|
||
|
||
app.wmf_tapFirstCloseButton()
|
||
|
||
// SAVED
|
||
app.wmf_tapFirstButton(withTranslationIn: ["saved-title"])
|
||
wmf_snapshot("Saved1")
|
||
app.wmf_tapFirstCloseButton()
|
||
wmf_snapshot("Saved2")
|
||
|
||
|
||
// HISTORY
|
||
app.wmf_tapFirstButton(withTranslationIn: ["history-title"])
|
||
wmf_snapshot("History1")
|
||
|
||
|
||
// PLACES
|
||
app.wmf_tapFirstButton(withTranslationIn: ["places-title"])
|
||
wmf_snapshot("Places1")
|
||
app.wmf_tapFirstButton(withTranslationIn: ["places-enable-location-action-button-title"])
|
||
wmf_snapshot("Places2")
|
||
|
||
// Reminder: would need to adjust `boundBy:` if an RTL lang support is added to fastlane for snapshots.
|
||
if let allowLocationPermissionButton = XCUIApplication(bundleIdentifier: "com.apple.springboard").buttons.element(boundBy: 2).wmf_waitUntilExists(timeout: 6) {
|
||
allowLocationPermissionButton.wmf_tap()
|
||
wmf_snapshot("Places3")
|
||
}
|
||
if let searchField = app.wmf_firstSearchField(withTranslationIn: ["places-search-default-text"]) {
|
||
if searchField.wmf_tap() {
|
||
wmf_snapshot("Places4")
|
||
if searchField.wmf_typeText(text: "a") {
|
||
sleep(6)
|
||
wmf_snapshot("Places5")
|
||
app.wmf_tapFirstTableViewCell()
|
||
wmf_snapshot("Place6")
|
||
}
|
||
}
|
||
}
|
||
|
||
app.wmf_tapFirstButton(withTranslationIn: ["places-accessibility-show-as-list"])
|
||
wmf_snapshot("Places7")
|
||
}
|
||
}
|