連携
GitHub
アプリのコードを、あなた自身のGitHubアカウントのプライベートリポジトリに送りましょう。新しいバージョンはいつでも送れますし、開発者にコードを渡すこともできます。
アプリのコードは、あなたのものです。GitHubを使うと、コードのコピーを自分のGitHubアカウントのプライベートリポジトリに保管できます。新しいバージョンはいつでも送れますし、開発者に共有することもできます。GitHubへのエクスポートはどのプランにも含まれていて、クレジットは使いません。
GitHub同期のしくみ
| あなたの操作 | 起こること |
|---|---|
| はじめてプロジェクトを送る | Buildliyが、あなたのGitHubアカウントに非公開リポジトリを作ります。名前はプロジェクト名にちなんだものになります(たとえば buildliy-candle-shop。その名前がすでに使われている場合は buildliy-candle-shop-2)。そこへ、READMEつきで最新版が送られます |
| Buildliyでビルドを続ける | 自動では何も送られません。GitHubにまだ届いていない新しいバージョンがあると、GitHubアイコンに小さな点が表示されて知らせてくれます |
| 最新版を送るを選ぶ | いちばん新しいバージョンが、新しいコミットとしてリポジトリに送られます |
| 誰かがGitHub上でリポジトリを編集した | Buildliyはその人の作業を上書きしません。あなたの更新はプルリクエストとして届くので、GitHub上で確認してマージできます |
GitHubで行った編集は、GitHubの中にとどまります。Buildliyのプロジェクトやプレビューには反映されません。
GitHubとつないでリポジトリを作る
GitHubアイコンをクリックする
プロジェクトを開いて、右上の公開の隣にあるGitHubアイコンをクリックします。まだGitHubとつないでいない場合は、GitHubの画面に移動します。
GitHubで許可する
必要ならGitHubにログインして、Buildliyを許可します。GitHubには、Buildliyが求める内容が表示されます。公開・プライベートを問わずリポジトリへのフルアクセス(プロジェクトのリポジトリを作成・更新するために必要です)と、プロフィールの読み取り専用アクセスです。許可するとプロジェクトに戻り、「GitHubとつながりました。このプロジェクトをGitHubに送れます。」と表示されます。
リポジトリを作る
もう一度GitHubアイコンをクリックして、プライベートリポジトリを作成を選びます。完了したビルドが少なくとも1つ必要です。それまでは先にビルドが必要と表示されます。作成が終わると、リポジトリの名前と開くボタンとともに「GitHubに送りました」と表示されます。
管理 → 概要の魔法のウィザードの下にあるGitHubにバックアップをクリックする方法もあります(アプリのバックエンドの準備ができると表示されます)。やることは同じで、はじめてのときはリポジトリを作成し、2回目以降は更新します。先にGitHubアイコンからGitHubとつないでおいてください。
新しいバージョンを送る
GitHubアイコンをクリックすると、メニューが開きます。
- 最新版を送る:いちばん新しいバージョンを送ります。送るものがあるときはメニューに新しい変更あり、ないときは最新ですと表示されます。
- リポジトリを開く:GitHub上のリポジトリを開きます。
- GitHubとの接続を解除:Buildliyのアクセス権を取り消します(下をご覧ください)。
送信したあとは、次のどれかが表示されます。
- 「最新版を…に送りました」:リポジトリがアプリと同じ内容になりました。
- 「…にはすでに最新版があります。」:送る新しいものはありませんでした。
- 「GitHubでプルリクエストを作成しました」:GitHub上で変更が加えられていたため、あなたの更新はプルリクエストとして送られました。確認するをクリックして、GitHubでマージすると、リポジトリが最新になります。
リポジトリに入るもの
- アプリのすべてのファイル(画像も含みます)。公開するときにBuildliyが行うのと同じ、小さな安全のための修正が加えられます(たとえば、ビルダーのプレビュー編集用ヘルパーは含まれません)。
- README。アプリの名前と説明、公開している場合は公開先のアドレス、パソコンで動かす方法(Node.js 20以降をインストールして、
npm installとnpm run devを実行します)、必要な設定、Buildliyのプロジェクトへのリンクが入ります。 .env.exampleファイル。アプリが設定(環境変数)を読み込む場合に作られ、設定の名前とメモが並びます。値は一切入りません。
リポジトリに入らないものもあります。
- シークレット。 シークレットキーのように見えるものを含むコードは、Buildliyは送りません。見つかった場合は、どのファイルにあるかを知らせるので、キーを管理 → シークレットに移してから(AIに頼んでもかまいません)、もう一度送ってください。シークレットやコネクタとして保存したキーは、Buildliyの中に残ります。シークレットとAPIキーをご覧ください。
- アプリのデータ。 テーブルとその中に保存されたものは、アプリのデータベースに残ります。新しいデータベースにつなぐと、コードは空の状態で始まります。
- アプリ専用のBuildliyのプライベートキー。 アプリ内のAIや決済などの組み込み機能が使います。アプリをBuildliy上で動かしているときは自動で設定されます。ほかの場所でコードを動かす場合は、このキーがないとそれらの機能は動きません。
Buildliyがリポジトリを更新できないとき
リポジトリが削除またはアーカイブされた場合、つないでいるのとは別のGitHubアカウントのものである場合、あるいはあなたのアカウントにそこへ送る権限がない場合、Buildliyはリポジトリの名前と理由とともに更新できませんと表示します。新しいリポジトリを作成を選ぶと、新しいプライベートリポジトリに最新版を送れます。古いリポジトリは変更も削除もされません。
開発者といっしょに作業する
GitHubで権限を渡す
GitHubの設定画面から、開発者をリポジトリに招待します。リポジトリはプライベートなので、招待した人だけが見られます。
READMEに沿って進めてもらう
READMEには、アプリをパソコン上で動かす方法と、入力する設定が書かれています。開発者は
.env.exampleを.env.localにコピーして、自分の値を追加します。変更を加える場所を決めておく
Buildliyは、GitHubでの編集をプロジェクトに取り込みません。開発者がGitHubで編集している間もあなたがBuildliyでビルドを続ける場合、あなたが送るたびにプルリクエストとして届くので、開発者は自分の作業といっしょにマージできます。
GitHubを使いたくない場合は、コードタブからコードベース全体をZIPでダウンロードすることもできます。コードを見る・ダウンロードするをご覧ください。
共有ワークスペースでは、コードがワークスペースオーナーのGitHubアカウントに送られるため、プロジェクトをGitHubに送れるのはオーナーだけです。チームメンバーは、GitHubアイコンからリンク済みのリポジトリを開けますが、GitHubで表示されるのは、オーナーがGitHub上でアクセス権を渡した人だけです。
GitHubとの接続を解除する
GitHubアイコンをクリックしてGitHubとの接続を解除を選び、確認します。BuildliyはすべてのプロジェクトについてあなたのGitHubアカウントにアクセスできなくなり、これまでのアクセス権も取り消されます。リポジトリとそのコードはGitHubに残り、各プロジェクトもリポジトリとのリンクが残ったままです。つなぎ直すまでは、リンク済みのプロジェクトのGitHubメニューにGitHubとつないで送ると表示されます。いつでもつなぎ直せますし、別のGitHubアカウントでつなぐこともできます。