Setting up fastlane

첫번째로, Terminal을 열고 cd 명령어로 mZone 프로젝트로 이동합니다. 예를들어, 데스크탑 폴더에 mZone 파일을 위치했다면 다음과같이 명령어를 사용할수 있습니다.

cd ~/Desktop/mZone 

작업 디렉토리로서 mZone을 설정합니다.

mZone 폴더에서 다음 명령어를 입력합니다.

fastlane init

Note: permission denined에러를 얻었다면, 명령어 맨 앞에 sudo를 함께 입력합니다.

다음으로 시작처리 하기 위해 Apple ID를 입력합니다.

fastlane는 deliver를 사용하여 itunes Connect, Apple Developer Portal에 로그인하고 일치하는 앱 식별자로 계정에 있는 앱을 확인합니다. 이 앱은 새로운 앱이기 때문에 존재 하지 않기때문에 만들어야합니다.

Note: 아래와같은 에러를 받았다면

Connection reset by peer - SSL_Connect

fastlane이 제안한 ruby version을 으로 업데이트 해야합니다.

이미 rbenv, rvm(Ruby 버전관리자)을 사용하고 있지 않다면, 가장 쉬운 방법은 Homebrew를 사용하는 것입니다.

먼저 터미널에 명령어를 입력하여 Homebrew를 설치하세요.

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

다음으로 brew커맨드를 사용하여 Ruby를 설치합니다

brew update && brew install ruby

Homebrew는 brew link --overwrite ruby해야한다고 말해줍니다. 그리고 새로운 터미널 새션을 여는것이 필요합니다. 그후 fastlane을 특정 위치 지정없이 재설치합니다.

sudo gem install fastlane --verbose

마지막으로 fastlane init을 다시 실행하면 iTunes Connect에서 애플리케이션을 다시 만들수 있습니다.

다음과 같은 메시지를 봐야합니다.

This app identifier doesn't exist on iTunes Connect yet, it will be created for you
This app identifier doesn't exist on the Apple Developer Portal yet, it will be created for you
Please confirm the above values (y/n)

감지된 값을 확인하려면 y를 입력하세요.

iTunse Connect(지금은 App Store Connect)에서 이미 mZone Poker라는 앱을 만들었으므로 다음 메시지가 표시됩니다.

It looks like that mZone Poker has already been taken by someone else, please enter an alternative App Name:

고유한 앱 이름을 입력하세요(번들 ID에 대한 추천과 마찬가지고 mZone Poker와, @, .을 사용하여 고유한 애플리케이션 이름을 사용하는것이 좋습니다. 얼마후(30초-30분 정도가 소요됨..) 앱이 iTunes Connect에서 생성 되었음을 알게 됩니다.

mZone project folder를 엽니다. 프로젝트는 fastlane 폴더를 가진걸 주의해야합니다.

관계된 파일은 다음과 같습니다

• Appfile: app identifier, Apple ID를 저장합니다.
• Fastfile: 특정 동작을 호출하려고 생성한 lanes을 관리합니다.
• Deliverfile: App Store에 앱을 재출할때 요구된 메타 데이터를 추가할수 있습니다.

mZone 프로젝트 폴더 이내에서, fastlane/metadata로 이동합니다. 설명(description), 키워드, 카테고리, 등등 일반적인 App Store 항목들을 포함하는 많은 텍스트 파일을 볼수 있습니다. 이 파일들은 App Store에 보여지는 앱의 메타 데이터 정보로 설정하는데 사용 됩니다.

en-US/description.txt를 열고 다음 txt를 추가하세요.

mZone is a simple poker calculator for No Limit Texas Hold’em tournaments that displays a recommended course of action based on your chip count and the current big blind level.

그리고 keywords.txt에 다음 텍스트를 추가합니다

Poker, Cards, Gambling

name.txt에 이미 앱의 이름을 포함하고 있는지 확인하고 난후 http://www.raywenderlich.com이걸 privacy_url.txt 와 support_url.txt에 입력합니다.

이 애플리케이션은 프랑스어와, 영어를 모두 지원하지만, en-US 폴더만 존재합니다.

이 문제를 해결하려면 간단하게 fr-FR이라는 복사본 폴더를 만듭니다. 이 fastlane 튜토리얼을 짧게하기 위해 실제 프랑스어 번역을 제공하지 않습니다. 프로젝트 폴더는 이제 다음과 같이 보입니다.

다음으로, 메타 데이터 폴더에서

• copyright.txt을 열고 Copyright (c) 2016 Razeware LLC을 추가합니다.
• primary_category.txt을 열고 Games를 추가합니다
• primary_first_sub_category.txt을 열고 Card를 추가합니다
• primary_second_sub_category.txt을 열고 Casino를 추가합니다.

그후, 같은 폴더에서, 좋아하는 text/code 편집기를 사용하여 itunes_rating_config.json이라고 명명된 json파일을 생성하고 다음을 포함합니다.

{
  "CARTOON_FANTASY_VIOLENCE": 0,
  "REALISTIC_VIOLENCE": 0,
  "PROLONGED_GRAPHIC_SADISTIC_REALISTIC_VIOLENCE": 0,
  "PROFANITY_CRUDE_HUMOR": 0,
  "MATURE_SUGGESTIVE": 0,
  "HORROR": 0,
  "MEDICAL_TREATMENT_INFO": 0,
  "ALCOHOL_TOBACCO_DRUGS": 0,
  "GAMBLING": 2,
  "SEXUAL_CONTENT_NUDITY": 0,
  "GRAPHIC_SEXUAL_CONTENT_NUDITY": 0,
  "UNRESTRICTED_WEB_ACCESS": 0,
  "GAMBLING_CONTESTS": 0
}

이 iTunes 등급 구성은 모든 규약에서 가장된 도박(값이 2)만 빈번/강렬(frequent/intense) 제약이 포함되어 있다고 iTunes Connect가 알게 합니다.

마지막으로 App Stroe icon을 다운로드하고, 메타 데이터를 디렉토리에 추가합니다.

축하해! 제출에 필요한 모든 메타 데이터를 추가했습니다.

이제 fastlane을 사용할때입니다.

여기에서 fastlane 세팅을 위한 모든 키 리스트들을 찾을수 있습니다.

# This is the minimum version number required.

# Update this, if you use features of a newer version

default_platform :ios

platform :ios do

  # 1
  desc "Creating a code signing certificate and provisioning profile"
  # 2
  lane :provision do
    # 3
    produce(
      app_name: 'YOUR_UNIQUE_APP_NAME',
      language: 'English',
      app_version: '1.0',
      sku: '123abc'
    )
    # 4
    cert
    # 5
    sigh(force: true)
  end

  error do |lane, exception|
  # This block is called if there was an error running a lane.
  end

end

fastlane provision

fastlane snapshot init

# A list of devices you want to take the screenshots from
devices([
  "iPhone 5",
  "iPhone 6",
  "iPhone 6 Plus"
])

# A list of supported languages
languages([
  'en-US',
  'fr-FR'
])

# Where should the resulting screenshots be stored?
output_directory "./fastlane/screenshots"

# Clears previous screenshots
clear_previous_screenshots true

# Latest version of iOS
ios_version '10.1'

Open your Xcode project and make sure to do the following:
1) Add a new UI Test target to your project
2) Add the ./fastlane/SnapshotHelper.swift to your UI Test target
   You can move the file anywhere you want
3) Call `setupSnapshot(app)` when launching your app

    let app = XCUIApplication()
    setupSnapshot(app)
    app.launch()

4) Add `snapshot("0Launch")` to wherever you want to create the screenshots

  // 1
  let app = XCUIApplication()
  setupSnapshot(app)
  app.launch()

  // 2
  let chipCountTextField = app.textFields["chip count"]
  chipCountTextField.tap()
  chipCountTextField.typeText("10")
  // 3
  let bigBlindTextField = app.textFields["big blind"]
  bigBlindTextField.tap()
  bigBlindTextField.typeText("100")
  // 4
  snapshot("01UserEntries")    
  // 5
  app.buttons["what should i do"].tap()
  snapshot("02Suggestion")   

  desc "Take screenshots"
  lane :screenshot do
    snapshot
  end

fastlane screenshot

desc "Create ipa"
  lane :build do
    increment_build_number
    gym
  end

fastlane build

desc "Upload to App Store"
  lane :upload do
    deliver
  end

fastlane upload

desc "Upload to App Store and submit for review"
  lane :upload do
    deliver(
      submit_for_review: true
    )
  end

# 1
price_tier 0

# 2
app_review_information(
  first_name: "YOUR_FIRST_NAME",
  last_name: "YOUR_LAST_NAME",
  phone_number: "YOUR_PHONE_NUMBER",
  email_address: "YOUR_EMAIL_ADDRESS",
  demo_user: "N/A",
  demo_password: "N/A",
  notes: "No demo account needed"
)

# 3
submission_information({    
    export_compliance_encryption_updated: false,
    export_compliance_uses_encryption: false,
    content_rights_contains_third_party_content: false,
    add_id_info_uses_idfa: false
})

# 4
automatic_release false

# 5
app_icon './fastlane/metadata/AppIcon.png'

# 6
app_rating_config_path "./fastlane/metadata/itunes_rating_config.json"

fastlane upload

desc "Provision, take screenshots, build and upload to App Store"
  lane :do_everything do
    provision
    screenshot
    build
    upload
  end

fastlane do_everything