ការបោះពុម្ពកម្មវិធី iOS ទៅ App Store ជាមួយ GitLab និង fastlane

របៀបដែល GitLab ជាមួយ fastlane ប្រមូល ចុះហត្ថលេខា និងបោះផ្សាយកម្មវិធី iOS ទៅកាន់ App Store ។

ថ្មីៗនេះយើងមាន ប្រកាសអំពីរបៀបបង្កើត និងដាក់ឱ្យដំណើរការកម្មវិធីបានយ៉ាងឆាប់រហ័ស Android ជាមួយ GitLab និង fastlane ។. នៅទីនេះយើងនឹងឃើញពីរបៀបបង្កើត និងដំណើរការកម្មវិធី iOS ហើយបោះផ្សាយវាទៅ TestFlight។ ពិនិត្យមើលថាតើវាឡូយប៉ុណ្ណា ខ្ញុំកំពុងធ្វើការផ្លាស់ប្តូរនៅលើ iPad Pro ជាមួយ GitLab Web IDEខ្ញុំយកការជួបប្រជុំគ្នា ហើយទទួលបានការអាប់ដេតទៅកំណែសាកល្បងនៃកម្មវិធីនៅលើ iPad Pro ដូចគ្នាដែលខ្ញុំបានបង្កើតវា។

នៅទីនេះយើងនឹងយក កម្មវិធី iOS សាមញ្ញនៅលើ Swiftដែលខ្ញុំបានថតវីដេអូជាមួយ។

ពាក្យពីរបីអំពីការកំណត់រចនាសម្ព័ន្ធ Apple Store

យើងនឹងត្រូវការកម្មវិធី App Store វិញ្ញាបនបត្រចែកចាយ និងកម្រងព័ត៌មាននៃការរៀបចំ ដើម្បីភ្ជាប់អ្វីៗគ្រប់យ៉ាងជាមួយគ្នា។

អ្វី​ដែល​ពិបាក​បំផុត​នៅ​ទីនេះ​គឺ​ការ​បង្កើត​សិទ្ធិ​ចុះ​ឈ្មោះ​ក្នុង​ App Store។ ខ្ញុំសង្ឃឹមថាអ្នកអាចដោះស្រាយរឿងនេះដោយខ្លួនឯង។ ប្រសិនបើអ្នកថ្មី ខ្ញុំនឹងចង្អុលបង្ហាញអ្នកក្នុងទិសដៅត្រឹមត្រូវ ប៉ុន្តែយើងនឹងមិននិយាយអំពីភាពស្មុគ្រស្មាញនៃការគ្រប់គ្រងវិញ្ញាបនបត្រ Apple នៅទីនេះទេ ហើយពួកគេកំពុងផ្លាស់ប្តូរជានិច្ច។ ប្រកាសនេះនឹងជួយអ្នកចាប់ផ្តើម។

កម្មវិធីរបស់ខ្ញុំ

អ្នកត្រូវការកម្មវិធីនៅក្នុង App Store Connect ដូច្នេះអ្នកមាន ID សម្រាប់ការកំណត់រចនាសម្ព័ន្ធ .xcodebuild. ប្រវត្តិរូប និងលេខសម្គាល់កម្មវិធីរួមបញ្ចូលគ្នានូវការបង្កើតកូដ តម្លៃ និងភាពអាចរកបាន និងការកំណត់រចនាសម្ព័ន្ធ TestFlight សម្រាប់ចែកចាយកម្មវិធីសាកល្បងដល់អ្នកប្រើប្រាស់។ កុំធ្វើតេស្តជាសាធារណៈ ការធ្វើតេស្តឯកជននឹងគ្រប់គ្រាន់ ប្រសិនបើអ្នកមានក្រុមតូច ការដំឡើងងាយស្រួល ហើយមិនត្រូវការការអនុញ្ញាតបន្ថែមពី Apple។

កម្រងព័ត៌មានការចាប់ផ្តើម

បន្ថែមពីលើការដំឡើងកម្មវិធី អ្នកត្រូវការការចែកចាយ និងគន្លឹះអភិវឌ្ឍន៍ប្រព័ន្ធប្រតិបត្តិការ iOS ដែលបង្កើតនៅក្នុងផ្នែក វិញ្ញាបនបត្រ អត្តសញ្ញាណ និងទម្រង់នៃកុងសូលអ្នកអភិវឌ្ឍន៍ Apple ។ វិញ្ញាបនបត្រទាំងអស់នេះអាចត្រូវបានបញ្ចូលគ្នាទៅក្នុងទម្រង់ផ្តល់។

អ្នកប្រើប្រាស់ដែលនឹងត្រូវបានផ្ទៀងផ្ទាត់ត្រូវតែអាចបង្កើតវិញ្ញាបនបត្រ បើមិនដូច្នេះទេ ជំហាន cert និងដកដង្ហើមធំ អ្នកនឹងឃើញកំហុស។

ជម្រើសផ្សេងទៀត

ក្រៅពីវិធីសាស្រ្តសាមញ្ញនេះ មានវិធីផ្សេងទៀតដើម្បីកំណត់រចនាសម្ព័ន្ធវិញ្ញាបនបត្រ និងទម្រង់។ ដូច្នេះ ប្រសិនបើអ្នកធ្វើការខុសគ្នា អ្នកប្រហែលជាត្រូវសម្របខ្លួន។ អ្វីដែលសំខាន់បំផុតនោះគឺថាអ្នកត្រូវការការកំណត់រចនាសម្ព័ន្ធ .xcodebuildដែលនឹងចង្អុលទៅឯកសារចាំបាច់ ហើយ keychain ត្រូវតែមាននៅលើកុំព្យូទ័រ build សម្រាប់អ្នកប្រើប្រាស់ក្រោមឈ្មោះរបស់អ្នកដែលជាអ្នករត់ការ។ សម្រាប់ហត្ថលេខាឌីជីថល យើងប្រើ fastlane ហើយប្រសិនបើមានបញ្ហា ឬអ្នកចង់ដឹងបន្ថែម សូមពិនិត្យមើលព័ត៌មានលម្អិតរបស់វា។ ឯកសារអំពីហត្ថលេខាឌីជីថល.

ក្នុងឧទាហរណ៍នេះខ្ញុំកំពុងប្រើវិធីសាស្រ្ត cert និងដកដង្ហើមធំប៉ុន្តែ​សម្រាប់​ការ​ប្រើ​ប្រាស់​ពិត​ប្រាកដ​ប្រហែល​ជា​ស័ក្តិសម​ជាង ការប្រកួត.

កំពុងរៀបចំ GitLab និង fastlane

កំពុងរៀបចំ CI Runner

ដោយបានប្រមូលទិន្នន័យទាំងអស់នេះ យើងបន្តទៅការកំណត់រចនាសម្ព័ន្ធកម្មវិធីរត់ GitLab នៅលើឧបករណ៍ MacOS ។ ជាអកុសល អ្នកអាចបង្កើតកម្មវិធី iOS នៅលើ MacOS ប៉ុណ្ណោះ។ ប៉ុន្តែអ្វីគ្រប់យ៉ាងអាចផ្លាស់ប្តូរបាន ហើយប្រសិនបើអ្នករំពឹងថានឹងមានការរីកចម្រើននៅក្នុងតំបន់នេះ សូមតាមដានគម្រោងដូចជា xcbuild и សញ្ញានិងកិច្ចការផ្ទៃក្នុងរបស់យើង។ gitlab-ce #57576.

ការដំឡើងអ្នករត់ប្រណាំងគឺសាមញ្ញណាស់។ ធ្វើតាមបច្ចុប្បន្ន ការណែនាំសម្រាប់ការដំឡើង GitLab Runner នៅក្នុង macOS.

ចំណាំ។ អ្នករត់ត្រូវប្រើកម្មវិធីដែលអាចប្រតិបត្តិបាន។ shellនេះត្រូវបានទាមទារសម្រាប់ការបង្កើត iOS នៅក្នុង macOSដើម្បីធ្វើការដោយផ្ទាល់ជាអ្នកប្រើប្រាស់ ជាជាងតាមរយៈកុងតឺន័រ។ ប្រសិនបើអ្នកប្រើ shellការសាងសង់ និងការធ្វើតេស្តត្រូវបានអនុវត្តជាអ្នកប្រើប្រាស់រត់ការដោយផ្ទាល់នៅលើម៉ាស៊ីនសាងសង់។ វាមិនមានសុវត្ថិភាពដូចកុងតឺន័រទេ ដូច្នេះសូមរកមើលប្រសើរជាង ឯកសារសុវត្ថិភាពដូច្នេះអ្នកមិននឹកអ្វីទាំងអស់។

sudo curl --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-darwin-amd64
sudo chmod +x /usr/local/bin/gitlab-runner
cd ~
gitlab-runner install
gitlab-runner start

Apple Keychain ត្រូវតែកំណត់រចនាសម្ព័ន្ធនៅលើម៉ាស៊ីននេះជាមួយនឹងការចូលប្រើសោដែល Xcode ត្រូវការដើម្បីបង្កើត។ មធ្យោបាយងាយស្រួលបំផុតដើម្បីសាកល្បងនេះគឺដើម្បីចូលជាអ្នកប្រើប្រាស់ដែលនឹងដំណើរការការស្ថាបនា ហើយព្យាយាមបង្កើតវាដោយដៃ។ ប្រសិនបើប្រព័ន្ធស្នើសុំការចូលប្រើ keychain សូមជ្រើសរើស Always Allow សម្រាប់ CI ដើម្បីដំណើរការ។ វាអាចមានតម្លៃក្នុងការចូលទៅមើលបំពង់បង្ហូរប្រេងដំបូងពីរ ដើម្បីប្រាកដថាពួកគេមិនបានសុំ keychain ទៀតទេ។ បញ្ហាគឺថា Apple មិនធ្វើឱ្យយើងងាយស្រួលប្រើ Auto mode នោះទេ ប៉ុន្តែនៅពេលដែលអ្នកដំណើរការវា អ្វីៗនឹងដំណើរការល្អ។

fastlane init

ដើម្បីប្រើ fastlane ក្នុងគម្រោង សូមដំណើរការ fastlane init. គ្រាន់តែធ្វើតាម ការណែនាំសម្រាប់ការដំឡើង និងដំណើរការ fastlaneជាពិសេសនៅក្នុងផ្នែកអំពី Gemfileដោយសារតែយើងត្រូវការការបើកដំណើរការលឿន និងអាចព្យាករណ៍បានតាមរយៈបំពង់ CI ស្វ័យប្រវត្តិ។

នៅក្នុងថតគម្រោងរបស់អ្នក សូមដំណើរការពាក្យបញ្ជាទាំងនេះ៖

xcode-select --install
sudo gem install fastlane -NV
# Alternatively using Homebrew
# brew cask install fastlane
fastlane init

fastlane នឹងស្នើសុំការកំណត់រចនាសម្ព័ន្ធមូលដ្ឋាន ហើយបន្ទាប់មកបង្កើតថត fastlane នៅក្នុងគម្រោងដែលមានឯកសារបី៖

1. fastlane/Appfile

មិនមានអ្វីស្មុគស្មាញនៅទីនេះទេ។ គ្រាន់តែត្រូវប្រាកដថា Apple ID និង App ID របស់អ្នកត្រឹមត្រូវ។

app_identifier("com.vontrance.flappybird") # The bundle identifier of your app
apple_id("your-email@your-domain.com") # Your Apple email address

2. fastlane/Fastfile

Fastfile កំណត់ជំហាននៃការសាងសង់។ យើងប្រើមុខងារភ្ជាប់មកជាមួយរបស់ fastlane ជាច្រើន ដូច្នេះអ្វីៗក៏ច្បាស់នៅទីនេះផងដែរ។ យើងបង្កើតបន្ទាត់មួយដែលទទួលបានវិញ្ញាបនបត្រ ដំណើរការការជួបប្រជុំគ្នា ហើយបង្ហោះវាទៅ TestFlight។ អ្នកអាចបែងចែកដំណើរការនេះទៅជាកិច្ចការផ្សេងៗប្រសិនបើចាំបាច់។ ប្រតិបត្តិការទាំងអស់នេះ (get_certificates, get_provisioning_profile, gym и upload_to_testflight) ត្រូវបានរួមបញ្ចូលរួចហើយនៅក្នុង fastlane ។

សកម្មភាព get_certificates и get_provisioning_profile ទាក់ទងនឹងវិធីសាស្រ្តចុះហត្ថលេខា cert និងដកដង្ហើមធំ. ប្រសិនបើអ្នកកំពុងប្រើ ការប្រកួត ឬអ្វីក៏ដោយ ធ្វើការផ្លាស់ប្តូរ។

default_platform(:ios)

platform :ios do
  desc "Build the application"
  lane :flappybuild do
    get_certificates
    get_provisioning_profile
    gym
    upload_to_testflight
  end
end

3. fastlane/Gymfile

នេះជាឯកសារស្រេចចិត្ត ប៉ុន្តែខ្ញុំបានបង្កើតវាដោយដៃដើម្បីផ្លាស់ប្តូរថតលទ្ធផលលំនាំដើម ហើយដាក់លទ្ធផលនៅក្នុងថតបច្ចុប្បន្ន។ នេះជួយសម្រួល CI ។ បើចាប់អារម្មណ៍សូមអានអំពី gym និងប៉ារ៉ាម៉ែត្ររបស់វានៅក្នុង ឯកសារ.

https://docs.fastlane.tools/actions/gym/

Наш .gitlab-ci.yml

ដូច្នេះ យើង​មាន​អ្នក​រត់​ការ​ CI សម្រាប់​គម្រោង ហើយ​យើង​ត្រៀម​ខ្លួន​ជា​ស្រេច​ក្នុង​ការ​សាកល្បង​បំពង់​បង្ហូរ​ប្រេង។ សូមមើលអ្វីដែលយើងមាននៅក្នុង .gitlab-ci.yml:

stages:
  - build

variables:
  LC_ALL: "en_US.UTF-8"
  LANG: "en_US.UTF-8"
  GIT_STRATEGY: clone

build:
  stage: build
  script:
    - bundle install
    - bundle exec fastlane flappybuild
  artifacts:
    paths:
    - ./FlappyBird.ipa

Всеотлично! យើងកំណត់ទម្រង់ UTF-8 សម្រាប់ fastlane តាមតម្រូវការប្រើយុទ្ធសាស្ត្រ clone ជាមួយនឹងការអនុវត្តកម្មវិធី shellដើម្បីឱ្យយើងមានកន្លែងធ្វើការស្អាតសម្រាប់ការជួបប្រជុំគ្នា ហើយគ្រាន់តែហៅទូរសព្ទទៅ flappybuild fastlane ដូចដែលបានឃើញខាងលើ។ ជាលទ្ធផល យើងទទួលបានការជួបប្រជុំ ហត្ថលេខា និងការដាក់ពង្រាយសន្និបាតចុងក្រោយបង្អស់នៅក្នុង TestFlight ។

យើងក៏ទទួលបានវត្ថុបុរាណ ហើយរក្សាទុកវាជាមួយការជួបប្រជុំគ្នា។ សូមចំណាំថាទម្រង់ .ipa គឺជាការប្រតិបត្តិ ARM ដែលមានចុះហត្ថលេខា ដែលមិនដំណើរការនៅក្នុងម៉ាស៊ីនក្លែងធ្វើ។ ប្រសិនបើ​អ្នក​ចង់​បាន​លទ្ធផល​សម្រាប់​កម្មវិធី​ក្លែង​ធ្វើ អ្នក​គ្រាន់តែ​បន្ថែម​គោលដៅ​បង្កើត​ដែល​បង្កើត​វា ហើយ​បន្ទាប់​មក​បញ្ចូល​វា​ក្នុង​ផ្លូវ​វត្ថុបុរាណ។

អថេរបរិស្ថានផ្សេងទៀត។

មានអថេរបរិស្ថានពីរបីនៅទីនេះ ដែលធ្វើឲ្យអ្វីៗដំណើរការបាន។

FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD и FASTLANE_SESSION

ការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវសម្រាប់ fastlane គឺតម្រូវឱ្យផ្ទៀងផ្ទាត់នៅក្នុង App Store ហើយបង្ហោះទៅកាន់ TestFlight ។ ដើម្បីធ្វើដូចនេះបង្កើតពាក្យសម្ងាត់សម្រាប់កម្មវិធីដែលនឹងត្រូវបានប្រើនៅក្នុង CI ។ ព័ត៌មានលម្អិត នៅទីនេះ.

ប្រសិនបើអ្នកមានការផ្ទៀងផ្ទាត់ពីរកត្តា បង្កើតអថេរមួយ។ FASTLANE_SESSION (ការណែនាំនៅទីនោះ) ។

FASTLANE_USER и FASTLANE_PASSWORD

ថា cert និងដកដង្ហើមធំ ហៅថាទម្រង់ចាប់ផ្តើម និងវិញ្ញាបនបត្រតាមការស្នើសុំ អ្នកត្រូវកំណត់អថេរ FASTLANE_USER и FASTLANE_PASSWORD. ព័ត៌មានលម្អិត នៅទីនេះ. នេះមិនចាំបាច់ទេ ប្រសិនបើអ្នកកំពុងប្រើវិធីចុះហត្ថលេខាផ្សេង។

នៅក្នុងសេចក្តីសន្និដ្ឋាន

អ្នកអាចមើលពីរបៀបដែលវាដំណើរការទាំងអស់។ នៅក្នុងឧទាហរណ៍សាមញ្ញរបស់ខ្ញុំ.

ខ្ញុំសង្ឃឹមថាវាមានប្រយោជន៍ និងបំផុសគំនិតអ្នកឱ្យធ្វើការជាមួយ iOS បង្កើតនៅក្នុងគម្រោង GitLab ។ នេះគឺជាមួយទៀត គន្លឹះ CI សម្រាប់ fastlane គ្រាន់តែក្នុងករណី។ អ្នកប្រហែលជាចង់ប្រើ CI_BUILD_ID (សម្រាប់ការបង្កើតបន្ថែម) ទៅ បង្កើនកំណែដោយស្វ័យប្រវត្តិ.

ចំណុចពិសេសមួយទៀតរបស់ fastlane គឺ រូបថតអេក្រង់ដោយស្វ័យប្រវត្តិ សម្រាប់ App Store ដែលមានភាពងាយស្រួលក្នុងការដំឡើង។

ប្រាប់យើងនៅក្នុងមតិយោបល់អំពីបទពិសោធន៍របស់អ្នក និងចែករំលែកគំនិតរបស់អ្នកសម្រាប់ការកែលម្អ GitLab សម្រាប់ការអភិវឌ្ឍន៍កម្មវិធី iOS ។

ប្រភព: www.habr.com