Discovery 项目教程

Discovery 项目教程

Discovery A very simple library to discover and retrieve data from nearby devices (even if the peer app works at background). 项目地址: https://gitcode.com/gh_mirrors/disco/Discovery

1. 项目的目录结构及介绍

Discovery
├── DiscoveryExample.xcodeproj
├── DiscoveryExample
│   ├── DiscoveryExample
│   └── DiscoveryExampleTests
├── LICENSE
├── Podfile
├── Podfile.lock
├── README.md
└── screenshot2.png

目录结构介绍

• DiscoveryExample.xcodeproj: Xcode 项目文件，包含项目的配置和构建信息。
• DiscoveryExample: 项目的主要代码目录，包含应用程序的源代码和测试代码。
  • DiscoveryExample: 应用程序的主要源代码。
  • DiscoveryExampleTests: 应用程序的测试代码。
• LICENSE: 项目的开源许可证文件，采用 Apache-2.0 许可证。
• Podfile: CocoaPods 依赖管理文件，定义了项目所需的第三方库。
• Podfile.lock: CocoaPods 生成的锁定文件，记录了当前项目使用的第三方库的具体版本。
• README.md: 项目的说明文件，包含项目的概述、安装和使用说明。
• screenshot2.png: 项目的截图文件，展示了应用程序的界面。

2. 项目的启动文件介绍

项目的启动文件位于 DiscoveryExample/DiscoveryExample 目录下，主要包含应用程序的入口代码和初始化逻辑。以下是启动文件的主要内容：

// 创建 UUID
NSString *uuidStr = @"B9407F30-F5F8-466E-AFF9-25556B57FE99";
CBUUID *uuid = [CBUUID UUIDWithString:uuidStr];

__weak typeof(self) weakSelf = self;

// 启动 Discovery
self.discovery = [[Discovery alloc] initWithUUID:uuid username:self.username usersBlock:^(NSArray *users, BOOL usersChanged) {
    NSLog(@"Updating table view with users count : %d", users.count);
    weakSelf.users = users;
    [weakSelf.tableView reloadData];
}];

启动文件介绍

• UUID 创建: 通过 NSString 创建一个 UUID 字符串，并将其转换为 CBUUID 对象。
• Discovery 初始化: 使用 Discovery 类的 initWithUUID:username:usersBlock: 方法初始化 Discovery 实例。该方法接受 UUID、用户名和一个回调块，用于处理附近设备的发现和数据更新。
• 回调块: 当附近设备发生变化时，回调块会被调用，更新用户列表并刷新界面。

3. 项目的配置文件介绍

Podfile

Podfile 是 CocoaPods 的依赖管理文件，定义了项目所需的第三方库。以下是 Podfile 的内容：

platform :ios, '9.0'
use_frameworks!

target 'DiscoveryExample' do
  pod 'Discovery', '~> 1.0'
end

配置文件介绍

• 平台: 指定项目运行的 iOS 平台版本为 9.0 及以上。
• 使用框架: 启用 use_frameworks!，表示使用动态框架。
• 目标: 定义了项目的目标为 DiscoveryExample，并指定了依赖库 Discovery 的版本为 ~> 1.0，表示使用 1.0 及以上但不包括 2.0 的最新版本。

通过以上配置，项目可以正确地集成和使用 Discovery 库，实现附近设备的发现和数据交换功能。

Discovery A very simple library to discover and retrieve data from nearby devices (even if the peer app works at background). 项目地址: https://gitcode.com/gh_mirrors/disco/Discovery