BitriseでのDartアナライザーの実行

Dartアナライザーを使うと、Bitrise上でFlutter Analyze Stepを使用してFlutterコードの静的解析を実行できます。Stepはflutter analyzeコマンドを実行し、コード内の型アノテーションを活用して問題の特定に役立てます。

アナライザーを実行するには:

Workflow Editor
Configuration YAML

Flutter Install StepをWorkflowに追加します。

このStepは、Flutter SDKの初期セットアップを実行し、不足しているコンポーネントをインストールします。
Flutter Install Stepがアプリに適したバージョンのFlutter SDKをインストールすることを確認するには、Flutter SDK version or bundle URL入力を確認してください。

入力のdefault valueはstableで、これは最新の安定版のSDKをインストールします。ただし、特定のバージョンタグ、ブランチラベル、またはFlutter SDKバンドルURLを値として設定することもできます。
- 利用可能なバージョンタグはこちらで確認できます: Version tags。
- 利用可能なブランチラベルはこちらで確認できます: Branch labels。
インストールバンドル URL
インストールバンドルURLからFlutter SDKをインストールすることもできます。同じFlutter SDK version or bundle URL入力の値としてURLを設定します。例: https://storage.googleapis.com/flutter_infra/releases/beta/macos/flutter_macos_v1.6.3-beta.zip。
Flutter Analyze StepをWorkflowに追加します。
Project Location入力がFlutterプロジェクトのルートディレクトリを指していることを確認してください。
- アプリとして追加する際に、プロジェクトスキャナーが自動的にFlutterプロジェクトとして検出した場合、Bitriseでdefault valueを変更する必要はありません。
- アプリを手動で設定した場合は、場所が正しいことを確認してください。
Fail Severity入力を目的のレベルに設定します。

この入力は、Stepを失敗させる最小の深刻度を決定します。指定した深刻度以上の問題があるとStepは失敗します。設定可能な値は次の3つで、深刻度の低い順から高い順に並んでいます:
- info: この設定を選択すると、info、warning、errorレベルのすべての問題でStepが失敗します。
- warning: この設定を選択すると、warningおよびerrorレベルの問題のみでStepが失敗します。
- error: これはdefault valueです。errorレベルの問題のみでStepが失敗します。
必要に応じて、Additional Parameters入力でflutter analyzeコマンドに追加のフラグを指定します。

利用可能なフラグの一覧を確認するには、flutter help analyzeを実行してください。たとえば、エラー、警告、ヒント、lintがない場合に出力を表示したくない場合は、--no-congratulateフラグを使用できます。

flutter-installer StepをWorkflowに追加します。

このStepは、Flutter SDKの初期セットアップを実行し、不足しているコンポーネントをインストールします。
```
primary:
  description: |
    Builds project and runs tests.
  steps:
    - activate-ssh-key: {}
    - git-clone: {}
    - flutter-installer:
        inputs:
```
Stepがアプリに適したバージョンのFlutter SDKをインストールすることを確認するには、version入力でバージョンを指定できます。

入力のdefault valueはstableで、これは最新の安定版のSDKをインストールします。Configuration YAMLファイルにversion入力が表示されない場合は、default valueに設定されています。ただし、特定のバージョンタグ、ブランチラベル、またはFlutter SDKバンドルURLを値として設定することもできます。
- 利用可能なバージョンタグはこちらで確認できます: Version tags。
- 利用可能なブランチラベルはこちらで確認できます: Branch labels。
```
# Installing version 3.7.7 of the Flutter SDK
- flutter-installer:
    inputs:
    - version: 3.7.7
```
インストールバンドル URL
インストールバンドルURLからFlutter SDKをインストールすることもできます。同じversion入力の値としてURLを設定します。URLはhttps://storage.googleapis.com/flutter_infraで始まる必要があります。例:
- flutter-installer: inputs: - version: https://storage.googleapis.com/flutter_infra/releases/beta/macos/flutter_macos_v1.6.3-beta.zip

flutter-analyze StepをWorkflowに追加します。

primary:
  description: |
    Builds project and runs tests.
  steps:
    - activate-ssh-key: {}
    - git-clone: {}
    - flutter-installer:
        inputs: 
        - version: stable
    - flutter-analyze:
        inputs:

project_location入力がFlutterプロジェクトのルートディレクトリを指していることを確認してください。
```
- flutter-analyze:
    inputs:
    - project_location: "$BITRISE_SOURCE_DIR"
```
- アプリとして追加する際に、プロジェクトスキャナーが自動的にFlutterプロジェクトとして検出した場合、Bitriseでdefault valueを変更する必要はありません。
- アプリを手動で設定した場合は、場所が正しいことを確認してください。
fail_severity入力を目的のレベルに設定します。

この入力は、Stepを失敗させる最小の深刻度を決定します。指定した深刻度以上の問題があるとStepは失敗します。設定可能な値は次の3つで、深刻度の低い順から高い順に並んでいます:
- info: この設定を選択すると、info、warning、errorレベルのすべての問題でStepが失敗します。
- warning: この設定を選択すると、warningおよびerrorレベルの問題のみでStepが失敗します。
- error: これはdefault valueです。errorレベルの問題のみでStepが失敗します。
```
- flutter-analyze:
    inputs:
    - project_location: "$BITRISE_SOURCE_DIR"
    - fail_severity: error
```
必要に応じて、additional_params入力でflutter analyzeコマンドに追加のフラグを指定します。

利用可能なフラグの一覧を確認するには、flutter help analyzeを実行してください。たとえば、エラー、警告、ヒント、lintがない場合に出力を表示したくない場合は、--no-congratulateフラグを使用できます。
```
- flutter-analyze:
    inputs:
    - project_location: "$BITRISE_SOURCE_DIR"
    - fail_severity: error
    - additional_params: --no-congratulate
```

ビルドが実行されたら、ビルドログでStepの出力を確認できます。

関連情報