Axe DevTools for Web CLI のインストール
CLI をスタンドアロンの実行ファイルまたは Node.js パッケージとしてインストール します。
Axe DevTools CLI は 2 種類の形態で利用できます。環境に合わせて選択してください:
- 実行ファイル: 事前条件のない自己完結型のバイナリ
- Node.js パッケージ: npm または Yarn を通じてインストールし、Node.js が必要
要件
Axe DevTools CLI では、使用する各ブラウザーに対応するブラウザー ドライバーが必要です。ドライバーは PATH上にある必要があります。ブラウザーとそのドライバーを最新の状態に保ってください。
| ブラウザー | ドライバー |
|---|---|
| Chrome | ChromeDriver |
| Firefox | geckodriver |
| Safari | safaridriver は macOS に組み込まれています。ただし、使用前に safaridriver --enable を実行する必要があります。 |
| Microsoft Edge | Microsoft Edge WebDriver |
| Internet Explorer | IE Driver Server |
実行ファイルのインストール
実行ファイルには事前条件がなく、Node.js は不要です。
ダウンロード ページにアクセスするには Deque Agora アカウントが必要です。アカウントをお持ちでない場合は、Deque の担当者に連絡するか、当社の サポートデスクを使用するか、 メールでお問い合わせください。
ダウンロードページの CLI セクションから、お使いのプラットフォームに適した実行ファイルをダウンロードしてください:
axe-linux(Linux)axe-macos(macOS)axe-win.exe(Windows)
Linux のセットアップ
ファイルを実行可能にしてください:
chmod +x axe-linuxmacOS のセットアップ
ファイルを実行可能にし、ダウンロードしたファイルに macOS が追加する隔離属性を削除してください:
chmod +x axe-macos
xattr -d com.apple.quarantine axe-macosインストールのテスト
実行ファイルを配置したディレクトリからヘルプ コマンドを実行してください:
- Linux:
./axe-linux --help - macOS:
./axe-macos --help - Windows:
axe-win --help
アカウント設定によっては、管理者権限が必要な場合があります。
CLI をグローバルに使用可能にする
どのディレクトリからでも axe を実行するには、実行ファイルを PATH上のディレクトリに配置してください。
このドキュメントの残りの部分では、実行可能ファイルを axe （または Windows では axe.exe ）に名前を変更し、それがグローバルに利用可能であると想定しています。
Node.js を介してインストールする
あなたは Node.js をインストールする必要があります。確認するには、 node -v をターミナルで実行してください。
Deque Systems のプライベートレジストリにアクセスする必要があります。もしまだアクセスがない場合は、 Deque Systems ヘルプデスクに連絡してください。
ステップ 1: Agora アイデンティティトークンを取得する
Agora は Deque のプライベート npm レジストリで、 @axe-devtools パッケージをホストしています。それにアクセスするには、アイデンティティトークンが必要です。
- あなたの Agora プロフィールページにアクセスしてください。（ログイン後にリダイレクトされた場合は、リンクをもう一度クリックするか、 プロフィールを編集 を右上のコーナーでクリックしてください。）
- アイデンティティトークンを生成をクリックしてください。
- 後でトークンを識別するための説明をオプションで追加してください。
- トークンをクリップボードにコピーする。Agora から再び取得することはできないので、どこか安全な場所に保存してください。
アイデンティティトークンを作成する際、値をコピーすることを忘れないでください。これが唯一の機会です。そうしないと、新しいトークンを作成する必要があります。
アイデンティティトークンは有効期限があります（通常は1年後）、定期的にトークンを再作成する必要があります。
ステップ 2: あなたの .npmrc
- Agora パッケージへのアクセスの構成 ツールを訪問してください。入力した情報は保存されず、送信もされません。
- あなたの Agora のメールアドレスとアイデンティティトークンを入力してください。
- 構成を生成 をクリックして、出力をコピーしてください。
- 先ほどコピーした行を
~/.npmrcファイルに貼り付けてください（%USERPROFILE%/.npmrcは Windows 版）。
あなたの .npmrc はこのようになるはずです：
@axe-devtools:registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_auth="<generated-auth-string>"
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:email=<your-email@example.com>
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:always-auth=true _auth 値は <your-email>:<your-identity-token>の base64 エンコーディングです。
ステップ 3: パッケージをインストールする
npm でグローバルにインストール：
npm install -g @axe-devtools/cliまたは Yarn で：
yarn global add @axe-devtools/cliインストールの確認
axe --helpヘルプテキストが表示されれば、CLI はインストールされ、使用する準備が整っています。