はじめに
GitHub Desktop は、コマンドラインや Web ブラウザの代わりに GUI を使用して GitHub とやり取りできるようにするアプリケーションです。 GitHub Desktop は、あなたとあなたの Team が Git および GitHub とベストプラクティスを使用して共同開発することを推奨します。 GitHub Desktop を使用すると、変更を視覚的に確認して、デスクトップからほとんどの Git コマンドを完了できます。 GitHub Desktop を使用してリモートリポジトリにプッシュ、プル、およびクローンを作成し、コミットの関連付けやプルリクエストの作成などのコラボレーションツールを使用できます。
このガイドは、アプリケーションのセットアップ、アカウントの認証、基本設定の構成、および GitHub Desktop を使用したプロジェクト管理の基本を紹介しており、GitHub Desktop の使用開始の際に役立ちます。 このガイドを実行すると、GitHub Desktop を使用してプロジェクトでコラボレーションを行い、リモートリポジトリに接続できるようになります。
GitHub Desktop を始める前に、Git と GitHub の基本を理解しておくと便利です。 詳細については、次の記事を参照してください。
GitHub Desktop はオープンソースプロジェクトです。 ロードマップの確認、プロジェクトへの貢献、および Issue をオープンしてフィードバックや機能のリクエストを提供することができます。 詳細については、desktop/desktop リポジトリを参照してください。
パート 1: インストールと認証
GitHub Desktop は、サポートされている任意のオペレーティングシステムにインストールできます。 詳しくは、「サポートされるオペレーティング システム」を参照してください。
GitHub Desktop をインストールするには、GitHub Desktop のダウンロード ページにアクセスします。 詳しくは、「GitHub Desktopのインストール方法」を参照してください。
GitHub Desktop をインストールした後、GitHub または GitHub Enterprise のアカウントでアプリケーションを認証できます。 認証されると、GitHub または GitHub Enterprise のリモートリポジトリに接続できます。
-
GitHub または GitHub Enterprise に認証する前に、アカウントが必要になります。 アカウントの作成について詳しくは、「新しい GitHub アカウントへのサインアップ」をご覧いただくか、GitHub Enterprise のサイト管理者にお問い合わせください。
-
メニュー バーで [GitHub Desktop] を選び、 [環境設定] をクリックします。
![Mac のメニュー バーのスクリーンショット。 [GitHub Desktop] が開いており、青色で強調表示されている [環境設定] の上にカーソルが置かれています。](/web/20230314183045im_/https://docs.github.com/assets/cb-246898/images/help/desktop/mac-choose-preferences.png)
-
[環境設定] ウィンドウの [アカウント] ペインで、いずれかの [サインイン] ボタンをクリックして、GitHub.com または GitHub Enterprise のアカウントにサインインします。
![[環境設定] ウィンドウの [アカウント] ペインのスクリーンショット。 [GitHub.com] の横に、"サインイン" というラベルが付いたボタンがオレンジ色の枠線で囲まれています。](/web/20230314183045im_/https://docs.github.com/assets/cb-98726/images/help/desktop/sign-in-github.png)
-
手順に従ってサインインします。 認証について詳しくは、「GitHub に認証する」をご覧ください。
- GitHub または GitHub Enterprise に認証する前に、アカウントが必要になります。 アカウントの作成について詳しくは、「新しい GitHub アカウントへのサインアップ」をご覧いただくか、GitHub Enterprise のサイト管理者にお問い合わせください。
- [ファイル] ドロップダウン メニューの [オプション] をクリックします。 [オプション] ウィンドウで、 [アカウント] をクリックし、手順に従ってサインインします。 認証について詳しくは、「GitHub に認証する」をご覧ください。
![GitHub の [サインイン] ボタン](/web/20230314183045im_/https://docs.github.com/assets/cb-98726/images/help/desktop/sign-in-github.png)
パート 2: GitHub Desktop のカスタマイズと設定
GitHub Desktop のインストール後、ニーズに最も合うようにアプリを設定してカスタマイズできます。
GitHub または GitHub Enterprise でのアカウントの接続または削除、デフォルトのテキストエディタやシェルの選択、Git 設定の編集、GitHub Desktop の外観の変更、システムダイアログボックスのカスタマイズ、GitHub Desktop の [Preferences] ウィンドウでのプライバシー設定ができます。 詳しくは、「ベーシック設定」を参照してください。
![[Preference] ウィンドウの基本設定](/web/20230314183045im_/https://docs.github.com/assets/cb-295479/images/help/desktop/mac-select-preferences-pane.png)
GitHub または GitHub Enterprise でのアカウントの接続または削除、デフォルトのテキストエディタやシェルの選択、Git 設定の編集、GitHub Desktop の外観の変更、システムダイアログボックスのカスタマイズ、GitHub Desktop の [Options] ウィンドウでのプライバシー設定ができます。 詳しくは、「ベーシック設定」を参照してください。
![[Options] ウィンドウの基本設定](/web/20230314183045im_/https://docs.github.com/assets/cb-295479/images/help/desktop/mac-select-preferences-pane.png)
パート 3: GitHub Desktop でプロジェクトに貢献する
アプリをインストール、認証、設定すると、GitHub Desktop を使用開始できます。 リポジトリを作成、追加、またはクローンし、GitHub Desktop を使用してリポジトリへのコントリビューションを管理できます。
リポジトリの作成、追加、クローン作成
新しいリポジトリを作成するには、[GitHub Desktop] メニュー バーで [ファイル] を選び、 [新しいリポジトリ...] をクリックします。詳しくは、「GitHub Desktop を使った最初のリポジトリ作成方法」をご覧ください。
ローカル コンピューターからリポジトリを追加するには、 [ファイル] を選び、 [ローカル リポジトリの追加...] をクリックします。詳しくは、「ローカルコンピュータからGitHubデスクトップへのリポジトリの追加」をご覧ください。
GitHub からリポジトリを複製するには、 [ファイル] を選び、 [リポジトリの複製...] をクリックします。詳しくは、「GitHub Desktopからのリポジトリのクローンとフォーク」をご覧ください。
![Mac のメニュー バーのスクリーンショット。 リポジトリのアクションは、[ファイル] ドロップダウン メニューを開くと一覧表示されます。](/web/20230314183045im_/https://docs.github.com/assets/cb-173034/images/help/desktop/mac-file-menu.png)
![リポジトリの作成、追加、およびクローン作成に関する [File] メニューオプション](/web/20230314183045im_/https://docs.github.com/assets/cb-23267/images/help/desktop/windows-file-menu.png)
ブランチでの変更
GitHub Desktop を使用して、プロジェクトのブランチを作成できます。 ブランチは、開発作業をリポジトリ内の他のブランチから分離するため、変更を安全に試すことができます。 詳しくは、「ブランチを管理する」を参照してください。
ブランチに変更を加えた後、GitHub Desktop で確認し、変更の追跡のためにコミットすることができます。 詳しくは、「コミットについて」を参照してください。
変更にリモートでアクセスしたり、他のユーザと共有したりする場合は、コミットを GitHub にプッシュします。 詳しくは、「GitHub に変更をプッシュする」を参照してください。
GitHub Desktop とのコラボレーション
GitHub Desktop を使用して、問題を作成したり、リクエストをプルして他のユーザとプロジェクトでコラボレーションしたりすることができます。 Issue は、アイデアを追跡し、プロジェクトに加えられる可能性のある変更について議論する際に役立ちます。 プルリクエストを使用すると、提案された変更を他のユーザと共有したり、フィードバックを受け取ったり、変更をプロジェクトにマージしたりすることができます。 詳しくは、「Issue とプルリクエストについて」をご覧ください。
自分またはコラボレータのプルリクエストは、GitHub Desktop で見ることができます。 GitHub Desktop でプルリクエストを表示し、デフォルトのテキストエディタでプロジェクトのファイルとリポジトリを開くと、提案された変更を確認して、追加の変更を加えることができます。 詳しくは、「GitHub デスクトップでプルリクエストを表示する」を参照してください。
ローカルリポジトリの同期を維持する
ローカルリポジトリに変更を加える場合、または他のユーザがリモートリポジトリに変更を加える場合は、プロジェクトのローカルコピーをリモートリポジトリと同期する必要があります。 GitHub Desktop は、コミットをプッシュおよびプルすることにより、プロジェクトのローカルコピーをリモートバージョンと同期させることができます。 詳しくは、「ブランチの同期」を参照してください。