Windows Azure Toolkit for iOS (库)
Windows Azure Toolkit for iOS 是一款工具包,开发者可以使用它轻松地从原生 iOS 应用程序访问 Windows Azure 存储服务。该工具包可用于使用 Objective-C 和 XCode 开发的 iPhone 和 iPad 应用程序。
此工具包以两种方式工作 - 工具包可以直接访问 Windows Azure 存储或通过代理服务器进行访问。代理服务器代码与 Windows Azure WP7 工具包中使用的代码相同(可在[此处](#)找到),避免了开发者在设备上本地存储 Azure 存储凭据的需求。如果您计划使用代理服务器进行测试,您需要下载并部署在 GitHub 上提供的 cloudreadypackages 中的服务。
Windows Azure Toolkit for iOS 作为一个开源产品,在 Apache License,Version 2.0 下发布。
下载库
要下载库,请选择一个下载包(例如 v1.2.1)。下载的 zip 文件包含针对 iOS 4.3 的二进制文件,针对模拟器和设备。或者,您还可以下载源代码并自行编译版本。项目文件已设计为与 XCode 4 兼容。
日志记录
您可以通过设置运行时环境变量来在调试模式下使用库启用日志记录。进入您的项目架构,添加环境变量 WALogging,并将其设置为 YES,则日志信息将在控制台上打印。
将库应用于您的应用程序
Xcode 4.x(库)
- 打开 watoolkit-lib Xcode 项目。
- 为发布编译项目。
- 将 .a 文件和头文件放在您可以从项目引用的位置(对于这个例子,请假设置为 lib)。
- 在左侧侧栏中单击项目的名称,以打开窗口右侧面板中的项目设置视图。
- 在中部面板中,您将看到项目中的 项目 和 目标标题。单击项目名称,然后在上面的顶部选择 构建设置 以打开整个项目的构建设置编辑器。
- 找到 头文件搜索路径 设置。双击并添加新条目。将搜索路径添加到包含静态库头文件的目录,并选中
递归
复选框。同时将 /usr/include/libxml2
添加到搜索路径,并选中 递归
。
- 找到 库搜索路径 设置。双击并添加新条目。添加一个搜索路径到您项目库目录中的 libwatoolkitios.a 文件。
- 找到 其他链接器标志 项并双击它。使用 + 按钮添加新条目并输入
-ObjC -all_load
。点击 完成 按钮关闭编辑器。
- 在编辑器窗格中间的 TARGETS 列表中找到要添加 Windows Azure iOS 工具套件的条目。选择它以在窗口右侧打开目标设置编辑器。
- 点击窗口顶部的 构建阶段 选项卡以打开构建阶段编辑器。
- 点击 目标依赖项 和 链接库与二进制文件 项旁边的展开三角形。
- 在 目标依赖项 部分,点击 + 按钮打开目标选择表单。单击 libwatoolkitios.a 目标并单击 添加 按钮创建依赖项。
- 在 链接库与二进制文件 部分,点击 + 按钮打开库选择表单。在此我们需要指导目标链接到所有必需的 watoolkitios-lib 库和一个系统库。依次选择以下项目(一次选择一个,或者按住 Command 键一次性选择所有项目),然后点击 添加 按钮
- libwatoolkitios.a
- libxml2.2.dylib
- 在继续之前,请验证所有库是否都显示在 链接库与二进制文件 部分。
Xcode 4.x (Git 子模块)
- 添加子模块:
git submodule add git://github.com/WindowsAzure-Toolkits/wa-toolkit-ios.git watoolkitios
- 在 Xcode 中打开要添加 Windows Azure iOS 库的项目。
- 将焦点置于您的项目,选择“视图”菜单 > “导航器” > “项目”以显示项目文件列表。
- 从 Finder 中拖动 watoolkitios-ib.xcodeproj 文件并在您的 (您的项目名称).xcodeproj 上释放。
- 在左侧侧栏中单击项目的名称,以打开窗口右侧面板中的项目设置视图。
- 在中部面板中,您将看到项目中的 项目 和 目标标题。单击项目名称,然后在上面的顶部选择 构建设置 以打开整个项目的构建设置编辑器。
- 找到 头文件搜索路径 设置。双击并添加新条目。向
$(BUILT_PRODUCTS_DIR)
目录添加搜索路径,并选中 递归
复选框。同时将 /usr/include/libxml2
添加到搜索路径并选中 递归
。
-
注意:如果您不使用 DerivedData,则此步骤是必要的。
- 找到 库搜索路径 设置。双击并添加新条目。将搜索路径添加到您项目中添加的
"$(BUILT_PRODUCTS_DIR)/Build/$(BUILD_STYLE)-$(PLATFORM_NAME)"
目录。
- 找到 其他链接器标志 项并双击它。使用 + 按钮添加新条目并输入
-ObjC -all_load
。点击 完成 按钮关闭编辑器。
- 在编辑器窗格中间的 TARGETS 列表中找到要添加 Windows Azure iOS 工具套件的条目。选择它以在窗口右侧打开目标设置编辑器。
- 点击窗口顶部的 构建阶段 选项卡以打开构建阶段编辑器。
- 点击 目标依赖项 和 链接库与二进制文件 项旁边的展开三角形。
- 在 目标依赖项 部分,点击 + 按钮打开目标选择表单。单击 watoolkitios-lib 目标并单击 添加 按钮创建依赖项。
- 在 链接库与二进制文件 部分,点击 + 按钮打开库选择表单。在此我们需要指导目标链接到所有必需的 watoolkitios-lib 库和一个系统库。依次选择以下项目(一次选择一个,或者按住 Command 键一次性选择所有项目),然后点击 添加 按钮
- libwatoolkitios.a
- libxml2.2.dylib
- 在继续之前,请验证所有库是否都显示在 链接库与二进制文件 部分。
恭喜您,现在已完成将 Windows Azure iOS 工具套件添加到您的基于 Xcode 4 的项目中!
现在您只需要在应用程序的适当位置添加 Windows Azure iOS 工具套件库的头文件。相关的头文件包括
#import "watoolkitios-lib/WAToolkit.h"
请参阅示例目录以了解如何使用此库的详细信息。
文档
从 gentlebytes GitHub 安装 appledoc 并运行 library/MakeDocumenation。这将为文档集创建并安装 Xcode。有一些跨引用链接问题我们正在修复。
示例
示例目录包含使用 Toolkit 的示例。每个示例都有一个自述文件,解释如何使用它。
其他项目
以下是与本项目相关的其他项目
-
工具配置实用程序 - 此实用程序有助于使用 云就绪包。
-
云就绪包 - 这些是在您的应用程序和 Windows Azure 之间充当代理的包。
联系方式
如有疑问或反馈,请联系 团队。