max / balanced_breakfast
1 file changed,
+57 insertions,
-0 deletions
| @@ -0,0 +1,57 @@ | |||
| 1 | + | # Balanced Breakfast — Build & Deploy | |
| 2 | + | ||
| 3 | + | See `_meta/docs/deploy.md` for shared infrastructure (machines, git remotes, collection layout, shared deps). | |
| 4 | + | ||
| 5 | + | ## Artifacts | |
| 6 | + | ||
| 7 | + | | Platform | Artifact | Machine | | |
| 8 | + | |----------|----------|---------| | |
| 9 | + | | macOS aarch64 | .dmg | local | | |
| 10 | + | | Linux aarch64 | AppImage, .deb, .rpm | astra | | |
| 11 | + | | Linux x86_64 | AppImage, .deb, .rpm | pop-os | | |
| 12 | + | | Windows x86_64 | .msi, NSIS .exe | windows-x86 | | |
| 13 | + | ||
| 14 | + | ## Build Commands | |
| 15 | + | ||
| 16 | + | ```bash | |
| 17 | + | # macOS (local): | |
| 18 | + | cd ~/Code/Apps/balanced_breakfast && cargo tauri build | |
| 19 | + | cp target/release/bundle/dmg/*.dmg ~/Dist/balanced_breakfast/macos/ | |
| 20 | + | ||
| 21 | + | # Linux aarch64 (astra): | |
| 22 | + | ssh astra "source ~/.cargo/env && cd ~/Code/Apps/balanced_breakfast && git pull && cargo tauri build" | |
| 23 | + | scp astra:~/Code/Apps/balanced_breakfast/target/release/bundle/appimage/*.AppImage ~/Dist/balanced_breakfast/linux-aarch64/ | |
| 24 | + | scp astra:~/Code/Apps/balanced_breakfast/target/release/bundle/deb/*.deb ~/Dist/balanced_breakfast/linux-aarch64/ | |
| 25 | + | ||
| 26 | + | # Linux x86_64 (pop-os): | |
| 27 | + | ssh pop-os "source ~/.cargo/env && cd ~/Code/Apps/balanced_breakfast && git pull && cargo tauri build" | |
| 28 | + | scp pop-os:~/Code/Apps/balanced_breakfast/target/release/bundle/appimage/*.AppImage ~/Dist/balanced_breakfast/linux-x86_64/ | |
| 29 | + | scp pop-os:~/Code/Apps/balanced_breakfast/target/release/bundle/deb/*.deb ~/Dist/balanced_breakfast/linux-x86_64/ | |
| 30 | + | ||
| 31 | + | # Windows (windows-x86): | |
| 32 | + | ssh me@windows-x86 "cd C:\Users\me\Code\Apps\balanced_breakfast; git pull; cargo tauri build" | |
| 33 | + | scp me@windows-x86:"C:/Users/me/Code/Apps/balanced_breakfast/target/release/bundle/msi/*.msi" ~/Dist/balanced_breakfast/windows/ | |
| 34 | + | scp me@windows-x86:"C:/Users/me/Code/Apps/balanced_breakfast/target/release/bundle/nsis/*-setup.exe" ~/Dist/balanced_breakfast/windows/ | |
| 35 | + | ``` | |
| 36 | + | ||
| 37 | + | ## Project-Specific Notes | |
| 38 | + | ||
| 39 | + | - No `beforeBuildCommand` — no CSS build step. | |
| 40 | + | - Bundles Rhai plugins (`plugins/*.rhai`) and themes (`MNW/shared/themes/*.toml`) as resources. | |
| 41 | + | - Case collision on Windows: `docs/PLUGIN_AUTHORING.md` vs `docs/plugin_authoring.md` — harmless. | |
| 42 | + | - Version is in `src-tauri/tauri.conf.json`. | |
| 43 | + | ||
| 44 | + | ## Troubleshooting | |
| 45 | + | ||
| 46 | + | ### Version mismatch warning (Cargo) | |
| 47 | + | ||
| 48 | + | If you see Cargo warnings about "conflicting units" or "found two Cargo.toml that resolve to the same path", check that `src-tauri/Cargo.toml` version matches the intended release version. A stale version (e.g., 0.3.0 when it should be 0.3.1) causes this. Update `src-tauri/tauri.conf.json` AND `src-tauri/Cargo.toml` together. | |
| 49 | + | ||
| 50 | + | ### sccache crash on Windows (ico crate) | |
| 51 | + | ||
| 52 | + | BB's Tauri build compiles the `ico` crate for Windows icon embedding. If sccache is set as `RUSTC_WRAPPER`, it crashes on this crate. Fix: | |
| 53 | + | ||
| 54 | + | ```powershell | |
| 55 | + | $env:RUSTC_WRAPPER = '' | |
| 56 | + | cargo tauri build | |
| 57 | + | ``` |