Bundle 是 Swift 和 Objective-C 中用于访问资源和模块的类。它表示一个资源包，通常用于加载应用程序中嵌入的文件和数据（如图片、JSON 文件、音频文件、故事板等）。
在 iOS 和 macOS 应用中，每个应用都会被打包为一个 Bundle，称为 主包 (Main Bundle)。
Bundle 的核心功能
Bundle 提供了一种方便的方式来访问以下资源：
文件资源：如图片、JSON、音频、字体等文件。
本地化资源：支持多语言的 .strings 文件。
模块代码：动态加载其他动态库或框架。
主资源包 Bundle.main
Bundle.main 是指当前运行应用的主资源包，它包含应用程序的所有资源，例如图片、JSON 文件、声音文件、字体，以及 Info.plist 文件等。
特点：
每个 iOS 或 macOS 应用都有一个主资源包。
主资源包的目录结构是固定的，由 Xcode 在编译应用时自动生成。
通过 Bundle.main，可以方便地访问主资源包中的资源。
创建 Bundle
以下是创建Bundle的方法，其中常用的是访问主包获取资源。
1、主包 (Bundle.main)
表示当前运行应用的主资源包，通常用于访问应用中嵌入的资源。
let mainBundle = Bundle.main2、指定类的模块包 (Bundle(for:))
用于访问特定类所在的资源包，常用于加载动态库或自定义模块的资源。
let classBundle = Bundle(for: MyClass.self)特定类所在的资源包指的是，在某些情况下，资源可能不在主资源包中，而是存在于动态加载的模块、库或框架中（例如，CocoaPods 或其他第三方库的资源）。这时，可以通过 Bundle(for:) 方法找到特定类所在的资源包。
如果在自定义模块（如动态库或框架）中放置了资源文件，可以使用此方法访问这些资源。它会根据指定类 MyClass 的位置，找到该类所在的 Bundle，即MyClass 所在的框架的资源包。
3、通过资源文件路径获取 Bundle
指定资源所在的路径，创建对应的 Bundle 实例。
if let resourceBundle = Bundle(path: "/path/to/bundle") {
// 使用 resourceBundle
}尝试加载指定路径上的资源包 (Bundle)，如果成功，就可以通过 resourceBundle 访问该资源包中的文件或资源。
4、通过URL创建Bundle
Bundle(url:) 是 Swift 中 Bundle 类的一个初始化方法，用于通过一个 URL 创建或访问一个 Bundle 对象。
Bundle(url: URL)接受一个 URL 参数，表示一个资源包的路径。返回一个可选的 Bundle? 对象：如果路径有效且指向一个资源包，返回对应的 Bundle 对象。如果路径无效（例如路径不存在或不是资源包），返回 nil。
常用方法
以下是 Bundle 中常用的属性和方法：
1、查找文件路径/URL访问资源
1）path(forResource:ofType:)：返回资源在 bundle 中的路径（String?）。
2）url(forResource:withExtension:)：返回资源在 bundle 中的 URL（URL?）。
3）paths(forResourcesOfType:inDirectory:)：返回匹配类型的所有资源路径。
4）urls(forResourcesWithExtension:subdirectory:)：返回匹配扩展名的所有资源 URL。
示例：
// 获取路径
let path = Bundle.main.path(forResource: "config", ofType: "json")
// 获取 URL
let url = Bundle.main.url(forResource: "logo", withExtension: "png")
// 获取子目录中的资源
let pathInDir = Bundle.main.path(forResource: "pngquant", ofType: nil, inDirectory: "Tools")2、获取Bundle 信息（Info.plist 等）
1）infoDictionary：读取 Info.plist 内容为字典。
2）object(forInfoDictionaryKey:)：获取 Info.plist 中某个键的值。
3）bundleIdentifier：获取 Bundle ID。
4）bundlePath / resourcePath：获取 Bundle 路径或资源目录路径。
5）executablePath：获取主可执行文件路径。
示例：
// 获取应用程序的名称和版本:
let appName = Bundle.main.object(forInfoDictionaryKey: "CFBundleName") as? String
let appVersion = Bundle.main.object(forInfoDictionaryKey: "CFBundleShortVersionString") as? String
print("应用名称：\(appName ?? "未知")，版本：\(appVersion ?? "未知")")
// 访问 Info.plist 中的自定义键:
if let customValue = Bundle.main.object(forInfoDictionaryKey: "MyCustomKey") as? String {
print("自定义值：\(customValue)")
}3、本地化资源
1）localizedString(forKey:value:table:)：获取本地化字符串。
2）preferredLocalizations：获取用户首选语言。
3）localizations：获取支持的所有本地化语言。
4）path(forResource:ofType:inDirectory:forLocalization:)：查找特定语言下的资源路径。
示例：
let localized = Bundle.main.localizedString(forKey: "hello", value: nil, table: nil)4、其他高级功能
1）Bundle(identifier:)：获取指定 bundle ID 的 bundle 实例。
2）Bundle(url:)：从路径或 URL 加载自定义 bundle（插件、Framework）。
3）main：当前 App 的主 bundle。
4）allBundles：所有已加载的 bundle。
5）allFrameworks：所有已加载的 Framework bundle。
打包方式
1、直接添加到项目：
将 .bundle 文件拖入 Xcode 的项目结构。
确保其目标设置（Targets）包含主应用。
编译后，.bundle 文件会被嵌套在主资源包中。
2、通过第三方框架引入：
第三方框架通常会将资源封装在自己的 .bundle 中。
在编译时，这些 .bundle 会被嵌套在主资源包中。
常见用例
1、加载图片：
if let imagePath = Bundle.main.path(forResource: "icon", ofType: "png") {
let image = UIImage(contentsOfFile: imagePath)
}2、加载自定义字体：
if let fontPath = Bundle.main.url(forResource: "CustomFont", withExtension: "ttf"),
let fontData = try? Data(contentsOf: fontPath),
let font = CGDataProvider(data: fontData as CFData),
let newFont = CGFont(font) {
CTFontManagerRegisterGraphicsFont(newFont, nil)
}3、动态加载框架：
if let frameworkPath = Bundle.main.path(forResource: "MyFramework", ofType: "framework"),
let frameworkBundle = Bundle(path: frameworkPath) {
print("动态框架加载成功：\(frameworkBundle)")
}4、从主包中加载 JSON 文件并解析的完整示例：
import Foundation
struct Person: Codable {
let name: String
let age: Int
}
if let fileURL = Bundle.main.url(forResource: "data", withExtension: "json"),
let data = try? Data(contentsOf: fileURL) {
let decoder = JSONDecoder()
if let person = try? decoder.decode(Person.self, from: data) {
print("解析成功：\(person)")
} else {
print("解析失败")
}
} else {
print("文件未找到")
}总结
Bundle 是一个强大且灵活的工具，可以帮助开发者高效加载资源和访问应用信息。它在多语言支持、动态资源加载以及模块化开发中尤为重要。理解并善用 Bundle 将大幅提升开发效率和代码组织能力。
注意：在Xcode16中，可能无法通过path(forResource:ofType:inDirectory:)方法获取到子目录的文件：
let pathInDir = Bundle.main.path(forResource: "pngquant", ofType: nil, inDirectory: "Tools") // ❌获取文件失败在测试中发现，虽然Xcode创建子目录并在子目录中存放文件，但在打包后，实际的文件位置在Resources文件夹下：
/Contents/Resources/pngquant因此，使用不加inDirectory的方法来访问文件路径：
Bundle.main.path(forResource: "pngquant", ofType: nil) // 获取到文件扩展知识
path和url方法的区别
1）path(forResource:ofType:)返回的是一个String?类型，表示资源的绝对路径，用于文件系统路径操作或与非 URL 接口交互时使用。
try String(contentsOfFile: path, encoding: .utf8)通过String(contentsOfFile:)读取指定路径的文件内容。
还可以进行文件路径的拼接，使用FileManager做文件拷贝、移动等操作。
显示路径还便于定位文件的实际存储位置，方便调试和记录日志。
2）url(forResource:withExtension:)返回的是一个URL?类型，通常用于文件加载（如 Data(contentsOf:) 或 URLSession 的文件访问）。
if let resourceURL = Bundle.main.url(forResource: "example", withExtension: "json") {
do {
let data = try Data(contentsOf: resourceURL)
print("成功读取数据：\(data)")
} catch {
print("读取文件失败：\(error)")
}
}可以直接使用 Data(contentsOf:) 或其他方法从 URL 读取资源文件内容。
对于图片、音频等资源文件，直接使用 URL 进行加载：
if let imageURL = Bundle.main.url(forResource: "icon", withExtension: "png") {
let image = UIImage(contentsOfFile: imageURL.path)
print("图片已加载：\(String(describing: image))")
}还可以与系统 API 交互：某些系统 API 需要传递文件的 URL，而非路径字符串。例如：
if let audioURL = Bundle.main.url(forResource: "audio", withExtension: "mp3") {
let player = AVPlayer(url: audioURL)
player.play()
}WebView：加载 HTML 文件。
if let htmlURL = Bundle.main.url(forResource: "index", withExtension: "html") {
webView.load(URLRequest(url: htmlURL))
}
为什么资源不在主资源包中？
模块化开发：
当项目规模较大时，开发者可能会将资源拆分到独立的框架或动态库中，方便复用或隔离逻辑。
第三方框架：
第三方库（如 CocoaPods 或 Swift Package Manager 提供的库）通常会有自己的资源包，这些资源与库的代码在一起，但并不在主资源包中。
框架资源独立性：
资源与其使用的类放在一起（同一个 Bundle），便于管理和避免命名冲突。例如：
主资源包可能包含应用图标和主页面的资源。
第三方框架的资源包则可能包含专属图片或配置文件。
