SoFunction
Updated on 2025-04-03

iOS xcconfig writing sample tutorial

introduction

xcconfigThe syntax of a file is relatively simple. Each configuration file consists of a series of key-value assignments, which have the following syntax:

BUILD_SETTING_NAME = value

Comments

xcconfigThere is only one way to comment files, that is//。

include import other settings

CreatingxcconfigWhen you have files, you can create multiple files according to your needs. That means that it can be passedincludeImport keywords into otherxcconfigconfiguration within. passincludeFollow the keyword with double quotes, as follows:

#include ""

When searching for imported files, if/Starting with an absolute path, for example:

// Indicates the exact file location#include "/Users/ws/Desktop/LoginApp-Conflict/Pods/Target Support Files/Pods-LoginApp/"

Or through the relative path,${SRCROOT}The path is start:

#include "Pods/Target Support Files/Pods-LoginApp/"

variable

Variable definition, according toOCNaming rules, only by capital letters, numbers and underscores (_) group, in principle, capitalization, or not. The string can be"It can be'Number.

There are three special cases for variables:

  • existxcconfigvariables defined inBuild SettingsIf the same is true, then coverage will occur. Can be passed$(inherited), let the current variable inherit the original value of the variable. For example:
OTHER_LDFLAGS = -framework SDWebImage
OTHER_LDFLAGS = $(inherited) -framework AFNetworking
// OTHER_LDFLAGS = -framework SDWebImage -framework AFNetworking

Note ⚠️: Some variables cannot be passedxcconfigConfigure toBuild SettingsIn, for example: configurationPRODUCT_BUNDLE_IDENTIFIERNot working.

  • Reference variables,$()and${}Both writing methods are OK:
VALUE=Cat
TEACHER=$(VALUE)-${VALUE}
  • Condition variables, according toSDK、ArchandConfigrationCondition the settings, for example:
// Specify `Configration` is `Debug`// Specify `SDK` as an emulator, as well as iphoneos*, macosx*, etc.// Specify the effective structure as `x86_64`OTHER_LDFLAGS[config=Debug][sdk=iphonesimulator*][arch=x86_64]= $(inherited) -framework "Cat"

Note ⚠️:Xcode 11.4and later versions can be useddefault, to specify the default value when the variable is empty:

$(BUILD_SETTING_NAME:default=value)

Priority (from high to low)

  • Manual configurationTarget Build Settings
  • TargetConfigured inxcconfigdocument
  • Manual configurationProject Build Settings
  • ProjectConfigured inxcconfigdocument

The above is the detailed content of the sample tutorial for writing iOS xcconfig. For more information about writing iOS xcconfig, please pay attention to my other related articles!