Swift: як використовувати прапори PREPROCESSOR (наприклад, `#if DEBUG`) для реалізації ключів API?

Question 1

У Objective-Cце іноді корисно використовувати статичні рядкові константи для визначення альтернативних ключів API (наприклад, диференціюється між RELEASE і ключами DEBUG для аналітичних пакетів, як MixPanel, Flurry або Crashlytics):

#if DEBUG
static NSString *const API_KEY = @"KEY_A";
#else
static NSString *const API_KEY = @"KEY_B";
#endif

і потім...

[Analytics startSession:API_KEY];

Як це перекладається на Swift, оскільки компілятор Swift більше не використовує препроцесор?

Question 2

Apple включила повну підтримку прапорців препроцесора Swift станом на Xcode 8 , тому більше не потрібно встановлювати ці значення в "Інші прапорці Swift".

Новий параметр називається "Умови активної компіляції", який забезпечує підтримку на найвищому рівні еквівалента Swift прапорців препроцесора. Ви використовуєте його точно так само, як і "Інші швидкі прапори", за винятком того, що немає необхідності додавати значення до "-D" (так це просто трохи чистіше).

З приміток до випуску Xcode 8 :

Active Compilation Conditions- це новий параметр збірки для передачі прапорів умовної компіляції компілятору Swift. Кожен елемент значення цього параметра переходить до swiftc з префіксом -D, так само, як елементи Preprocessor Macrosпереходу до clang з однаковим префіксом. (22457329)

Ви використовуєте вищевказане налаштування так:

#if DEBUG
    let accessToken = "DebugAccessToken"
#else
    let accessToken = "ProductionAccessToken"
#endif

Question 3

ОНОВЛЕНО: Xcode 8 тепер підтримує це автоматично, див. Відповідь @ DanLoewenherz вище.

До Xcode 8 ви все ще могли використовувати макроси таким же чином:

#if DEBUG
let apiKey = "KEY_A"
#else
let apiKey = "KEY_B"
#endif

Однак, щоб їх підняв Swift, вам потрібно встановити "Інші прапорці Swift" у налаштуваннях збірки вашої цілі:

Відкрийте параметри побудови для своєї цілі
Шукати "інші швидкі прапори"
Додайте макроси, які ви хочете використовувати, перед ними -Dпрапор

Question 4

Для подальшого спостереження намагайтеся не зберігати ключі / секрети API у відкритому тексті у сховищі. Використовуйте систему управління секретами для завантаження ключів / секретів у змінні середовища користувача. В іншому випадку необхідний крок 1, якщо це прийнятно.

Помістіть "секрети" у файл відкритого тексту вище у сховищі, що додається
Створіть, ../set_keys.shщо містить список export API_KEY_A='<plaintext_key_aef94c5l6>'(використовуйте одну лапку, щоб запобігти оцінці)
Додайте сценарій запуску сценарію, який може, source ../set_keys.shі перемістіть його у верхню частину порядку виконання
У Налаштування збірки> Препроцесорні макроси додайте до необхідних параметрів, таких як API_KEY_A="$API_KEY_A"

Це фіксує змінну середовища у визначенні компілятора, яке згодом використовується у кожному виклику дзвінків для кожного вихідного файлу.

Приклад структури каталогів

[10:33:15] ~/code/memo yes? tree -L 2 .
.
├── Memo
│   ├── Memo
│   ├── Memo.xcodeproj
│   ├── Memo.xcworkspace
│   ├── Podfile
│   ├── Podfile.lock
│   └── Pods
└── keys

Question 5

У швидких пакетах ви повинні робити це всередині swiftSettingsаргументу .targetу своєму Package.swiftфайлі. Використовуйте defineметод (документація Apple) або документацію Swift

targets: [
.target(name: String,
            dependencies: [Target.Dependency],
            path: String?,
            exclude: [String]?,
            sources: [String]?,,
            cSettings: [CSetting]?,
            cxxSettings: [CXXSetting]?,
            swiftSettings: [SwiftSetting]?,
            linkerSettings: [LinkerSetting]?),

Моя виглядає так, і це працює!

            swiftSettings: [
               .define("VAPOR")
            ]

у своєму коді я можу умовно скомпілювати за допомогою цього:

#if VAPOR