【Day 27】Google Apps Script - API Blueprint 篇 - Apiary 建立专案与版本控制

Apiary 结合 Github 版本控制很方便。

今日要点：
》Apiary 建立专案介绍
》Apiary 版本控制介绍

Apiary 建立专案介绍

昨天我们大致介绍了 Apiary 的使用介面, 今天我们来建立专案吧。

建立专案

点选专案

输入专案名称，这个之後也可以改，再来就是选择 API 的描述语言，预设是 API Blueprint。

Apiary 支援 API Blueprint 与 swagger 二种，你可以点选蓝色字打开选单来更换。

建立後，就会到主画面来，他预设先填好一个范例，再来我们要把内容填上去。

Apiary 版本控制介绍

这时候你就可以把【Day 25】转好的.apib 内容贴上来编辑区，再存档就可以了。

再来 Apiary 有结合 Github 帐号登入，支援 Github 的版本控制, 所以我们可以用 Github 帐号登入

点选左上的 Link this Project to Github 或 设定。

会来到设定页最下方的 Github 存储库设定画面

我们先到 Github 建一个新的存储库，要注意的是，连接到 Apiary 时，GitHub 存储库不能为空。在连接到 Apiary 之前，我们必须使用至少 1 个档案初始化存储库，就先勾选下方的建立 README.md。

回到我们的设定画面，找到刚刚的 Github 存储库

Connect 之後，我们写一下 commit 说明，就可以 commit 到 Github 了。

commit 成功後，可以看到同步成功的画面

回到 Github 就可以看到多了一个 .apib 的档案了

回到主画面可以看到左上角的地方，变成绿色显示 github 分支，点选可以切到 Github 去查看，最右边也多了一个 Push 的蓝色按键。

之後版本控管，你可以从主画面 Save 後 Push 或 从 github commit 都会同步档案了.

以上就是 Apiary 建立专案与版本控制的介绍了，更多设定的细节请查看下方参考所附的连结唷。

参考

• GitHub Integration