七牛云Objective-C SDK使用手册

七牛云Objective-C SDK使用手册

objc-sdkQiniu Resource (Cloud) Storage Objective-C SDK for Mac/iOS项目地址:https://gitcode.com/gh_mirrors/ob/objc-sdk

1. 项目目录结构及介绍

七牛云的Objective-C SDK位于GitHub仓库，其主要目录结构和各部分功能如下：

.
├── Example                # 示例应用程序，用于演示如何使用SDK
│   ├── AppDelegate.h/m     # 应用委托文件
│   └── ...                # 其它示例文件
├── Qiniu                   # 主要SDK源码目录
│   ├── Classes            # 包含了所有核心类和接口实现
│       ├── Auth           # 认证相关类
│       ├── Client         # 客户端操作类，如上传、下载等
│       ├── ...             # 更多相关子目录和类文件
│   ├── QiniuDefines.h      # SDK中使用的宏定义
│   └── ...                # 其他SDK组件
├── Pods                    # 当使用CocoaPods安装时，会生成或引用依赖的第三方库
├── README.md               # 项目说明文件
└── Qiniu.podspec          # CocoaPods的规格文件，用于发布到Specs仓库

2. 项目的启动文件介绍

在集成七牛云Objective-C SDK时，并没有一个明确的“启动文件”需要手动触发。通常，集成过程涉及以下步骤：

• 在你的主项目中引入SDK，如果是通过CocoaPods，则会在Podfile中添加类似pod 'Qiniu', '~> 8.8.0'的依赖。
• 导入必要的头文件，一般在需要使用SDK功能的文件顶部添加#import <Qiniu/QNUploadManager.h>或其他相关头文件。
• 初始化七牛云的配置，比如设置access key和secret key，这通常在应用启动时完成，例如在AppDelegate.m文件中的application:didFinishLaunchingWithOptions:方法内。

QNConfiguration *config = [[QNConfiguration alloc] init];
[QNClient configureWithConfiguration:config];

3. 项目的配置文件介绍

七牛云Objective-C SDK本身不直接提供一个显式的配置文件让你编辑。配置主要通过代码进行，具体包括SDK初始化时设置的QNConfiguration对象。这个对象允许你定制上传下载的策略、超时时间、缓存路径等。

如果你指的是在应用程序中集成SDK时的配置，通常涉及以下几个方面：

• CocoaPods的Podfile：是用于指定依赖库及其版本的配置文件。
• Info.plist：虽然不是SDK直接提供的，但在某些情况下可能需要在此文件中添加URL Scheme或隐私权限声明，以便SDK正确运行或遵守苹果的隐私政策。

在实际开发中，你还需要根据七牛云的官方文档调整和配置访问密钥(Access Key)和密钥(Secret Key)，这些并非物理文件上的配置，而是程序初始化时的代码配置部分。确保这些关键信息的安全保管，避免硬编码在源代码中，通常推荐通过服务器来下发这些敏感信息。

objc-sdkQiniu Resource (Cloud) Storage Objective-C SDK for Mac/iOS项目地址:https://gitcode.com/gh_mirrors/ob/objc-sdk