プロジェクトの共有
読み取り専用リンクの公開、閲覧できる人の設定、メールでの招待、共有コピーの更新。
Share は、プロジェクトの読み取り専用のコピーをリンクとして公開します。リンクを開いた人は、ファイル、回路図、基板、機構設計のビューを閲覧し、プロジェクトをダウンロードし、自分のアカウントにフォークできます。リンクを知っている人なら誰でも開けるようにするか、招待した人だけが開けるようにするかを選べます。
共有コピーはスナップショットです。もう一度公開したときにだけ変わります。
プロジェクトを共有する
Share は下部ツールバーのブランチボタンの隣にあります。緑の点は、プロジェクトが公開中であることを示します。
デスクトップではサインインが必要です。サインインしていない場合、ポップオーバーに Sign in が表示されます。ブラウザでは、自分が所有するプロジェクトにShareが表示されます。
- Share をクリックします。公開するまで、ヘッダーには Private と表示されます。
- 必要に応じて人を招待し、リンクを開ける人を選びます（後述）。
- デスクトップでは、What's included を確認します。
- Publish and copy link をクリックします。
リンクがクリップボードにコピーされ、ヘッダーが Live に変わり、リンクと Copy ボタンが表示されます。クリップボードが使えない場合は、リンクが入力欄で選択された状態になるので、自分でコピーしてください。
リンクを開ける人
General access には2つの選択肢があります。
| 選択肢 | 開ける人 |
|---|---|
| Anyone with the link | 誰でも。サインインは不要です。 |
| Only people invited | あなたと、あなたが招待した人。招待されたメールアドレスでサインインします。 |
公開中のプロジェクトでは、General accessの変更は Publish changes をクリックしたときに反映されます。
人を招待する
Invite people by email にメールアドレスを入力し、Invite をクリックします。カンマ、セミコロン、改行で区切って、複数のアドレスを一度に貼り付けられます。
各人はステータスとともに一覧に表示されます。
| ステータス | 意味 |
|---|---|
| On publish | デスクトップで、最初の公開前。招待はこのコンピューターに保持され、公開時に送られます。 |
| Invited | アクセス権があり、招待メールが送信されています。 |
| Joined | プロジェクトを開きました。 |
| Not sent | デスクトップで、プロジェクトは公開されたものの、招待を送れませんでした。Send again をクリックします。 |
招待された人には、あなたとプロジェクトの名前、リンクが書かれたメールが届きます。アドレスの横の x で削除できます。招待制のプロジェクトでは、削除された人はすぐにアクセスできなくなります。
上限とルール：
- 一度に招待できるのは最大20人、1つのプロジェクトにつき最大50人です。
- すべてのプロジェクトを合わせて、1日に追加できる新しいアドレスは最大100件です。
- 自分のアドレスは招待されません（"That's you — you already have access."）。
- 人を招待するには、アカウントのメールアドレスが確認済みである必要があります。
閲覧者に表示するタブを選ぶ
Opens with には Schematics、Board、Mechanical の3つのチップがあります。選んだものは、誰かがプロジェクトを開いたときにREADMEの隣に固定された状態で開きます。公開中のプロジェクトでは、Publish changes をクリックすると新しい選択が反映されます。
含まれるもの
デスクトップ
最初の公開の前に、ポップオーバーにはアップロードされる内容がそのまま一覧表示されます。42 files · 3.1 MB · 18 left out のような概要をクリックすると、Included の一覧（サイズ付き）と、項目ごとに理由が付いた Left out の一覧が展開されます。
| 理由 | 除外されるもの |
|---|---|
| generated | ビルドの出力、キャッシュ、アプリの状態：.git、.pio、node_modules、.embedr-board、.pcb、.versions、.history、.embedr/ フォルダ（データシートのインデックス、チャット、エージェントのファイル）、KiCadのローカル設定（.kicad_prl）、ロックファイル、バックアップ、エディタの一時ファイル。 |
| looks secret | 名前から認証情報と思われるファイル：.env ファイル、鍵と証明書（.pem、.key、.p12、.pfx、.keystore、id_rsa...）、secrets.h、arduino_secrets.h、credentials.json、*token*.json、サービスアカウントのJSON、.netrc、.npmrc、Firebaseのクライアント設定（google-services.json、GoogleService-Info.plist）。 |
| .gitignore | プロジェクトの .gitignore ファイルや .git/info/exclude で除外されたもの。 |
| link | シンボリックリンク。リンク先はたどりません。 |
秘密情報らしいファイルが見つかった場合、ポップオーバーに除外された件数が表示されます。秘密情報の検出はファイル名だけで判断します。main.cpp に貼り付けた鍵はそのまま共有されます。公開前にソースを確認してください。
ブラウザ
プロジェクトのすべてのファイルが含まれます。ポップオーバーには次の注意が表示されます：Every project file is included. Check for keys and credentials first.
サイズの上限
| 上限 | 値 |
|---|---|
| ファイル数 | 500 |
| 合計サイズ | 100 MB |
| 1ファイル | 25 MB未満 |
上限を超えたプロジェクトは公開できず、ポップオーバーにどの上限に達したかが表示されます。大きな生成ファイルを .gitignore に追加して、上限内に収めてください。
更新、変更、共有の停止
プロジェクトが公開されると、フッターには次のボタンがあります。
| ボタン | 動作 |
|---|---|
| Update shared copy | 最後に保存したファイルを同じリンクに公開します。デスクトップでは、変更されたファイルだけがアップロードされます（Syncing 3 of 3 files...）。 |
| Publish changes | General accessやOpens withを変更したときに、Update shared copy の代わりに表示されます。それらの設定を最新のファイルとともに公開します。 |
| Make private | 確認（"The link stops working for everyone."）の後、公開を停止します。 |
更新の前にファイルを保存してください。エディタの未保存の変更は含まれません。
共有フォルダの移動や名前変更（デスクトップ）
初めて公開するとき、Embedrは embedr.yaml にプロジェクトIDを追加し、フォルダの名前を変えたり移動したりしてもリンクがプロジェクトについていくようにします。ポップオーバーでそのことが事前に知らされます。embedr.yaml にIDを追加できない場合（構文エラーがある場合など）は、フォルダの名前変更や移動の後はリンクが引き継がれないことがポップオーバーに表示されます。
共有したプロジェクトのコピーを別のフォルダから開いた場合（バックアップから復元した、別のドライブにコピーしたなど）、Shareには元のパスとともに This project was shared from another folder と表示され、2つの選択肢が示されます。
| ボタン | 使う場面 |
|---|---|
| Keep that link | 同じプロジェクトをここに移動した場合。このフォルダが既存のリンクを引き継ぎます。 |
| Share separately | 別のコピーの場合。このフォルダは、公開したときに独自のリンクを持ちます。 |
リンクはコンピューターごと、アカウントごとに記憶されます。別のアカウントでサインインすると、そのアカウントの共有状態が表示されます。
閲覧者に表示される内容
共有リンクを開くと、ブラウザでプロジェクトが読み取り専用で開きます。上部のバーには Read-only public revision と表示され、次のボタンがあります。
| ボタン | 動作 |
|---|---|
| Download files | 共有ファイルを .zip でダウンロードします。 |
| Download firmware | 共有コピーにビルド済みのファームウェアが含まれる場合に表示されます。それをダウンロードします。 |
| Fork project | 閲覧者自身のアカウントにプロジェクトをコピーし、編集、ビルド、エージェントの実行ができるようにします。サインインしていない閲覧者には Sign in to fork と表示されます。 |
共有コピーに、ブラウザから書き込めるボード向けのファームウェアが含まれている場合、閲覧者はWeb Serialを使って Flash で書き込むこともできます。ビルド、書き込み、シリアルを参照してください。
READMEと、Opens with で選んだタブは固定された状態で開きます。Markdownはプレビューで表示され、ターミナルを使うには先にフォークするよう求められます。
招待制のプロジェクト
特定の人とプロジェクトを共有した場合：
- サインインしていない閲覧者には Sign in to view project name と Sign in ボタンが表示されます。招待されたメールアドレスでサインインする必要があります。
- 招待されていない人がサインインして開くと、You don't have access to this project と Ask the owner to invite their email. が表示されます。Sign in with a different account をクリックして別のアカウントを選ぶか、Back to projects で戻れます。
- メールアドレスがまだ確認されていない場合は、確認してからもう一度リンクを開くよう案内されます。
非公開にされたリンクや、存在しないリンクには Project not found と表示されます。