Microsoft Graph SDK for iOS (预览版)

使用此 Objective-C 库轻松将 Microsoft Graph 的服务和数据集成到原生 iOS 应用中。

---

注意：此代码和相关二进制文件作为开发人员 预览版 发布。您可以根据包含的 许可证 使用此库，并在本仓库中提交问题以获得非官方支持。

有关官方 Microsoft 支持的信息，请访问 此处。

---

此库使用 Vipr 和 Vipr-T4TemplateWriter 从 Microsoft Graph API 元数据生成，并使用一个 共享客户端堆栈。

快速入门

要在此项目中使用此库，请按照以下一般步骤操作，具体说明如下

1. 配置 Podfile。
2. 设置身份验证。
3. 构建 API 客户端。

设置

1. 从 Xcode 启动屏幕创建一个新的 Xcode 应用程序项目。在对话框中，选择 iOS > 单视图应用程序。根据您的需要命名应用程序；以下我们将使用名称 MSGraphQuickStart。

2. 向项目中添加一个文件。从对话框中选择 iOS > 其他 > 空文件，并将其命名为 Podfile。

3. 将以下行添加到 Podfile 中以导入 Microsoft Graph SDK

   source 'https://github.com/CocoaPods/Specs.git'
   xcodeproj 'MSGraphQuickStart'
   pod 'MSGraph-SDK-iOS'

   注意：有关 Cocoapods 和 Podfile 的最佳实践的信息，请参阅 使用 Cocoapods 指南。

4. 关闭 Xcode 项目。

5. 在命令行中，切换到您的项目目录。然后运行 pod install。

   注意：当然必须首先安装 Cocoapods。说明 在此处。

6. 在终端的同一位置，执行 open MSGraphQuickStart.xcworkspace 以在 Xcode 中打开包含您的原始项目和导入的库的工作区。

---

身份验证和构建客户端

项目准备完毕后，下一步是初始化依赖关系管理和 API 客户端。

如果您尚未在 Azure AD 中注册应用程序，您需要按照以下步骤进行操作，以完成此步骤。

1. 右键单击 MSGraphQuickStart 文件夹并选择“新建文件”。在对话框中，选择 iOS > 资源 > 属性列表。将文件命名为 adal_settings.plist。将以下密钥添加到列表中，并将它们的值设置为应用程序注册中的值。这些只是示例；请确保使用您自己的值。

   键	值
   ClientId	示例：e59f95f8-7957-4c2e-8922-c1f27e1f14e0
   RedirectUri	示例：https://my.client.app/
   ResourceId	示例：https://graph.microsoft.com
   AuthorityUrl	https://login.microsoftonline.com/common/

2. 从 MSGraphQuickStart 文件夹中打开 ViewController.m。添加 Microsoft 图和 ADAL 相关头部的伞状头文件。

   #import <MSGraphService.h>
   #import <impl/ADALDependencyResolver.h>
   #import <ADAuthenticationResult.h>

3. 在 ViewController.m 文件的类扩展部分中添加 ADALDependencyResolver 和 MSGraph 的属性。

   @interface ViewController ()
   
   @property (strong, nonatomic) ADALDependencyResolver *resolver;
   @property (strong, nonatomic) MSGraphServiceClient *graphClient;
   
   @end

4. 在 ViewController.m 文件的 viewDidLoad 方法中初始化解析器和客户端。

   - (void)viewDidLoad {
      [super viewDidLoad];
   
     self.resolver = [[ADALDependencyResolver alloc] initWithPlist];
   
     self.graphClient = [[MSGraphServiceClient alloc] initWithUrl:@"https://graph.microsoft.com/" dependencyResolver:self.resolver];
     }

5. 在使用客户端之前，您必须确保用户已经至少交互式登录过一次。您可以使用 interactiveLogon 或 interactiveLogonWithCallback: 来启动登录序列。在这个练习中，将以下内容添加到最后一个步骤的 viewDidLoad 方法中

   [self.resolver interactiveLogonWithCallback:^(ADAuthenticationResult *result) {
      if (result.status == AD_SUCCEEDED) {
          [self.resolver.logger logMessage:@"Connected." withLevel:LOG_LEVEL_INFO];
      } else {
          [self.resolver.logger logMessage:@"Authentication failed." withLevel:LOG_LEVEL_ERROR];
      }
   }];

6. 现在您可以使用 API 客户端了。

示例

• O365-iOS-Connect - 入门和身份验证
  
• O365-iOS-Snippets - API 请求和响应

捐赠

在提交拉取请求之前，您需要签署捐赠者许可协议。完成捐赠者许可协议（CLA）时，您需要通过表格提交请求，然后在收到包含文档链接的电子邮件后电子签署捐赠者许可协议。这只需对任何 Microsoft 开放技术 OSS 项目执行一次。

许可

版权所有（c）微软公司。保留所有权利。在 Apache 许可证版本 2.0 下许可。