为 NativeScript 定制的 Office 365 Graph API 插件

管理 Office 365 用户、组、邮件、日历、联系人、文件、任务、人脉、笔记等——所有操作都可通过单个端点完成

注意： 目前仅支持 iOS

功能

为了提高可读性，支持的功能已移至各自的 README 文件中

• 设置（继续阅读以下内容）
• 身份验证
• 通过 REST 使用
• 通过 MS Graph Client 使用

先决条件

您应该有一个 Office 365 账户管理员账户。如果您还没有，您可以在此处获取免费试用。

在此处注册您的移动应用。这需要您使用 Office 365 账户登录。然后，您可以点击大型的“添加应用”按钮，并按照列出的步骤进行，从为您应用命名开始。在应用创建屏幕上，您需要完成以下三件事

1. 点击“添加平台”按钮并选择“移动应用”
2. 从移动应用部分复制“客户端 ID”GUID。
3. 在底部点击“保存”。

设置

如果您还没有添加 TypeScript，请将其添加到您的 NativeScript 项目中。虽然这不是必需的，但强烈推荐。如果您想观看有关如何将现有的基于 JavaScript 的 NativeScript 应用转换为 TypeScript 的视频，请在此观看。

从命令提示符进入您的应用根目录并执行

tns plugin add nativescript-office365

然后在您的项目根目录中打开 references.d.ts 并添加以下行以获取此插件的自动完成和类型检查

/// <reference path="./node_modules/nativescript-office365/office365.d.ts" />

使用

如果您想要快速入门，请在此获取演示应用。

启动连接

当您的应用启动时，我们需要做一些连接操作，因此打开 app.ts 并在 application.start(); 之前添加以下内容

TypeScript

import * as o365 from 'nativescript-office365';

var o365InitOptions : o365.InitOptions = {
    clientId: '<enter GUID here>', //client id for application (GUID)
    scopes: ['Files.ReadWrite']
};
o365.init(o365InitOptions);

注意 1： 在此处输入在先决条件部分注册您的应用时生成的客户端 ID GUID 值。

注意 2： 上述列出的作用域为您的 NativeScript 应用授予 SharePoint (OneDrive) 文件读写权限。添加或替换其他作用域字符串以授予您的应用执行其他活动的权限。更多信息请见此处

未来工作

• 添加 Android 支持
• 为 REST 添加自动刷新令牌的支持
• 向消费者公开 MS Graph Client

致谢

此插件的基础是NativeScript Plugin Seed，由Nathan Walker提供。没有Jason Zhekov的 iOS ninja 技术专长，MS Graph Client iOS 版本将无法工作。