macOS向けBitriseデスクトップアプリ
BitriseデスクトップアプリはネイティブのmacOSメニューバーアプリで、作業中のブランチのビルドのライブステータスを表示するため、ブラウザタブを開いてビルドステータスを確認する必要がありません。
BitriseデスクトップアプリはmacOS専用です。
アプリのインストールClick to copy link
Bitriseデスクトップアプリを使用するには、macOS 14.6以降と、少なくとも1つのworkspaceとプロジェクトにアクセスできるBitriseアカウントが必要です。ローカルフォルダを追跡する場合は、リポジトリのローカルチェックアウトも必要です。
- GitHubから
Bitrise.dmgファイルをダウンロードします。 .dmgを開き、BitriseをApplicationsフォルダにドラッグします。- ApplicationsからBitriseを起動します。
アプリは画面上部のメニューバーにアイコンとして表示されます。初回起動時は、サインインするまで未設定の状態が表示されます。
ログイン時に起動するClick to copy link
SettingsのGeneralペインでLaunch at loginをオンにすると、Macにログインするたびにアプリが自動的に起動し、アプリを手動で開かなくてもメニューバーにビルドステータスが表示されます。
サインインするClick to copy link
- メニューバーのBitriseアイコンをクリックします。
- Connect to Bitriseをクリックします。アプリがブラウザを開いてサインインします。
- ブラウザでサインインを完了し、アプリに戻ります。
サインイン後、アプリはアクセストークンをmacOSキーチェーンに保存し、自動的に更新します。サインインしたハンドルはbuild listヘッダーとSettingsに表示されます。
workspaceを選択するClick to copy link
選択したworkspaceは、ビルド、フィルタ、ローカルフォルダのマッチングなど、アプリが表示するすべての範囲を決定します。
- workspaceに1つだけ所属している場合は、自動的に選択されます。
- 複数に所属している場合は、workspaceピッカーから1つを選択します。
- どれにも所属していない場合、アプリはアクセスを取得するためにBitriseのWebUIを案内し ます。
AccountペインのSettingsから、後でworkspaceを切り替えられます。
監視するプロジェクトを追加するClick to copy link
build listは最初は空です。SettingsのProjectsペインで1つ以上のプロジェクトをサブスクライブすることで内容を追加できます。プロジェクトを追加する方法は2つあります。
- プロジェクトに直接サブスクライブする: これはプロジェクトのヘルスウォッチです。ローカルでチェックアウトしている内容に関係なく、プロジェクトを監視するために使用します。たとえば、
mainがグリーンのままであることを確認する場合などです。 - ローカルフォルダを追跡する: アプリは、gitリモートのURLを使用して各リポジトリをそのBitrise projectに自動的に照合するため、プロジェクトを手動で選択する必要はありません。その後、現在チェックアウトしているブランチのビルドを追跡し、ローカルでブランチを切り替えても同期を維持します。
- Subscribing directly
- Tracking a local folder
- Settingsを開き 、Projectsペインに移動します。
- 監視するプロジェクトをworkspaceから選択します。
- Projectsペインで、ローカルフォルダを追加するオプションを選択し、フォルダを参照します。
- アプリはフォルダとそのサブフォルダをスキャンしてgitリポジトリを検出し、見つかったものを一覧表示します。
- 追跡したいリポジトリを選択します。
Bitriseにビルドがないブランチでは、空のリストが表示されます。まだビルドが実行されていない新しいブランチに切り替えた場合、これは想定どおりの動作です。
フィルタと通知を設定するClick to copy link
監視している各プロジェクトには独自の設定があり、Projectsペインの詳細ビューで編集できます。
- Branches: プロジェクトが追跡するブランチを選択します。ローカルフォルダの場合、これはチェックアウトと自動的に同期されます。
- Notifications: 各プロジェクトをオフ、失敗時のみ、またはすべての完了時のいずれかに設定します。NotificationsペインのグローバルなAllow notificationsスイッチで、すべてのバナーのオン/オフを切り替えられます。
build listのグループ化Click to copy link
SettingsのBuildsペインで、build listの整理方法を選択します。
- By project: ビルドをプロジェクトごとにグループ化し、プロジェクトごとに1つのセクションを表示します。
- By date: すべてのプロジェクトのビルドを新しい順に一覧表示し、それぞれにプロジェクト名のラベルを付けます。
プロジェクトはdual-tracked(二重追跡)になる場合があります。これは、プロジェクトに直接サブスクライブしていると同時に、同じリポジトリに一致するローカルフォルダも追跡している状態です。dual-trackedのプロジェクトについては、表示方法を選択できます。
- Separate lists per source: プロジェクトに対して2つのセクションを表示し、ソースごとに1つずつ、それぞれに出所 を示すアイコンでラベルを付けます。
- Merged into one list: 両方のソースのビルドを、そのプロジェクトの単一のリストにまとめます。
ビルドステータスを確認するClick to copy link
メニューバーのアイコンは、監視しているプロジェクト全体で最後に開始されたビルドの状態を反映します。
- Passed: 最新のビルドが成功しました。
- Failed: 最新のビルドが失敗しました。
- Running: ビルドが実行中です。
- Aborted: 最新のビルドが中止されました。
アイコンをクリックするとbuild listが開きます。各ビルドはカードとして表示され、ステータスとコミットメッセージ、ブランチまたはタグ、WorkflowまたはPipelineの名前、開始時刻、所要時間、ビルド番号が示されます。カードから、ワンクリックでビルド、プルリクエスト、またはコミットをBitrise上で開けます。
Bitriseが追跡するビルドステータスの全一覧については、ビルドステータスをご覧ください。
アプリを最新の状態に保つClick to copy link
アプリは定期的に新しいリリースを確認するほか、AboutペインのSettingsからCheck Nowを使用してオンデマンドで確認することもできます。
更新が利用可能な場合は、新しい.dmgをダウンロードできます。初回インストール時と同じ方法で、アプリをApplicationsにドラッグしてインストールします。
トラブルシューティングClick to copy link
| 表示される内容 | 意味と対処方法 |
|---|---|
| ブランチのbuild listが空 | そのブランチにはBitriseにビルドがありません。ビルド履歴のあるブランチに切り替えるか、ビルドをトリガーしてください。 |
| フォルダに対応するプロジェクトが見つからない | フォルダのgitリモートが、選択したworkspace内のプロジェクトと一致しません。リモートとworkspaceを確認してください。 |
| リモートがこのworkspaceの外部にある | リポジトリが別のworkspaceに属しています。Accountペインでworkspaceを切り替えてください。 |
| Detached HEADまたはリモートなし | アプリが追跡するブランチを特定できません。upstreamリモートが設定されたブランチをチェックアウトしてください。 |
| サインインエラー | 認証に失敗したか、有効期限が切れています。メニューバーから再度サインインしてください。 |