コンテンツにスキップ
Oleaflyv0.4.12

デバイスコードまたはトークンで GitHub に接続し、プロジェクトを新規または既存のリポジトリとして公開し、マシン間でプッシュとプルを行います。トークンの保護の仕組みも説明します。

GitHub 同期は、マシンの外へのバックアップや、複数のコンピュータ間での作業の引き継ぎのための、任意の機能です。各プロジェクトがすでに持っている本物の Git リポジトリの上に作られています。ローカルのコミットは GitHub がなくても使えます。接続しても、Oleafly のアカウントは登場しません。必要なのはあなたの GitHub だけです。

設定 → 連携 → GitHub を開き、次のどちらかの方法を使います。

  • GitHub に接続: デバイスコードによる方法で、おすすめです。Oleafly が短いコードを表示し、ブラウザで github.com/login/device が開きます(コードの コピー ボタン付き)。承認すると、アプリは数秒以内にそれを検出します。接続が要求するスコープは repo と read:user だけです。
  • パーソナルアクセストークン: 自分で認証情報を発行したい場合は、「詳細設定: パーソナルアクセストークンを使う」を展開して、PAT を貼り付けます。

接続すると、アバターとユーザー名が設定と、上部ツールバーの GitHub メニューに表示されます。 接続を解除 を押すと、トークンが破棄されます。

トークンは、AES-256-GCM で暗号化された、所有者だけがアクセスできるローカルファイルに保存され、アプリの UI 層には渡されません。インターフェースが知るのは「@you として接続中」ということだけです。Git が認証を必要とするときは、メモリ上の credential helper を通じてトークンが渡されるので、コマンドライン、.git/config、シェルの履歴にトークンが現れることはありません。トークンをリモートの URL に埋め込んでいた古いビルドの痕跡は、起動時に自動で消去されます。

ソース管理パネルで GitHub に公開 をクリックします。

  • 新しいリポジトリを作成: リポジトリ名を選びます(プロジェクトから自動入力されます)。おすすめは 非公開 のチェックを残すことですが、外すこともできます。そのうえで 作成してプッシュ を押します。Oleafly はリポジトリを作成し、プロジェクトのファイルをコミットし、origin を設定して、プッシュします。
  • 既存のリポジトリにリンク: 検索できるリポジトリの一覧から選びます(非公開のものには鍵のアイコンが付きます)。そのうえで リンクしてプッシュ を押します。

公開後は、ツールバーの GitHub メニューに GitHub で開く と リポジトリのリンクをコピー が表示されます。

秘密情報に見えるファイルはローカルに残る

「秘密情報に見えるファイルはローカルに残る」セクション

公開時に、キーやパスワードが入っていることの多いファイルがコミットされることはありません。たとえば .env、*.pem、SSH の秘密鍵、credentials.json です。これらはステージされないままプロジェクトのフォルダに残り、ダイアログにそのファイル名が表示されます。それでも公開したい場合は、ソース管理で自分でステージしてコミットします。.env.example のようなテンプレート、公開鍵、Keynote の .key ファイルは、通常どおり公開されます。

プッシュすると、履歴全体がアップロードされます。これらの名前のファイルが過去にコミットされたことがある場合、Oleafly はそれを一覧で示し、GitHub 上に何かを作成する前に キャンセル か それでも公開 が押されるのを待ちます。

ソース管理パネルの プッシュ と プル のボタンは、その名前のとおり、現在のブランチの origin に対して動作します。 フェッチ と 同期 は ソース管理のその他の操作 メニューにあります。 コミットしてプッシュ と コミットして同期 は コミット の横のメニューにあります。ブランチ名の横にある 先行/遅れ の表示(↑ ↓)が、プッシュまたはプルすべきものがあることを知らせます。

GitHub で 2 台のコンピュータ間でプロジェクトを移すコンピュータ A がプロジェクトを GitHub リポジトリに公開し、コミットをプッシュします。コンピュータ B は同じリポジトリをインポートしてプルします。その後は、それぞれのコンピュータが自分のコミットを GitHub にプッシュし、相手のコミットをプルします。どちらのコンピュータも、自分の Git 履歴を持つ完全なプロジェクトフォルダを保持します。コンピュータ Aプロジェクトと .gitGitHubリポジトリコンピュータ Bプロジェクトと .git公開、プッシュプルインポート、プルプッシュGitHub で 2 台のコンピュータ間でプロジェクトを移すコンピュータ A がプロジェクトを GitHub リポジトリに公開し、コミットをプッシュします。コンピュータ B は同じリポジトリをインポートしてプルします。その後は、それぞれのコンピュータが自分のコミットを GitHub にプッシュし、相手のコミットをプルします。どちらのコンピュータも、自分の Git 履歴を持つ完全なプロジェクトフォルダを保持します。コンピュータ Aプロジェクトフォルダと .gitGitHubリポジトリコンピュータ Bプロジェクトフォルダと .git公開、プッシュプルインポート、プルプッシュ
各コンピュータは Git 履歴付きの完全なプロジェクトを保持します。GitHub が共有コピーを保持し、プッシュとプルでコミットをやり取りします。
  1. マシン A で: プロジェクトを公開し、作業して、最後に プッシュ します。
  2. マシン B で: 同じ GitHub アカウントを接続して プロジェクトを読み込む → GitHub を選び、リポジトリを指定します。読み込みガイドを参照してください。以降は プル してから作業し、最後に プッシュ します。
  3. マシン A に戻ったら、作業を始める前に プル します。表示がそれを知らせてくれます。

カバーの色、メイン文書の選択、履歴はすべて一緒に移ります。これらはプロジェクトのフォルダ自体に保存されているからです。

リモートを設定すると ソース管理のその他の操作 メニューに項目が 2 つ増えます。

  • リポジトリを変更 は、公開ダイアログを開き直して、origin の向き先を別の場所に変えます。
  • リンクを解除 は、リモートを取り除きます。ローカルのプロジェクトと履歴には影響しません。

プルでマージの衝突が起きると、ソース管理に衝突したファイルが一覧で表示されます。それぞれについて 現在のものを使う か 取り込むものを使う を選ぶか、ファイルを編集して 解決済みにする を選び、最後に マージを完了 を選びます。 マージを中止 を選ぶと、ファイルは元の状態に戻ります。プッシュとプルは、チェックアウトしているブランチに対して動作し、パネルの上部にあるブランチメニューで、ブランチの切り替えや作成ができます。Git とソース管理を参照してください。

Oleafly が認証できるのは HTTPS のリモートです。公開の操作で、正しい設定が自動で行われます。

  • 「No remote ‘origin’」と表示される: 先に公開してください。プッシュとプルにはリモートが必要です。
  • リモートにコミットがあるためプッシュが拒否された: 先にプルしてから、プッシュしてください。
  • 「No GitHub token set」と表示される: 設定の「連携」→「GitHub」で接続してください。

詳しくは FAQ を参照してください。

画像のプレビュー

AI の回答を読み込めませんでした

もう一度試すか、ドキュメントを検索してください。