GitLab 및 fastlane을 사용하여 App Store에 iOS 애플리케이션 게시

fastlane이 포함된 GitLab이 iOS 애플리케이션을 수집, 서명 및 App Store에 게시하는 방법.

우리는 최근에 Android 애플리케이션을 빠르게 구축하고 실행하는 방법에 대한 게시물 GitLab과 함께 빠른 차선. 여기서는 iOS 앱을 빌드 및 실행하고 TestFlight에 게시하는 방법을 살펴보겠습니다. 얼마나 멋진지 확인해 보세요. GitLab Web IDE를 사용하여 iPad Pro를 변경하고 있습니다., 어셈블리를 가져오고 이를 개발했던 동일한 iPad Pro에서 애플리케이션의 테스트 버전에 대한 업데이트를 받습니다.

여기서 우리는 걸릴 것입니다 Swift의 간단한 iOS 앱, 내가 비디오를 녹화한 사람입니다.

Apple Store 구성에 대한 몇 마디

모든 것을 하나로 묶으려면 App Store 앱, 배포 인증서 및 프로비저닝 프로필이 필요합니다.

여기서 가장 어려운 것은 App Store에서 서명 권한을 설정하는 것입니다. 나는 당신이 이것을 스스로 알아낼 수 있기를 바랍니다. 처음 오신 분이라면 올바른 방향을 알려드리겠습니다. 하지만 여기서는 Apple 인증서 관리의 복잡성에 대해 언급하지 않겠습니다. 인증서는 끊임없이 변화하고 있습니다. 이 게시물은 시작하는 데 도움이 될 것입니다.

나의 앱들

구성을 위한 ID를 가지려면 App Store Connect에 앱이 필요합니다. .xcodebuild. 프로필과 애플리케이션 ID는 사용자에게 테스트 애플리케이션을 배포하기 위한 코드 빌드, 가격 및 가용성, TestFlight 구성을 결합합니다. 공개 테스트를 수행하지 마십시오. 소규모 그룹이 있고 설정이 쉽고 Apple의 추가 권한이 필요하지 않은 경우 비공개 테스트로 충분합니다.

초기화 프로필

앱 설정 외에도 Apple 개발자 콘솔의 인증서, 식별자 및 프로필 섹션에서 생성된 iOS 배포 및 개발 키가 필요합니다. 이러한 인증서는 모두 하나의 프로비저닝 프로필로 결합될 수 있습니다.

인증받을 사용자는 인증서를 생성할 수 있어야 합니다. 그렇지 않으면 다음 단계를 따르세요. 인증하고 한숨 오류가 표시됩니다.

다른 옵션

이 간단한 방법 외에도 인증서와 프로필을 구성하는 다른 방법이 있습니다. 따라서 다르게 일한다면 적응해야 할 수도 있습니다. 가장 중요한 것은 구성이 필요하다는 것입니다. .xcodebuild, 이는 필요한 파일을 가리키며 실행기가 실행되는 이름의 사용자를 위해 빌드 컴퓨터에서 키체인을 사용할 수 있어야 합니다. 디지털 서명에는 fastlane을 사용하고 있으며, 문제가 있거나 자세한 내용을 알고 싶으면 해당 세부 정보를 확인하세요. 디지털 서명에 관한 문서.

이 예에서는 접근 방식을 사용하고 있습니다. 인증하고 한숨하지만 실제 사용에는 아마도 더 적합할 것입니다. 일치.

GitLab 및 fastlane 준비

CI Runner 준비

이 모든 데이터를 수집한 후 MacOS 장치에서 GitLab 실행기 구성으로 이동합니다. 안타깝게도 iOS 앱은 MacOS에서만 만들 수 있습니다. 하지만 모든 것은 변할 수 있습니다. 이 분야에서 진전이 있을 것으로 예상된다면 다음과 같은 프로젝트를 주시하세요. xcbuild и 서명하다, 그리고 내부 업무 gitlab-ce#57576.

러너를 설정하는 것은 매우 간단합니다. 현재를 따르십시오 macOS에서 GitLab Runner 설정 지침.

메모. 실행자는 실행 가능한 프로그램을 사용해야 합니다. shell. 이는 컨테이너를 통하지 않고 사용자로 직접 작업하기 위해 macOS에서 iOS를 빌드하는 데 필요합니다. 당신이 사용하는 경우 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

Xcode가 빌드하는 데 필요한 키에 액세스하려면 이 호스트에서 Apple 키체인을 구성해야 합니다. 이를 테스트하는 가장 쉬운 방법은 빌드를 실행할 사용자로 로그인하여 수동으로 빌드해 보는 것입니다. 시스템에서 키체인 액세스를 요청하면 CI가 작동하도록 항상 허용을 선택합니다. 더 이상 키체인을 요구하지 않는지 확인하기 위해 처음 몇 개의 파이프라인에 들어가서 살펴보는 것이 좋습니다. 문제는 Apple이 자동 모드를 사용하는 것을 쉽게 만들지 않는다는 것입니다. 그러나 일단 사용하면 모든 것이 잘 될 것입니다.

패스 트레인 초기화

프로젝트에서 fastlane을 사용하려면 다음을 실행하세요. fastlane init. 그냥 따라 가라 fastlane 설치 및 실행 지침, 특히 다음에 대한 섹션에서 젬파일자동화된 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("[email protected]") # 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 서명 접근 방식과 관련 인증하고 한숨. 당신이 사용하는 경우 일치 아니면 뭐든지 변경하세요.

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

Все отлично! 필요에 따라 fastlane의 형식을 UTF-8로 설정했습니다., 전략을 사용하다 clone 프로그램 실행으로 shell, 각 어셈블리에 대해 깔끔한 작업 공간을 확보하고 간단히 호출합니다. flappybuild 위에서 본 것처럼 fastlane. 결과적으로 우리는 TestFlight에서 최신 어셈블리의 어셈블리, 서명 및 배포를 얻습니다.

또한 아티팩트를 가져와 어셈블리와 함께 저장합니다. 형식이니 참고하세요 .ipa 시뮬레이터에서 실행되지 않는 서명된 ARM 실행 파일입니다. 시뮬레이터에 대한 출력을 원하는 경우 이를 생성하는 빌드 대상을 추가한 다음 아티팩트 경로에 포함하면 됩니다.

기타 환경 변수

여기에는 모든 것이 작동하도록 하는 몇 가지 환경 변수가 있습니다.

FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD и FASTLANE_SESSION

App Store에서 인증하고 TestFlight에 업로드하려면 fastlane에 대한 인증이 필요합니다. 이를 수행하려면 CI에서 사용할 애플리케이션의 비밀번호를 생성하십시오. 세부 여기에.

XNUMX단계 인증이 있는 경우 변수를 생성하세요. FASTLANE_SESSION (거기에 지침이 있습니다).

FASTLANE_USER и FASTLANE_PASSWORD

그 인증하고 한숨 요청 시 초기화 프로필과 인증서를 호출하려면 변수를 설정해야 합니다. FASTLANE_USER и FASTLANE_PASSWORD. 세부 여기에. 다른 서명 방법을 사용하는 경우에는 필요하지 않습니다.

결론적으로

모든 것이 어떻게 작동하는지 볼 수 있습니다. 내 간단한 예에서.

이것이 GitLab 프로젝트에서 iOS 빌드 작업에 도움이 되었고 영감을 주었기를 바랍니다. 여기 또 있어요 CI 팁 만약을 대비해 fastlane을 위해. 당신은 사용하고 싶을 수도 있습니다 CI_BUILD_ID (증분 빌드의 경우) 자동으로 버전 증가.

fastlane의 또 다른 멋진 기능은 자동 스크린샷 App Store의 경우 설정이 매우 쉽습니다.

귀하의 경험을 댓글로 알려주고 iOS 앱 개발을 위한 GitLab 개선을 위한 아이디어를 공유해 주세요.

출처 : habr.com