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-эквивалента флагов препроцессора. Вы используете его точно так же, как и «Other Swift Flags», за исключением того, что нет необходимости добавлять значение с помощью «-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 мог их подобрать, вам необходимо установить «Other Swift Flags» в настройках сборки вашей цели:

Откройте настройки сборки для вашей цели
Искать "другие быстрые флаги"
Добавьте макросы, которые хотите использовать, перед -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"

Это фиксирует переменную среды в определении компилятора, которое позже используется при каждом вызове clang для каждого исходного файла.

Пример структуры каталогов

[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