Unityのビルドといえば、長らくMac + JenkinsなどのCIツールという印象でした。昨年、Unity Cloud Buildの存在を知ってはいたものの、いまいちという印象で回避してきました。

改めて触ってみるとGit連携、ビルド状況の把握、ユーザーのダウンロードフロー、コントリビュートなど機能がそろっており、非常に使いやすいことがわかりまます。

今回はUnity Cloud BuildをAPI経由で触ってみましょう。

なぜ API が必要なのか

UnityはBetaリリースやPatchリリースが頻繁で週1回のペースで更新されます。更に、対象プラットフォームに合わせて多くのビルド構成が必要になります。

特にアセットとしては様々な環境に対応するため、Unityバージョン × プラットフォーム分だけビルドを回す必要があります。

手作業で、ビルドターゲットをポチポチ作るのは10個までは我慢できてもそれ以上はむりでしょう。そこで、APIを使って自動構成、自動ビルド、任意のビルド、ChatOpsを実現することで人間の生活を送れます。

API Document

Unity Cloud Build APIはSwaggerベースになっています。

Unity Cloud Build API

Swaggerは強力無比なAPI基盤です。ここから直接APIを叩くこともできますしcurlの実行サンプル、レスポンスJSONサンプルまで表示されています。

Unity Cloud BuildのAPI Document最高ですね。Visual Studio Team ServiceもこれぐらいAPIをわかりやすく公開してほしいものです。

クライアント生成

APIを叩くのにクライアント生成する時代は、Swaggerによって劇的に変化します。

SwaggerでAPIを構成すると、そのAPI構成がjsonで自動的に吐き出されます。

クライアント URL : https://build-api.cloud.unity3d.com/api/v1/api.json

利用者は、そのjsonをSwaggerのクライアントコード生成に投げつけることで、クライアントコードが自動生成されるのです。もはや書かなくていいに等しいぐらいい十分なものができます。

https://generator.swagger.io/

GeneratorページのPOST /gen/clients/{language}に以下を入れることでクラインとコードが生成され、レスポンスのlinkからダウンロードできるようになります。

language:csharp
body:
{
  "spec": {},
  "options": {},
  "swaggerUrl": "https://build-api.cloud.unity3d.com/api/v1/api.json",
  "securityDefinition": {
    "description": "string",
    "type": "string"
  }
}

あとは、生成されたコードをソースに埋めて、生成コードが依存している次のNuGet Packageをプロジェクトにいれるだけです。

Install-Package RestSharp
Install-Package Newtonsoft.Json

Base64Encode メソッドの追加

とはいえ、実はクライアントコード生成が腐っているため、Base64Encode()メソッドが存在しません。追加してあげましょう。

https://gist.github.com/guitarrapc/6218ac211f7cffe2c083

staticメソッドとして追加して、各クラスでusing staticしてあげるのが素早く簡潔な対応です。

using System;
using System.IO;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.Linq;
using RestSharp;
using UnityCloudBuildApi.IO.Swagger.Client;
using UnityCloudBuildApi.IO.Swagger.Model;
using static UnityCloudBuildApi.Encode;

namespace UnityCloudBuildApi.IO.Swagger.Api
{
    ....
}

これらの対応 + サンプルを足したUnityCloudbuildApiをGitHubで公開しています。