ActDK のセットアップ

アプリケーション開発

アプリケーション開発チュートリアル

ActDK のセットアップ

次に、開発に使用する PC に ActDK をセットアップします。ダウンロード、バイナリの配置、PATH の設定、Developer Token の発行、初期設定の順に進めます。

ActDK のダウンロード

ActDK をダウンロードするためにはグループのベンダ昇格が済んでいる必要があります。開発用のグループがまだベンダでない場合は、お問い合わせください。

ベンダ昇格が済んでいるグループは、コンソールにおいてグループ ID に VENDOR がつく

Vendor

上記の手順が終了しているグループには左側のメニューに Vendor Console が現れます。

SDK をクリックし ActDK をダウンロードします。 actdk-raspberrypi.zip ファイルを展開すると ActDK が含まれています。

Vendor Console

使用する環境に応じて、以下のファイルを actdk にリネームしてください。

Linux (x86_64) の場合

Ubuntu 22.04 をご利用の場合、actdk-ubuntu-22.04 を actdk にリネームしてご利用ください。

macOS (arm64) の場合

macOS (arm64) をご利用の場合、 actdk-macos-arm64 を actdk にリネームしてご利用ください。 (※ macOS のサポートは実験的です。)
- このバイナリを初めて実行すると以下の画像が表示され、実行がブロックされます。
- macOS の システム設定 から セキュリティとプライバシー を開き、以下の画像のように このまま許可 をクリックしてください。
- 再度実行時も警告が表示されますが、「このまま開く」をクリックし、パスワードを入力すると実行できます。一度許可すれば、以降は警告なしで実行できます。

また、GitHub の actcast-app-examples リポジトリからサンプルアプリケーションを入手できます。

バイナリの配置

上記でダウンロードしてリネームした actdk ファイルは、ユーザホームディレクトリ配下の $HOME/.local/bin/actdk に配置してください。 actdk 自身を更新するコマンドとして actdk update がありますが、この更新のためには配置先のディレクトリとファイルにユーザの書き込み権限が必要です。 /usr/bin や /usr/local/bin など、管理者権限が必要な場所への配置は避け、以下の操作は sudo を使わずに実行してください。

ダウンロードした actdk ファイルのあるディレクトリで、以下を実行します。

$ mkdir -p "$HOME/.local/bin"
$ mv actdk "$HOME/.local/bin/actdk"
$ chmod u+rx "$HOME/.local/bin/actdk"

PATH の設定

現在のシェルで actdk を実行できるように、$HOME/.local/bin を PATH の先頭に追加します。

$ export PATH="$HOME/.local/bin:$PATH"

次回以降も設定を有効にするために、上記の PATH 設定相当を使用しているシェルの設定ファイルに追加しておいてください。

配置先の確認

以下を実行し、ホームディレクトリ配下の .local/bin/actdk の絶対パスが表示されることを確認してください。

$ command -v actdk

Developer Token の発行

ActDK の初期設定には、ベンダとなっているグループで発行できる Developer Token が必要です。

Actcast Web UI 上で次の操作を行います。

チュートリアルに利用するグループを選択
左のメニューにある Vendor Console > Manage を選択
右のペインに表示されたGenerate Newボタンをクリック

トークンの発行1

現れた画面のDescription欄に発行するトークンについての 1 行説明を入力した上で、Generate Developer Tokenボタンをクリックします。

トークンの発行2

ここで発行されたトークンは、続く初期設定で利用します。トークンはページを移動してしまうと再表示できないので、発行したトークンをコピーして保存しておいてください。

発行されたトークンの表示

Manage画面に戻ると、発行したトークンが一覧に表示されます。

トークン一覧

初期設定

初回のみ以下のコマンドによってセットアップする必要があります。

$ actdk setup <TOKEN>

先程発行したデベロッパトークンを <TOKEN> 引数に指定します。

これにより、ホームディレクトリ配下に.actdkディレクトリが作成されます。

詳しくはActDK のマニュアルをご覧ください。

前のページ: 開発環境の準備

次のページ: プロジェクト作成

最終更新日 2026/11/12