[iOS/Swift] 개발환경 Debug/Release 구분하기 + Firebase Crashlytics 설정

안녕하세요!

iOS 앱의 개발을 완료한 후, 앱 스토어에 런칭하기 전에 Debug / Release 환경을 구분해서 개발서버와 실서버 각각 테스트 후 배포를 했습니다. API 서버와 Firebase (Auth, Storage, Crashlytics) 를 연동했기 때문에, 좀 더 복잡해서 고생했던 기억이 나네요 😅

• Debug 환경 (Dev) - 개발용 서버, DB, Firebase 프로젝트
• Release 환경 (Production) - 실제 서비스용 서버, DB, Firebase 프로젝트 

아래 내용들에 따라 Xcode 에서 개발 환경을 구분했습니다.

1. 개발 서버, 실 서버 URL 구분하기

2. 두 개의 Firebase 프로젝트를 DEBUG/RELASE 에 따라 구분하기

3. Firebase 프로젝트 URL 구분하기

4. Firebase Crashlytics 추가하기

---

1. 개발 서버, 실 서버 URL 구분하기

API 서버와 통신하기 위해 URL 관련된 정보를 저장한 구조체에 상수로 baseURL 값을 설정해주고 있는데요. 해당 값을 DEBUG 환경, RELEASE 환경에 따라 다른 값이 설정되도록 했습니다.

#if DEBUG
    static let baseURL = "개발용 API 서버 URL"
#else
    static let baseURL = "실서비스 API 서버 URL"
#endif

 

2. 두 개의 Firebase 프로젝트를 DEBUG/RELASE 에 따라 구분하기

API 서버와 더불어 Firebase 기능을 사용하고 있는데요. Firebase 프로젝트도 개발용 / 실서비스용 두 개로 구분을 해서 개발했습니다.

 

Firebase 프로젝트를 사용하기 위해서는 구성 파일인 GoogleService-Info.plist 를 프로젝트 내에 저장하고 있어야합니다. 두 개의 프로젝트를 사용하기 위해서는 각 프로젝트마다 구성 파일을 가지고 있어야하고, 앱이 빌드될 때 환경에 맞는 파일을 참조하도록 하면 됩니다.

Firebase 문서 [여러 프로젝트 구성]
구성 파일은 iOS의 경우 GoogleService-Info.plist, Android의 경우 google-services.json입니다. 이러한 파일을 옵션 객체(FIROption 또는 FirebaseOptions)로 읽으면 Firebase 애플리케이션 객체(FIRApp 또는 FirebaseApp)가 이 옵션 객체를 참조합니다.

 

 

Firebase 구성 파일을 저장할 때에는 파일명을 다르게 만들고 구분하거나, 파일명을 같게 하고 폴더로 구분해도 됩니다. 저는 후자의 방법을 택했어요!

Firebase multiple project

앱이 빌드될 때 환경에 맞는 파일을 참조하도록 Build Phases 에서 스크립트를 추가해줍니다. 아래 스크립트는 Debug / Release 환경에 따라 Firebase 구성 파일을 프로젝트의 루트 폴더에 복사를 수행합니다!

# Type a script or drag a script file from your workspace to insert its path.
case "${CONFIGURATION}" in
  "Debug" )
cp -r "$SRCROOT/Zerobin/FirebaseConfig/Dev/GoogleService-Info.plist" "${BUILT_PRODUCTS_DIR}/${PRODUCT_NAME}.app/GoogleService-Info.plist" ;;
  "Release" )
cp -r "$SRCROOT/Zerobin/FirebaseConfig/Main/GoogleService-Info.plist" "${BUILT_PRODUCTS_DIR}/${PRODUCT_NAME}.app/GoogleService-Info.plist" ;;
*)
;;
esac

 

3. Firebase 프로젝트 URL 구분하기

현재 앱에서는 Firebase Storage 를 통해 이미지를 관리하고 있습니다. 외부 라이브러리를 이용하기 위해 Firebase URL 을 통해 이미지를 접근하는 경우도 있어, URL 도 두개의 프로젝트를 구분해줘야 했어요.

 

Firebase Storage 에 저장된 파일의 URL 은 아래처럼 구분돼요.

"https://firebasestorage.googleapis.com/v0/b/\(projectID).appspot.com/o/\(fileName)?alt=media"

 

1번에서 개발서버, 실서버의 URL 을 구분하는 것과 비슷하게 코드를 작성해주면 됩니다! baseURL 과 query 사이에 파일 이름을 추가하기 위해서 각각 상수에 할당했습니다.

#if DEBUG
    static let projectId = "개발프로젝트ID"
#else
    static let projectId = "실서비스프로젝트ID"
#endif

static let baseURL = "https://firebasestorage.googleapis.com/v0/b/\(projectId).appspot.com/o/"
static let query = "?alt=media"

 

4. Firebase Crashlytics 추가하기

iOS 앱의 크래쉬(비정상 종료)를 수집하기 위해서 Firebase Crashlytics 기능을 연동했습니다. 해당 기능은 Debug 모드에서는 이용되지 않고, Release 모드에서만 이용이 가능합니다. 시작하는 방법에 대해서는 Firebase 문서를 참고해주세요!

 

Build Phase 에 아래 스크립트를 추가해줍니다. 2번에서 생성한 스크립트가 실행된 이후에 실행될 수 있도록 순서를 설정해주세요. 

# Type a script or drag a script file from your workspace to insert its path.
if [ "${CONFIGURATION}" != "Debug" ]; then
    "${PODS_ROOT}/FirebaseCrashlytics/run"
    "${PODS_ROOT}/FirebaseCrashlytics/upload-symbols" -gsp ${BUILT_PRODUCTS_DIR}/${PRODUCT_NAME}.app/GoogleService-Info.plist -p ios ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}
fi

이후, 앱을 강제 종료하는 코드를 추가해서 Crashlytics 가 잘 작동되는지 확인하시면 됩니다. (코드는 꼭 제거해주세요!!)

---

👣 참고 링크

2개 이상의 개발 환경을 구분하는 방법

• [Hanulyun] (iOS) Multiple Configurations 로 Debug, Release 구분해 배포하기 — 1

Firebase Crashlytics 를 이용해서 프로젝트 구분하는 방법

• [LET me lOg] Multiple Firebase Configuration 설정하기
• [Hanulyun] Google-Service-Info.plist 파일 여러개 사용하기