开始使用OneDrive SDK for iOS

将OneDrive API集成到您的iOS应用中！

2. 开始使用

2.1 注册您的应用

按照以下步骤注册您的应用。

2.2 在Xcode项目中设置密钥链共享权限

在Xcode的导航器面板中点击您的项目。点击您的应用目标，然后再点击“能力”选项卡。滚动到“密钥链共享”并打开开关。将“com.microsoft.adalcache”添加到该列表中。

2.2 设置您的应用程序ID和作用域

• 您可以直接在ODClient对象上设置您的应用程序ID和作用域。

• 针对针对OneDrive的应用，调用类方法[ODClient setMicrosoftAccountAppId: scopes:]，其中<applicationId>和<scopes>是特定的。有关作用域的更多信息，请参阅身份验证作用域。

• 针对针对OneDrive for Business的应用，调用类方法[ODClient setActiveDirectoryAppId: redirectURL:]，其中<applicationId>和<redirectURL>是特定的。注意：重定向URL必须与您在Azure管理门户中指定的重定向URL匹配。

2.3 获取已验证的ODClient对象

• 一旦您设置了正确的应用程序ID和作用域，您必须获取一个ODClient
  对象以对服务发出请求。SDK将为您存储账户信息，但首次用户登录时，将会调用UI来获取用户的账户信息。
  通过clientWithCompletion方法获取已验证的ODClient
  

[ODClient clientWithCompletion:^(ODClient *client, NSError *error){
    if (!error){
        self.odClient = client;
    }
 }];

2.4 对服务进行请求

一旦您获得了一个有效验证的ODClient，您就可以开始对该服务进行调用了。对服务进行的请求看起来就像我们的REST API。

要检索用户的驱动器

[[[odClient drive] request] getWithCompletion:^(ODDrive *drive, NSError *error){
    //Returns an ODDrive object or an error if there was one
}];

要获得用户驱动器的根文件夹

[[[[odClient drive] items:@"root"] request] getWithCompletion:^(ODItem *item, NSError *error){
    //Returns an ODItem object or an error if there was one
}];

有关SDK设计的概述，请参阅概述。

有关完整的示例应用，请参阅OneDriveAPIExplorer。

3. 文档

有关更详细的文档，请参阅

• 概述
• 【认证】(docs/auth.md)
• 条目
• 集合
• 错误

4. 问题

有关已知问题，请参阅问题。

5. 许可证

许可证

本项目采用了微软开源行为准则。如需更多信息，请查阅行为准则常见问题解答或联系[email protected]提出其他问题或意见。