iOS开发:使用Settings Bundle为程序添加自定义设置项

Settings Bundle是在自己的程序中建立的一组文件,利用它可以告诉设备中的Settings程序我们写的程序有哪些设置项。用户在Settings程序中设置好相关相关选项后回到我们自己的程序,自己的程序中的对应项也会发生相应的变化。

在iOS程序中,用户默认项,即上面所说的设置项,是用NSUserDefaults类实现的。在NSUserDefaults类中使用关键字来读取和存储设置项的具体数据,就像NSDictionary类一样,不同的是,NSUserDefaults类的数据是存储在文件系统中的,而不是作为一个对象实例放在内存中。

在这篇文章中,我们将创建一个程序,为它添加和配置Settings Bundle,之后可以在Settings程序中显示和配置相关选项。在Settings Bundle中使用plist文件来定义程序中允许的设置项,Settings程序会自动建立接口。Settings Bundle中的plist文件必须遵循特定的格式,不过Xcode会帮助我们遵循这种格式。

1、首先下载初始代码。http://www.oschina.net/code/snippet_164134_10458

由于我们的重点是Settings Bundle的使用,那么建立工程、实现页面跳转等等就不详细说明了。

2、解压Settings Bundle Test.zip,使用Xcode 4.3打开此工程,先打开FirstViewController.xib,使用IB向其中添加控件,如下图:

然后为这些标签向FirstViewController.h中建立Outlet映射:

3、打开MoreViewController.xib,向其中添加控件,如下:

然后,向MoreViewController.h中,为右边的两个Label以及UISlider与UISWitch控件创建Outlet映射,为UISlider与UISWitch控件添加Action映射:

然后在Attribute Insepector中设置UISlider控件最小值、最大值和默认值分别是0、10和5:

将准备好的两张图片添加到工程中,在Attribute Insepector中设置UISlider控件的Min Image与Max Image:

4、接下来,为程序建立Settings Bundle。依次选择File — New — File…,找到Settings Bundle:

单击Next,设置好名称和分组:

然后单击Create,则创建了Settings.bundle。

5、展开Settings.bundle,其中包含一个Root.plist。Settings程序中的显示项就是从Root.plist中获取的。

单击Root.plist以打开它,在空白处单击,选中Show Raw Keys/Values:

接下来,我们展开PreferenceSpecifiers那一项,删除除了Group之外的其他项。

PreferenceSpecifiers这个对应于刚打开Settings程序时第一页中该应用程序的一个标签,如果此时运行程序,然后在模拟器返回桌面,再打开Settings程序,则其中会出现Settings Bundle Test这一项:

上图中的Settings Bundle Test这一项就可以理解为是从PreferenceSpecifiers获取的。

6、展开PreferenceSpecifiers这一项,先向其中添加三行,每一行的设置如下:

此时运行程序,在Settings程序中单击上图中的Settings Bundle Test那一项,出现的页面如下图:

   

在Root.plist文件中,Item 0那一项的类型是PSGroupSpecifier,它表示一个分组,则它下面的每Item 1到Item 3都是在这一组,直到下一个PSGroupSpecifier出现。

Item 1与Item 2都是PSTextFieldSpecifier类型的,它们都是文本框,可以通过为其添加子项限制这些文本框的输入。

Item 3是一个多选框,可供选择的值是由Titles与Values决定的,Titles与Values这两项内容是一样的,但是缺一不可。

7、之后,再向其中添加Item 4到Item 7,如下图:

再运行程序,打开Settings程序看看:

   

8、之后,我们实现在上面左图的下方出现一项“更多设置”,单击此项跳转到新的页面。先创建一个plist文件,名称为MoreSettings.plist,创建方法就不说了吧,参考http://my.oschina.net/plumsoft/blog/42084第二步。注意现在只是创建到工程中而不是Settings.bundle中,想要加到Settings.bundle中还要其他操作,稍后详解。

右击Settings.bundle,选择Show in Finder:

然后在Finder中右击Settings.bundle,选择“显示包含内容”:

在打开的地方将MoreSettings.plist以及上面用到的两张图片拷贝进去。

9、编辑Settings.bundle中的MoreSettings.plist内容如下:

保存后,在Root.plist添加一行:

注意,Item 8的类型是通过选择其子选项Type的类型改变的。

此时运行程序,Settings程序如下:

   

10、接下来都是代码了。

10.1 在ViewController.h中添加代码:

#define kUserName @"username"
#define kPassWord @"password"
#define kGender @"gender"
#define kFavouriteColor @"favouritecolor"
#define kFavouriteSeason @"favouriteseason"
#define kFavouriteSport @"favouritesport"
#define kTheSlider @"theslider"
#define kTheSwitch @"theswitch"

10.2 在FirstViewController.h与MoreViewController.h中分别声明一个方法,名为

- (void)refreshFields;

在FirstViewController.m中添加代码如下:

- (void)refreshFields {
    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
    self.userNameLabel.text = [defaults objectForKey:kUserName];
    self.passWordLabel.text = [defaults objectForKey:kPassWord];
    self.genderLabel.text = [defaults objectForKey:kGender];
    self.colorLabel.text = [defaults objectForKey:kFavouriteColor];
    self.seasonLabel.text = [defaults objectForKey:kFavouriteSeason];
    self.sportLabel.text = [defaults objectForKey:kFavouriteSport];
}

在MoreViewController.m中添加代码如下:

- (void)refreshFields {
    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
    self.theSwitch.on = [defaults boolForKey:kTheSwitch];
    self.slider.value = [defaults floatForKey:kTheSlider];
    self.sliderValueLabel.text = [[defaults objectForKey:kTheSlider]stringValue];
}

10.3 实现MoreViewController.m中的sliderTapped与switchTapped方法如下:

- (IBAction)sliderTapped:(id)sender {
    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
    [defaults setFloat:self.slider.value forKey:kTheSlider];
    self.sliderValueLabel.text = [[defaults objectForKey:kTheSlider] stringValue];
    [defaults synchronize];
}
- (IBAction)switchTapped:(id)sender {
    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
    [defaults setBool:self.theSwitch.on forKey:kTheSwitch];
    [defaults synchronize];
}

10.4 在FirstViewController.m与MoreViewController.m中@end之前都添加代码:

- (void)applicationWillEnterForeground:(NSNotification *)notification {
    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
    [defaults synchronize];
    [self refreshFields];
}

10.5 在FirstViewController.m与MoreViewController.m的viewDidLoad方法中都添加代码:

[self refreshFields];
UIApplication *app = [UIApplication sharedApplication];
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(applicationWillEnterForeground:) name:UIApplicationWillEnterForegroundNotification object:app];

10.6 在FirstViewController.m与MoreViewController.m中的ViewDidUnload方法中都添加代码:

[[NSNotificationCenter defaultCenter] removeObserver:self];

11.7 在ViewController.m的viewDidLoad方法中的[super viewDidLoad];之前添加代码:

//注册默认项
NSDictionary *defaults = [NSDictionary dictionaryWithObjectsAndKeys:
                          [NSNumber numberWithBool:YES], kTheSwitch,
                          [NSNumber numberWithFloat:5.0], kTheSlider,
                          nil];
[[NSUserDefaults standardUserDefaults] registerDefaults:defaults];

11、运行,那么Settings Bundle Test程序中的数据将会随着Settings程序中的选项改变而改变,反过来也是。

例如,在Settings程序中设置如下:

   

返回Settings Bundle Test程序,显示如下:

   

不过,第一次运行程序时,单击“更多设置”按钮,Slider与Switch是变形的,然后才会显示正确的值:

真是好事多磨啊。

刚运行程序,第一次单击“更多设置”按钮就会出现上图情况。猜想是因为刚开始ViewController中的moreViewController为空,在页面跳转时才创建它。为此,试试在ViewController.m的viewDidLoad方法的最后一条语句之前添加代码:

self.moreViewController = [[MoreViewController alloc] initWithNibName:@"MoreViewController" bundle:nil]; 
self.moreViewController.viewController = self;

再运行试试,还是不行。那估计是跟页面跳转时的动态效果有关了。再把ViewController.m的switchViews方法修改如下:

- (void)switchViews {
    if (self.moreViewController.view.superview == nil) { 
        if (self.moreViewController == nil) { 
            self.moreViewController = [[MoreViewController alloc] initWithNibName:@"MoreViewController" bundle:nil]; 
            self.moreViewController.viewController = self;
        }
    } else { 
        if (self.firstViewController == nil) { 
            self.firstViewController = [[FirstViewController alloc] initWithNibName:@"FirstViewController" bundle:nil];
            self.firstViewController.viewController = self;
        } 
    }
    [UIView beginAnimations:@"View Flip" context:nil]; 
    [UIView setAnimationDuration:0.80]; 
    [UIView setAnimationCurve:UIViewAnimationCurveEaseInOut];
    if (self.moreViewController.view.superview == nil) { 
        [UIView setAnimationTransition: UIViewAnimationTransitionFlipFromRight forView:self.view cache:YES]; 
        [self.firstViewController.view removeFromSuperview];
        [self.view insertSubview:self.moreViewController.view atIndex:0]; 
    } else { 
        [UIView setAnimationTransition: UIViewAnimationTransitionFlipFromRight forView:self.view cache:YES]; 
        [self.moreViewController.view removeFromSuperview]; 
        [self.view insertSubview:self.firstViewController.view atIndex:0]; 
    } 
    [UIView commitAnimations]; 
}

再运行,问题总算解决了。

最终代码:http://www.oschina.net/code/snippet_164134_10484


以下是原作者与提问者的交互,很有帮助,一起粘来供大家学习:

评论17

  • 温少锋
    1楼: 温少锋  发表于  2012-06-12 17:57  回复此评论
    你好、、
    下载的那个初始项目与我的IOS模拟器不是一个版本的、、
    运行不了啊、、
    怎么办?
  • 双子座
    2楼: 双子座  发表于  2012-06-12 19:52  回复此评论
    引用来自“温少锋”的评论

    你好、、
    下载的那个初始项目与我的IOS模拟器不是一个版本的、、
    运行不了啊、、
    怎么办?

    升级XCode吧
  • 温少锋
    3楼: 温少锋  发表于  2012-06-13 10:45  回复此评论
    请问一下第8步创建MoreSettings.plist文件的是Mac OS X下的Property List还是IOS下的Preperty List,还有,第9步编辑Settings.bundle中的MoreSettings.plist的内容的文字全部是自己打进去的吗?跟Root.plist中怎么不一样。没有自动生成的、在这方面Xcode4.2和4.3有区别吗?谢谢、、
  • 温少锋
    4楼: 温少锋  发表于  2012-06-13 11:10  回复此评论
    引用来自“双子座”的评论

    引用来自“温少锋”的评论

    你好、、
    下载的那个初始项目与我的IOS模拟器不是一个版本的、、
    运行不了啊、、
    怎么办?

    升级XCode吧

    呵呵、、
    我的是黑苹果、、
    10.7.2的系统不支持4.3
    又不想浪费时间去弄系统、、
    所以还是算了吧、、谢谢
  • RiC
    5楼: RiC  发表于  2012-06-29 22:02  回复此评论
    setting.bundle里面拷贝不进去 新建的plist和先前的图片都不能放进去,楼主怎么放的
  • 双子座
    6楼: 双子座  发表于  2012-06-29 23:41  回复此评论
    引用来自“RiC”的评论

    setting.bundle里面拷贝不进去 新建的plist和先前的图片都不能放进去,楼主怎么放的

    不是在Xcode里拷贝的,而是Finder中
  • RiC
    7楼: RiC  发表于  2012-06-30 14:54  回复此评论
    引用来自“双子座”的评论

    引用来自“RiC”的评论

    setting.bundle里面拷贝不进去 新建的plist和先前的图片都不能放进去,楼主怎么放的

    不是在Xcode里拷贝的,而是Finder中

    恩 搞定 谢谢
  • cos于鹏飞
    8楼: cos于鹏飞  发表于  2012-07-05 18:30  回复此评论
    为啥创建Settings.bundle的时候不能重命名?我重命名的就都显示不出来,没有重命名而是使用系统默认命名的就成功了?
  • cos于鹏飞
    9楼: cos于鹏飞  发表于  2012-07-05 21:07  回复此评论
    总结一下我的问题,有几个问题补充一下还望解答
    <第4节>为什么创建Settings.bundle的时候不能重命名?,这里系统有默认吗?
    <第11.7节>为什么要把这个代码加载[super viewDidLoad];之前?我实验了一下,加载后面也是可以的,这里有什么规范或者什么注意点吗?
    <关于文章末尾的BUG>我仔细看了下这部分代码的区别,你怎么看待这个BUG?如下结论能否得出?:界面切换之前必须创建界面,否则会出现异常。
    但是很奇怪的是,在viewDidLoad()中添加了self.moreViewController的初始化之后,断点你的程序启动第一次翻页操作,无论修改前还是修改后,你switchViews()下的if (self.moreViewController == nil)这一句都是走不进去的,因为self.moreViewController 必然不为空,那么还会有区别呢?
  • 双子座
    10楼: 双子座  发表于  2012-07-17 22:06  回复此评论
    引用来自“cos于鹏飞”的评论

    总结一下我的问题,有几个问题补充一下还望解答
    <第4节>为什么创建Settings.bundle的时候不能重命名?,这里系统有默认吗?
    <第11.7节>为什么要把这个代码加载[super viewDidLoad];之前?我实验了一下,加载后面也是可以的,这里有什么规范或者什么注意点吗?
    <关于文章末尾的BUG>我仔细看了下这部分代码的区别,你怎么看待这个BUG?如下结论能否得出?:界面切换之前必须创建界面,否则会出现异常。
    但是很奇怪的是,在viewDidLoad()中添加了self.moreViewController的初始化之后,断点你的程序启动第一次翻页操作,无论修改前还是修改后,你switchViews()下的if (self.moreViewController == nil)这一句都是走不进去的,因为self.moreViewController 必然不为空,那么还会有区别呢?

    1、手机启动后,设置程序会找到每个程序的Settings.bundle,从而在设置程序中显示。所以,必须是Settings.bundle,不能用其他的名称
    2、我是习惯加在[super viewDidLoad];之前,大部分情况下随便,不过也有例外的时候
    3、最后一段代码,我印象中当时修改的是关于动态效果的代码,而对代码原来的结构没有改变。产生区别的是动态效果的代码。if (self.moreViewController == nil)是比较保险的写法,我看一本英文书中写的,当系统资源不足的时候,当前未使用的变量会被销毁。都过了很久了,有点忘了原文是怎么讲的了

  • 新风作浪
    11楼: 新风作浪  发表于  2012-07-20 16:54  回复此评论
    请问下,为什么我的Root.plist文件里面Item0里Type不能改成PSGroupSpecifier,而且改完后编程Group
  • 路上的问候
    12楼: 路上的问候  发表于  2012-07-26 16:48  回复此评论
    为什么我的slider就是不能在设置里显示吖?
  • 路上的问候
    13楼: 路上的问候  发表于  2012-07-27 17:02  回复此评论
    您好,我解决了以上问题,但是还有个问题:
    问下:我下载了你的代码,你代码中是 @class RootViewController;
    用按钮实现了两个视图的切换,
    在FirstViewController.h中 @class RootViewController;以及@property (strong, nonatomic) RootViewController *rootViewController_d;
    在FirstViewController.m中#import "RootViewController.h"以及@synthesize rootViewController_d;
    然后通过按钮的方法调用了RootViewController.h/.m中的switchViewsAction方法:
    - (IBAction)switchBTNaction:(id)sender{
      [self.rootViewController_d switchViewsAction];
      //NSLog(@"aaaaaa");
      }
    我调试怎么也进不了RootViewController.m中的switchViewsAction方法?????????
    但是不提示错误呀。

    我想不明白:FirstViewController.m只是声明一个RootViewController *rootViewController_d;
    是在哪里真正附值呢?
    我调试的也是:
    rootViewController_d  RootViewController *  0x00000000
  • 路上的问候
    14楼: 路上的问候  发表于  2012-07-27 17:27  回复此评论
    嘻嘻,把问题写出来了,确突然解决了。。
    是在RootViewController.m中有对rootViewController_d 的附值:
    self.secondViewController.rootViewController_second = self;
    self.firstViewController.rootViewController_first = self;
  • zk0301
    15楼: zk0301  发表于  2012-09-03 16:34  回复此评论
    iphone的settings还有那么古怪的功能,真心不习惯。管的太多了吧。汗~ 下一篇 冲啊
  • GlorySimba
    16楼: GlorySimba  发表于  2012-09-06 14:21  回复此评论
    谢谢博主的分享!
  • HeAnd
    17楼: HeAnd  发表于  2012-10-06 17:09  回复此评论
    成功,谢谢


  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值