MDMCoreData 开源项目使用手册

1. 目录结构及介绍

MDMCoreData 是一个旨在简化 iOS 和 OS X 上 Core Data 使用的框架。以下是其主要的目录结构及其简介：

.
├── Classes                 # 核心类文件夹，包含了如 MDMPersistenceController, MDMFetchedResultsTableDataSource 等核心类。
│   ├── MDMPersistenceController.m/.h
│   ├── MDMFetchedResultsTableDataSource.m/.h
│   └── ...                    # 其他相关类文件
├── Example                 # 示例工程，用于快速上手和理解如何使用MDMCoreData。
│   ├── AppDelegate.*        # 启动时进行Core Data配置的地方
│   ├── ViewController.*    # 展示MDMCoreData使用的视图控制器
│   └── ...                    # 示例工程其他文件
├── LICENSE                 # 许可证文件，声明MIT许可协议
├── MDMCoreData.podspec     # CocoaPods 的规格文件，便于通过CocoaPods安装该库
├── README.md               # 项目说明文档，详细介绍项目功能和使用方法
└── Supporting Files       # 支持性文件，可能包括一些全局配置或额外资源

2. 项目的启动文件介绍

在 Example 目录下的 AppDelegate 文件是项目启动的关键点。在这里，您会找到关于 Core Data 堆栈初始化的核心代码。AppDelegate 中通常会初始化 MDMPersistenceController，这是MDMCoreData框架中设置高效Core Data堆栈的主要方式。例如：

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // 初始化MDMPersistenceController
    NSURL *storeURL = [[self applicationDocumentsDirectory] URLByAppendingPathComponent:@"MDMCoreData.sqlite"];
    NSURL *modelURL = [[NSBundle mainBundle] URLForResource:@"MDMCoreData" withExtension:@"momd"];
    self.persistenceController = [[MDMPersistenceController alloc] initWithStoreURL:storeURL modelURL:modelURL];
    
    return YES;
}

这段代码负责设置SQLite存储类型，并连接到数据模型。

3. 项目的配置文件介绍

MDMCoreData项目本身没有单独的配置文件概念，其配置主要是通过代码来实现的，尤其是在 MDMPersistenceController 的初始化过程中。然而，如果您考虑到数据模型作为配置的一部分，那么.xcdatamodeld文件是关键。这个文件位于你的Xcode项目里，通常是Example目录下或者其他指定的数据模型路径中，它定义了所有NSManagedObjects的实体和关系，是Core Data的基础配置。

数据模型的配置过程涉及添加或编辑实体、属性以及它们之间的关系，这些操作在Xcode的Core Data Model Editor中完成，而不是通过外部文本或配置文件来进行。

最后，虽然本项目不直接使用传统意义上的配置文件（如JSON、XML等），但通过CocoaPods的.podspec文件来控制依赖版本和分发也是间接的“配置”形式之一，确保了库的正确版本和依赖管理。

---

此文档提供了对MDMCoreData项目结构的基本认识和重点组件的简述，帮助开发者快速理解和使用该项目。