Screengrab (Fastlane) — ano ito, mga kakayahan at automation ng mga screenshot

Ano ang Screengrab at bakit ito kailangan

Screengrab — ay isang bahagi ng Fastlane ecosystem na idinisenyo para sa automated na paggawa ng mga screenshot ng mga mobile application. Ang tool ay lumitaw noong 2015 bilang tugon sa problema: para sa publikasyon sa Google Play at App Store ay kinakailangan mula 4 hanggang 10 screenshot para sa bawat wika. Sa suporta ng 30 wika, ito ay 120–300 manu-manong kinuhang mga larawan.

Problema ng manu-manong paggawa ng screenshot

Ang developer ay manu-manong nagpapatakbo ng application sa simulator o device, nag-scroll sa kinakailangang screen, kumukuha ng screenshot, inililipat ito sa computer, pinuputol at inilalagay sa tamang folder. Ang pamamaraan ay inuulit para sa bawat wika at bawat oryentasyon. Ayon sa Google Play Console, ang karaniwang application ay ina-update tuwing dalawang linggo, na ginagawang regular na gawain ang mga screenshot.

Mga bentahe ng automation

Lutas ng Screengrab ang problema nang radikal: inilalarawan ng developer ang mga senaryo ng pagsubok sa UI framework (Espresso para sa Android, XCTest para sa iOS), at awtomatikong pinapatakbo ng Screengrab ang mga ito sa lahat ng kinakailangang device at wika. Fastlane ang nagko-coordinate ng proseso: nag-compile ng build, nagpapatakbo ng mga test, nangongolekta ng mga screenshot at inilalagay ang mga ito sa tamang folder structure.

Resulta — daang screenshot sa loob ng 10–15 minuto sa halip na ilang oras ng manu-manong trabaho. Inirerekomenda ng Google na i-update ang mga screenshot sa bawat makabuluhang pagbabago sa interface, at kung walang automation, ang payong ito ay madalas na binabalewala.

Paano gumagana ang Screengrab: arkitektura at prinsipyo ng operasyon

Arkitektura ng Screengrab ay itinayo sa paligid ng dalawang pangunahing bahagi: client sa device (screengrab-lib) at runner na namamahala sa pagpapatakbo ng mga test at pagkolekta ng mga resulta. Sa Android ginagamit ang instrumental test framework, sa iOS — XCTest.

Life cycle ng isang pagtakbo

Tinatawag ng Fastlane ang action na screengrab, na nagbabasa ng configuration file na Screengrabfile. Nag-compile ang runner ng test APK na may nakakonektang screengrab-lib library, ini-install ito sa mga nakakonektang device o emulator, at pinapatakbo ang mga UI test na may markang annotation para sa mga screenshot.

# Fastfile — deskripsyon ng lane para sa mga screenshot
lane :screenshots do
  capture_android_screenshots(
    output_directory: "fastlane/metadata/android/screenshots",
    locales: ["ru-RU", "en-US", "de-DE"],
    devices: ["pixel_6", "pixel_tablet"],
    use_tests_external_storage: true
  )
end

Istruktura ng mga output file

Lumilikha ang Screengrab ng hierarchy ng folder: wika → device → mga screenshot. Ang istraktura ay ganap na tumutugma sa mga kinakailangan ng Google Play Console at App Store Connect. App Store ay nangangailangan ng mahigpit na tinukoy na mga sukat para sa bawat uri ng device, at ang Screengrab ay bumubuo ng mga larawan nang eksakto ayon sa mga detalye.

Suporta para sa maraming device

Ang tool ay maaaring magpatakbo ng mga test nang magkatulad sa lahat ng nakakonektang device at emulator. Ang mga emulator ng Android ay awtomatikong naglulunsad kung hindi aktibo. Para sa iOS, gumagamit ang Screengrab ng mga simulator ng Xcode.

Pag-install at pagsasaayos ng Screengrab para sa Android

Pag-install ng Screengrab ay binubuo ng dalawang bahagi: pagdaragdag ng library sa proyekto at pag-configure ng configuration file. Sa Android kinakailangan ang UI framework Espresso at ang screengrab-lib library mula sa Fastlane repository.

Pagdaragdag ng mga dependency

Sa build.gradle ng module ng application, ang dependency screengrab-lib ay idinagdag. Ang library ay nagbibigay ng ScreenCapturer class na kumukuha ng screenshot sa sandali ng tawag.

// build.gradle (module: app)
androidTestImplementation(
  'tools.fastlane:screengrab-lib:2.1.0'
)

Pagsusulat ng test na may mga screenshot

Ang UI test ay minamarkahan ng annotation na Screengrab.screenshot() sa mga kinakailangang punto. Ang bawat tawag ay kumukuha ng screenshot ng kasalukuyang screen at ini-save ito sa tinukoy na pangalan.

import tools.fastlane.screengrab.Screengrab
import tools.fastlane.screengrab.locale.LocaleTestRule

class ScreenshotTest {

    @get:Rule
    val localeTestRule = LocaleTestRule()

    @Test
    fun testTakeScreenshots() {
        Screengrab.screenshot("main_screen")
        // Mga aksyon: i-click ang button ng pag-login
        Screengrab.screenshot("login_screen")
    }
}

Configuration ng Screengrabfile

Ang file na Screengrabfile ay nag-iimbak ng mga parameter ng pagtakbo: listahan ng mga device, wika, timeout at path para sa pag-save. Ang file ay karaniwang matatagpuan sa folder na fastlane sa tabi ng Fastfile.

Lokalisasyon ng mga screenshot at maraming wika

Lokalisasyon — pangunahing kakayahan ng Screengrab, kung saan ito madalas pinipili. Awtomatikong pinapalitan ng tool ang wika ng application bago ang bawat pagtakbo ng test at kumukuha ng mga larawan sa lahat ng tinukoy na wika.

Pag-configure ng mga wika

Ang mga wika ay itinakda sa Screengrabfile gamit ang parameter na locales. Para sa bawat wika, muling ini-install ng Screengrab ang application na may kaukulang mga mapagkukunan at pinapatakbo ang buong cycle ng mga test. Ang LocaleTestRule sa Android ay awtomatikong nagpapalit ng locale ng device.

# Screengrabfile
locales [
  "ru-RU",
  "en-US",
  "de-DE",
  "fr-FR",
  "es-ES",
  "ja-JP",
  "ko-KR"
]

Folder structure para sa mga localized na screenshot

Lumilikha ang Screengrab ng mga directory ayon sa scheme: screenshots/{locale}/{device_name}/{screenshot_name}.png. Ang istrakturang ito ay direktang tumutugma sa mga kinakailangan ng Google Play, na nagpapahintulot sa pag-upload ng mga screenshot sa pamamagitan ng Fastlane deliver gamit ang isang command.

Para sa iOS, inaasahan ng App Store Connect ang mga screenshot sa flat structure ayon sa wika. Awtomatikong ini-convert ng Fastlane ang hierarchy ng Screengrab sa kinakailangang format sa pag-publish.

Integrasyon ng Screengrab sa CI/CD pipeline

CI/CD integrasyon ay isa sa mga pangunahing bentahe ng Screengrab. Ang tool ay pinapatakbo mula sa command line at hindi nangangailangan ng graphical interface, na ginagawang perpekto para sa server builds.

GitHub Actions

Sa CI environment, kailangan maglunsad ng Android emulator o iOS simulator, pagkatapos ay tawagan ang lane na may mga screenshot. GitHub Actions ay sumusuporta sa pag-cache ng AVD, na nagpapabilis ng mga paulit-ulit na pagtakbo.

Mga parameter para sa CI

Sa CI configuration, mahalagang isaalang-alang ang mga limitasyon sa memory at oras. Ang mga emulator ng Android ay nangangailangan ng hindi bababa sa 2 GB RAM bawat device, at ang buong pagtakbo sa 7 wika at 2 device ay tumatagal ng 20–40 minuto.

# Fastfile — lane para sa CI na may mga timeout
lane :ci_screenshots do
  capture_android_screenshots(
    locales: ["en-US", "ru-RU"],
    devices: ["pixel_6"],
    clear_previous_screenshots: true,
    tests_timeout: "600",
    output_directory: "screenshots/ci"
  )
end

Jenkins Pipeline

Para sa Jenkins, ginagamit ang step na sh na may tawag na bundle exec fastlane. Inirerekomenda na patakbuhin ang mga screenshot sa gabi o pagkatapos ng trigger pagkatapos ng merge sa pangunahing branch upang hindi mapabagal ang development cycle.

Screengrab vs alternatibo: paghahambing ng mga tool

Screengrab — hindi lamang ang tool para sa automation ng screenshot. May mga alternatibo na may iba't ibang approach: built-in na OS tools, komersyal na platform at library para sa mga screenshot sa code.

ADB Shell ay nagbibigay ng buong kontrol, ngunit nangangailangan ng pagsusulat ng mga script para sa bawat senaryo. XCTest ay naka-embed sa Xcode, ngunit hindi awtomatikong namamahala ng lokalisasyon. Firebase Test Lab ay nagpapatakbo ng mga test sa totoong device sa cloud, na nagbibigay ng maximum na coverage, ngunit nangangailangan ng pagbabayad bawat minuto.

Ang Screengrab ay nananalo dahil sa kombinasyon: Fastlane ang namamahala sa buong life cycle ng build — mula sa compilation hanggang sa publikasyon. Google Play ay direktang tumatanggap ng folder structure ng Screengrab sa pamamagitan ng Fastlane deliver.

Mga karaniwang problema at solusyon

Sa pagtatrabaho sa Screengrab, ang mga developer ay madalas na nakakaranas ng ilang paulit-ulit na problema. Ang kaalaman sa mga karaniwang pagkakamali ay nagpapababa sa oras ng pag-debug sa unang pagtakbo.

Ang mga screenshot ay blangko o itim

Ang problema ay nangyayari kapag ang Screengrab ay kumukuha ng larawan bago matapos ang rendering ng screen. Solusyon — magdagdag ng pagkaantala Thread.sleep() bago tawagan ang screenshot() o gumamit ng IdlingResource mula sa Espresso para maghintay sa mga asynchronous na operasyon.

Error sa hindi pagkakatugma ng bersyon

Ang library na screengrab-lib ay dapat tumugma sa bersyon ng Fastlane. Fastlane ay ina-update buwan-buwan, at ang lumang library ay maaaring hindi sumusuporta sa mga bagong parameter ng configuration. Solusyon — i-synchronize ang mga bersyon sa pamamagitan ng Gemfile at gradle.properties.

Mahabang pagtakbo sa CI

Ang pagtakbo sa 30 wika sa 5 device ay maaaring tumagal ng mahigit isang oras. Solusyon — hatiin ang mga pagtakbo: isa para sa store sa lahat ng wika, isa para sa panloob na pangangailangan sa dalawang wika. GitHub Actions ay nagpapahintulot sa paggamit ng matrix ng mga diskarte para sa parallel na pagtakbo.

Mga problema sa emulator sa CI

Ang Android emulator ay nangangailangan ng hardware virtualization, na hindi laging available sa CI servers. KVM ay dapat na naka-enable, kung hindi ay hindi magsisimula ang emulator. Solusyon — gumamit ng x86 image na walang GPU acceleration o Firebase Test Lab.