InAppSettings 技术文档

1. 安装指南

1.1 添加 InAppSettings 到项目

1. 打开 Xcode，进入你的项目。
2. 将 InAppSettings 文件夹拖拽到你的项目中。
3. 确保弹出的对话框中勾选了“Copy items if needed”和“Create groups”，然后点击“Add”。

1.2 添加到源代码树（可选）

如果你计划在多个项目中使用 InAppSettings，可以将其添加到 Xcode 的源代码树中：

1. 打开 Xcode 的偏好设置（Preferences）。
2. 进入“Source Trees”选项卡。
3. 添加 InAppSettings 到源代码树中。
4. 再次将 InAppSettings 添加到项目时，确保勾选了“Add to targets”选项，然后点击“Add”。

2. 项目的使用说明

2.1 使用 InAppSettingsViewController

InAppSettingsViewController 是一个 UIViewController 的子类，用于显示 Settings.bundle 中的设置。

2.1.1 从代码中使用

#import "InAppSettings.h"

- (IBAction)showSettings {
    InAppSettingsViewController *settings = [[InAppSettingsViewController alloc] init];
    [self.navigationController pushViewController:settings animated:YES];
    [settings release];
}

2.1.2 从 Interface Builder 中使用

1. 在 Interface Builder 中，将任意 UIViewController 的类类型更改为 InAppSettingsViewController。
2. 确保 InAppSettingsViewController 被添加到一个现有的 UINavigationController 中。

2.2 使用 InAppSettingsModalViewController

InAppSettingsModalViewController 是一个 UIViewController 的子类，它创建了自己的 UINavigationController，并设计为模态视图使用。

2.2.1 从代码中使用

#import "InAppSettings.h"

- (IBAction)presentSettings {
    InAppSettingsModalViewController *settings = [[InAppSettingsModalViewController alloc] init];
    [self presentModalViewController:settings animated:YES];
    [settings release];
}

2.3 注册默认值

InAppSettings 提供了一个类方法 registerDefaults，用于初始化 Settings.bundle 中的用户默认值。

#import "InAppSettings.h"

+ (void)initialize {
    if ([self class] == [AppDelegate class]) {
        [InAppSettings registerDefaults];
    }
}

3. 项目API使用文档

3.1 InAppSettingsViewController

• 类名: InAppSettingsViewController
• 继承: UIViewController
• 功能: 显示 Settings.bundle 中的设置。
• 使用方式: 可以从代码或 Interface Builder 中使用。

3.2 InAppSettingsModalViewController

• 类名: InAppSettingsModalViewController
• 继承: UIViewController
• 功能: 创建自己的 UINavigationController，并设计为模态视图使用。
• 使用方式: 只能从代码中使用。

3.3 registerDefaults

• 方法名: registerDefaults
• 功能: 初始化 Settings.bundle 中的用户默认值。
• 使用方式: 在 AppDelegate 的 initialize 方法中调用。

4. 项目安装方式

4.1 手动安装

1. 下载 InAppSettings 项目文件。
2. 将 InAppSettings 文件夹拖拽到你的 Xcode 项目中。
3. 确保勾选“Copy items if needed”和“Create groups”，然后点击“Add”。

4.2 使用源代码树（可选）

1. 将 InAppSettings 添加到 Xcode 的源代码树中。
2. 在项目中引用 InAppSettings。

通过以上步骤，你可以成功安装并使用 InAppSettings 框架，轻松地在应用中显示设置界面。