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ファイルに貼り付けます（Windowsでは%USERPROFILE%/.npmrc）。
.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 はインストールされ、使用する準備が整っています。