ExtendaBLE 项目教程
1. 项目的目录结构及介绍
ExtendaBLE 项目的目录结构如下:
ExtendaBLE/
├── ExtendaBLE/
│ ├── Models/
│ ├── Services/
│ ├── Characteristics/
│ ├── Utilities/
│ ├── Extensions/
│ ├── AppDelegate.swift
│ ├── Info.plist
│ └── README.md
├── Example/
│ ├── Example/
│ ├── Example.xcodeproj
│ └── Example.xcworkspace
├── LICENSE
└── README.md
目录介绍
- ExtendaBLE/: 主项目目录,包含核心代码和配置文件。
- Models/: 存放数据模型文件。
- Services/: 存放蓝牙服务相关的文件。
- Characteristics/: 存放蓝牙特征相关的文件。
- Utilities/: 存放工具类文件。
- Extensions/: 存放扩展类文件。
- AppDelegate.swift: 应用程序的入口文件。
- Info.plist: 应用程序的配置文件。
- README.md: 项目说明文档。
- Example/: 示例项目目录,包含示例代码和配置文件。
- Example/: 示例代码目录。
- Example.xcodeproj: Xcode 项目文件。
- Example.xcworkspace: Xcode 工作区文件。
- LICENSE: 项目许可证文件。
- README.md: 项目说明文档。
2. 项目的启动文件介绍
项目的启动文件是 AppDelegate.swift
,它负责应用程序的生命周期管理。以下是 AppDelegate.swift
的主要内容:
import UIKit
import ExtendaBLE
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
var window: UIWindow?
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
// 初始化蓝牙配置
BLE.shared.configure(withServices: [
BLEService(uuid: "YOUR_SERVICE_UUID", characteristics: [
BLECharacteristic(uuid: "YOUR_CHARACTERISTIC_UUID", permissions: .readable, properties: .read),
// 其他特征
])
// 其他服务
])
return true
}
// 其他生命周期方法
}
主要功能
- 初始化蓝牙配置: 在
application(_:didFinishLaunchingWithOptions:)
方法中,初始化蓝牙服务和特征。
3. 项目的配置文件介绍
项目的配置文件是 Info.plist
,它包含应用程序的配置信息。以下是 Info.plist
的主要内容:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>CFBundleDevelopmentRegion</key>
<string>en</string>
<key>CFBundleExecutable</key>
<string>$(EXECUTABLE_NAME)</string>
<key>CFBundleIdentifier</key>
<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
<key>CFBundleInfoDictionaryVersion</key>
<string>6.0</string>
<key>CFBundleName</key>
<string>$(PRODUCT_NAME)</string>
<key>CFBundlePackageType</key>
<string>APPL</string>
<key>CFBundleShortVersionString</key>
<string>1.0</string>
<key>CFBundleVersion</key>
<string>1</string>
<key>LSRequiresIPhoneOS</key>
<true/>
<key>UILaunchStoryboardName</key>
<string>LaunchScreen</string>
<key>UIMainStoryboardFile</key>
<string>Main</string>
<key>UIRequiredDeviceCapabilities</key>
<array>
<string>armv7</string>
</array>
<key>UISupportedInterfaceOrientations