Settings Bundles Management in Xcode

栏目: IT技术 · 发布时间: 4年前

内容简介:What is aWith the current state of iOS app development, almost always we will have multiple build configurations such as debug, beta, and release. Or we might even have multiple app targets within an Xcode project for various purposes.With the situation me

What is a Settings bundle ? A Settings bundle is a special kind of bundle provided by Apple to allow developers to add their app preferences into the iOS Settings app.

With the current state of iOS app development, almost always we will have multiple build configurations such as debug, beta, and release. Or we might even have multiple app targets within an Xcode project for various purposes.

With the situation mentioned above, how should one go about loading the desired Settings bundle for the respective build configuration?

In this article, let’s look into how we should manage the Settings bundles in the following situations:

  1. Load Settings bundle only for debug configuration.
  2. Load different Settings bundles for debug and release configuration.
  3. Load different Settings bundles for different app targets.

The Concept Behind Settings Bundle

Before we start getting into Settings bundles management, let’s have a quick look at the concept behind Settings bundle.

Settings bundle is considered as resources of the app bundle. Every time when you build your project, Xcode will copy the Settings bundle into the app bundle and the iOS Settings app will display the app preferences based on the Settings bundle.

The following diagram illustrates the workflow behind the scene when you build your Xcode project.

Settings Bundles Management in Xcode
The concept behind settings bundle

By understanding the concept behind Settings bundle, you should be able to follow along with this tutorial without any problem.

Load Settings Bundle Only for Debug Configuration

Sometimes you might want to expose certain app preferences in the iOS Settings app just for testing or debugging purposes. However, this kind of app preferences should not be accessible to normal users.

In this kind of situation, you can include all those special app preferences into the Settings bundle and make the Settings bundle only available for debug configuration. To achieve that, you can run a shell script at the end of the Xcode build phases to delete the Settings bundle from the app bundle during a release build.

Adding Shell Script

Adding a shell script in the Xcode build phase is pretty easy. You can start by selecting your project in the project navigator. Open the “Build Phases” tab and click the “+” sign to add a new run script phase.

Settings Bundles Management in Xcode
Adding shell script

Copy and paste the following shell script into the scripting box so that it will run every time when Xcode builds your project.

BUILD_APP_DIR="$BUILT_PRODUCTS_DIR/$PRODUCT_NAME.app"

if [ $CONFIGURATION == "Release" ]; then
    rm -rf "$BUILD_APP_DIR/Settings.bundle"
fi

Basically what the above shell script does is to remove the Settings bundle ( Settings.bundle ) from the app bundle when the project is built with configuration named “Release”.

At this point, you might wonder where do these build configurations being defined. Head over to the project info tab, there you should see the “Configurations” section where it lists out all the build configurations available.

Settings Bundles Management in Xcode
List of Xcode build configurations

Switching Build Configuration for Testing

By default, when you build and run (⌘R) a project, the project will be built using the “Debug” configuration. Go ahead and run the project using the “Debug” configuration, you should see the Settings app showing all the app preferences defined in the Settings bundle.

Settings Bundles Management in Xcode
Displaying app preferences in iOS Settings app

Next, let’s switch the build configuration to “Release” by editing the app target scheme.

Settings Bundles Management in Xcode
Change build configuration

After changing the build configuration to “Release”, build and run your project again. This time you should not see any app preferences being added to the Settings app because the shell script has removed the Settings bundle from the app bundle.

Shell Script Debugging

If the shell script is not behaving as you expected, most probably the shell script is not getting the correct app bundle path. In this kind of situation, for debugging purposes, you can print out the BUILD_APP_DIR using the echo command.

Settings Bundles Management in Xcode
Using echo in shell script

You can check the printed out BUILD_APP_DIR value at Xcode report navigator.

Settings Bundles Management in Xcode
Shell script echo result

Lastly, if you found that the shell script is not taking effect even though you have updated it, cleaning the build folder (⇧⌘K) then rebuild the project should do the trick.

Load Different Settings Bundles for Debug and Release Configuration

Similar to the situation mentioned in the previous section, you want to enable certain app preferences just for debugging purposes. However, this time you do have some other end users related app preferences that you want to include in the release build.

In this kind of situation, you will have to create 2 Settings bundles, remove them from the “Copy Bundle Resources” build phase and then run a shell script to manually copy the respective Settings bundle to the app bundle.

Let’s say you have created 2 Settings bundles for your project as shown in the image below:

Settings Bundles Management in Xcode
Settings bundles for debug and release build configuration

Head over to the app target build phases tab and remove the 2 Settings bundles from the “Copy Bundle Resources” list.

Settings Bundles Management in Xcode
Remove Settings bundle from bundle resources

Lastly, copy the following shell script and paste it into the scripting box.

BUNDLE_DIR="$PROJECT_DIR/$PRODUCT_NAME/Settings Bundles"
BUILD_APP_DIR="$BUILT_PRODUCTS_DIR/$PRODUCT_NAME.app"

if [ $CONFIGURATION == "Release" ]; then
    # Copy Settings bundle in "Release" folder into the app bundle
    cp -rf "$BUNDLE_DIR/Release/Settings.bundle" "$BUILD_APP_DIR/Settings.bundle"
else
    # Copy Settings bundle in "Debug" folder into the app bundle
    cp -rf "$BUNDLE_DIR/Debug/Settings.bundle" "$BUILD_APP_DIR/Settings.bundle"
fi

Now, Go ahead and run your project in “Debug” or “Release” configuration and see the app preferences in the Settings app change accordingly.

Something to Take Note

The Settings bundle must be named as “ Settings.bundle ” in the app bundle, any other naming will not work and you won’t see your app being listed in the iOS Settings app.

If you bump into the following compiler error, most probably the path defined in the shell script is not pointing to the Settings bundle.

Command PhaseScriptExecution failed with a nonzero exit code
Settings Bundles Management in Xcode
Compiler error when copy Settings bundle with shell script

What you can do is to print out the respective path using echo and fix the problem accordingly.

Load Different Settings Bundles for Different App Targets

In the last section of this article, let’s look at how to manage multiple Settings bundles in a multiple app targets environment.

Let’s say you have an Xcode project with 2 app targets (Paid and Free). On top of that, each app target will have its own Settings bundle.

In order to let Xcode know which Settings bundle belongs to which target, you just need to set the Settings.bundle target membership correctly, then you are good to go.

Settings Bundles Management in Xcode
Assign Settings bundle to app target (free version)
Settings Bundles Management in Xcode
Assign Settings bundle to app target (paid version)

That’s it for managing Settings bundles in a multiple app targets environment. No shell script is required.

Wrapping Up

Managing Settings bundles is an easy task once you have understood how Xcode handles them in different kinds of environments. Just remember:

Settings.bundle

Further Readings

If you would like to learn more about using Settings bundle, you can check out this official documentation from Apple.

Implementing an iOS Settings Bundle

Besides, feel free to check out my some other articles related toXcode.

I hope you find this article helpful. What other situations do you think that this article should cover? Let me know in the comment section below or you can reach out to me on Twitter .

Thanks for reading. ‍:computer:


以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 码农网

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

京东技术解密

京东技术解密

京东研发体系 / 电子工业出版社 / 2014-11-18 / 65

京东高速的增长、闪电响应的供应链、庞大的团队规模等背后内幕,对于业界一直像谜一样神秘。随着成为中国B2C领导厂商以及在纳斯达克上市,京东越来越需要开放自己,与业界形成更好的交流与融合。《京东技术解密》的面世,就是京东技术团队首次向业界集体亮相。本书用翔实的内容为读者逐一解答——如何用技术支撑网站的综合竞争实力,如何把握技术革新的时间点,如何应对各种棘手问题及压力,如何在网站高速运转的情况下进行系统......一起来看看 《京东技术解密》 这本书的介绍吧!

JS 压缩/解压工具
JS 压缩/解压工具

在线压缩/解压 JS 代码

JSON 在线解析
JSON 在线解析

在线 JSON 格式化工具

URL 编码/解码
URL 编码/解码

URL 编码/解码