クイックスタート

環境

ASDの実行にはHomebrewまたはDockerが必要です。

Homebrew

お勧めの方法です。以下のようにします。

brew install alps-asd/asd/asd

アンインストールするには以下のようにします。

brew uninstall asd
brew untap alps-asd/asd

Docker

次のコマンドでasdコマンドをインストールします。

curl -L https://alps-asd.github.io/app-state-diagram/asd.sh > ./asd && chmod +x ./asd && sudo mv ./asd /usr/local/bin

デモ

HomebrewまたはDockerいずれかの方法でインストールを行った後は早速デモを実行してみましょう。

mkdir work
curl -L curl https://alps-asd.github.io/app-state-diagram/blog/profile.json > work/profile.json
asd --watch ./work/profile.json

ブラウザでhttp://localhost:3000/を開きます。 Application State Diagramのリンクでダイアグラムが確認できますか?

Macアプリケーション

コンソールの操作が不要なMacのGUIアプリケーションも用意されています。

インストールと実行:

  • ASD launcherをダウンロードしてasdスクリプトを開きます。
  • スクリプトエディタで、ファイル > 書き出す.. を選択し、場所をアプリケーション、ファイルフォーマットもアプリケーションにして保存します。
  • 実行してALPSファイルを選択するとASDサーバーが起動します。ドラッグ&ドロップにも対応しています。

アプリケーション状態遷移図

矢印で結ばれたそれぞれの四角形をアプリケーション状態といいます。リソースの状態アフォーダンス(次のアクション)がリンクとして示されていて、リンクを辿ることでアプリケーション状態が遷移します。 <a>タグや<form>タグで各ページがリンクされたWebサイトをイメージしてください。

遷移図はSVGフォーマットで、アプリケーション状態やリンクの詳細ページにリンクされています。