ExtendaBLE 项目教程

ExtendaBLE 项目教程

ExtendaBLEBlocks Based Bluetooth LE Connectivity framework for iOS/watchOS/tvOS/OSX. Quickly configure centrals & peripherals, perform read/write operations, and respond characteristic updates.项目地址:https://gitcode.com/gh_mirrors/ex/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

ExtendaBLEBlocks Based Bluetooth LE Connectivity framework for iOS/watchOS/tvOS/OSX. Quickly configure centrals & peripherals, perform read/write operations, and respond characteristic updates.项目地址:https://gitcode.com/gh_mirrors/ex/ExtendaBLE