iOS 프로젝트에 Fastlane 적용하면서 겪은 트러블슈팅 기록

Fastlane 적용할 때 필요한 사이트들

증명서, 프로파일 등 필요할 때
https://developer.apple.com/account

 

앱 암호 설정할 때
https://appleid.apple.com/

---

 

Shooooootig ⚽️

수많은 문제 중에 2가지 에러를 다루고자 한다!
 

🎯 Trouble 1

수많은 오류 중 하나-!

❌ /Users/leejinhee/Desktop/XCODEPROJECT/Team/meokQ-Admin-iOS/MatQ_Admin/Presentation/View/Notice/NoticeDetailView.swift:71:1: external macro implementation type 'PreviewsMacros.SwiftUIView' could not be found for macro 'Preview(_:body:)' #Preview {

The following build commands failed:SwiftCompile normal arm64 Compiling\ Market.swift,

 
 
‼️ Preview 땜에 아카이브를 못하고 있는 문제 발견 → 프리뷰 주석처리하고 fastlane 실행 테스트 → 아카이브 성공 !
 
 
프리뷰를 매번 지울 수는 없으니 해결방법을 찾아야겠단 맘으로 구글링을 시작했다.
확인해보니까 루비 명령어랑 터미널이 다른 아키텍처를 기반으로 실행되고 있던 것이다-!....
 
https://github.com/fastlane/fastlane/issues/21582
xcodebuild fails with #Preview macro with Xcode 15.0
 
친절한 설명 덕에 아래 순서로 진행해서 문제를 해결할 수 있었다.

휴-!!!!! 이거 해결하면서 빌드넘버가 50번을 넘어갔고, 해결하고 자고 싶어서 새벽 6시까지 밤을 새버렸다. 해결하니 광명을 찾은 기분이었다 🤩
 

 
1. arch 명령어를 실행 → i386 확인

arch i386

 
 
2. 아키텍처를 바꿔주자

arch -arm64 /bin/zsh arm64

 

 

🎯 Trouble  2

처음에 비밀번호를 앱 암호로 하지 않았다면, fastlane 도중에 암호가 다르다고 하며 배포에 실패한다. 
이전에 fastlane 적용할 때 .env 파일을 생성했던 것이 생각나서 아래과정을 거쳐 해결했다.
 
1. 앱 암호 생성
https://appleid.apple.com/ 사이트 하단 -  앱 암호 -  +버튼으로 암호 생성  - 앱 암호 확인

2. .env 파일 생성

3. aaaa-bbbb-cccc-dddd 이런 형태로 된 앱 암호를 .env 파일 내에 아래 코드를 수정해서 기입해주면 해결!!!!!

FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD=appleid에서 받은 앱 암호

 
 
 
 

🤩

 

---

Fastfile 코드

Fastfile실행을 위한 기본 스니펫 !

은 다음과 같이 저장해두었다. 

default_platform(:ios)

platform :ios do
  desc "Push a new beta build to TestFlight"
  lane :beta do
    get_certificates
    get_provisioning_profile
    #increment_build_number(xcodeproj: "MatQ_Admin.xcodeproj")
    increment_build_number(
      build_number: latest_testflight_build_number + 1
    )
    build_app(scheme: "MatQ_Admin", configuration: "Debug")

    upload_to_testflight
  end
end

 
 

최종 Fastfile

아래 첨부한 블로그를 참고해서 fastlane을 실행할 때 옵션으로 버전 정보를 직접 기입할 수 있도록 추가해두었다.

default_platform(:ios)

platform :ios do
  def updateVersion(options)
    if options[:version]
      version = options[:version]
    else
      version = prompt(text: "Enter the version type or specific version\n(major, minor, patch or 1.0.0): ")
    end

    re = /\d+.\d+.\d+/
    versionNum = version[re, 0]

    if (versionNum)
      increment_version_number(
        version_number: versionNum
      )
    elsif (version == 'major' || version == 'minor' || version == 'patch')
      increment_version_number(
        bump_type: version
      ) 
    else
      UI.user_error!("[ERROR] Wrong version!")
    end
  end

  desc "Push a new beta build to TestFlight"
  lane :beta do |options|
    updateVersion(options)

    get_certificates
    get_provisioning_profile

    increment_build_number(xcodeproj: "MatQ_Admin.xcodeproj")
    #increment_build_number(
    #   build_number: latest_testflight_build_number + 1
    #)

    build_app(scheme: "MatQ_Admin", configuration: "Debug")

    upload_to_testflight
  end
end

 
 
 

---

fastlane을 설치하고 적용하면서 Xcode Cloud로 CICD 구축하는게 정말!!! 편했구나 싶었다..,,,,,,

 
 
 

참고한 사이트와 출처 - !

https://docs.fastlane.tools/getting-started/ios/setup/
https://deku.posstree.com/ko/react-native/fastlane/