Secret History: xcconfig files

Slides from presentation given at CocoaHeads Hamburg January 2017 meet up.

Transcript

1. SECRET HISTORY XCCONFIG FILES TONIGHT 8/7C XING
6. XCODE BUILD SYSTEM IS NOT IDEAL ! IMO !
7. BUT XCCONFIGS CAN HELP A LOT !
8. XCCONFIG > No actual documentation provided by Apple WRONG! > Best docs provided by Samantha Marshall (holds true) > Supplemental file that replaces build settings in Xcode projects
11. WHAT CAN IT DO? > Override build settings > Inherit values from existing settings: $(inherited) > Conditionally override > Import settings from other xcconfig files
12. OVERRIDING OTHER_LDFLAGS = -ObjC INHERIT OTHER_LDFLAGS = $(inherited) -framework Security
14. CONDITIONAL OVERRIDE > Conditions: sdk, arch, config, variant (?), dialect1 (?) GCC_PREPROCESSOR_DEFINITIONS[config=OmnitureTest] = $(inherited) OMNITURE_ENABLED=1 1 *: Google this one, you'll have a good !
15. INHERITANCE RULES 1. Platform defaults 2. Project file 3. xcconfig file for the Project file 4. Target 5. xcconfig file for the target file
16. VALUE ASSIGNMENT RULES 1. Platform defaults 2. xcconfig file for the Project file 3. Project file 4. xcconfig file for the target file 5. Target
17. VARIABLE SUBSTITUTION > String interpolation GCC_PREPROCESSOR_DEFINITIONS = $(inherited) CONFIGURATION_$(CONFIGURATION)=1 > Resolved for Debug configuration as: GCC_PREPROCESSOR_DEFINITIONS = $(inherited) CONFIGURATION_Debug=1
18. PYCONFIG GET IT ON GITHUB: SAMDMARSHALL/PYCONFIG ALSO ⭐
19. SYNTAX export (path) !include (path) setting SETTING_NAME (inherits/use) { for/if (condition) and (another condition) { (value) } }
20. EXAMPLE export "xing.xcconfig" !include "default.xcconfig" setting OTHER_LDFLAGS inherits { for Debug { -lz, -framework "Reveal" } for Release }
21. RESULT #include "default.xcconfig" OTHER_LDFLAGS_Debug = $(inherited) -lz -framework "Reveal" OTHER_LDFLAGS_Release = $(inherited) OTHER_LDFLAGS = $(inherited) $(OTHER_LDFLAGS_$(CONFIGURATION))
22. USE: VARIABLE SUBSTITUTION setting PRODUCT_NAME use WRAPPER_EXTENSION { for app { "My App" } for xctest { "Unit Test Bundle" } for bundle { "Generic Bundle" } }
23. RESULT PRODUCT_NAME_app = "My App" PRODUCT_NAME_xctest = "Unit Test Bundle" PRODUCT_NAME_bundle = "Generic Bundle" PRODUCT_NAME = $(PRODUCT_NAME_$(WRAPPER_EXTENSION))
24. IF: CONDITIONAL ASSIGNMENT setting PRODUCT_NAME { if arch=i386 { libIntel32 } if arch=x86_64 { libIntel64 } if arch=armv7 { libArm32 } if arch=arm64 { libArm64 } }
25. RESULT PRODUCT_NAME[arch=i386] = libIntel32 PRODUCT_NAME[arch=x86_64] = libIntel64 PRODUCT_NAME[arch=armv7] = libArm32 PRODUCT_NAME[arch=arm64] = libArm64
26. DEMO
27. ADVANTAGES > DSL is more readable that legacy plist format > Less changes in xcodeproj file_size = targets * configuration
28. DISADVANTAGES > Restart Xcode to apply xcconfig changes (! dup.) > Migration could be some effort xcodebuild -showBuildSettings
29. OTHER TOOLS > jcampbell05/xcake: DSL for Xcode projects > facebook/buck: build system used at Facebook