Añadir build de macOS (.dmg universal) además de Windows
Workflow en matriz que genera .exe (NSIS) y .dmg (Intel+Apple Silicon) en cada versión. targets=all en la config y selección por --bundles. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Este commit está contenido en:
Labstream
97
README.md
97
README.md
@@ -1,4 +1,4 @@
|
||||
# Labstream OS — App de escritorio (Windows)
|
||||
# Labstream OS — App de escritorio (Windows + macOS)
|
||||
|
||||
Envoltorio de escritorio para **Labstream OS**. Es un cliente delgado hecho con
|
||||
[Tauri 2](https://tauri.app): abre una ventana propia (sin barra de navegador)
|
||||
@@ -6,32 +6,38 @@ que carga el servidor de Labstream OS que corre en el NAS
|
||||
(`https://os.labstreamsas.com`).
|
||||
|
||||
No contiene la app: el backend, la base de datos, OnlyOffice, etc. siguen en el
|
||||
NAS. Esto solo le da al equipo un ícono y una ventana propia en Windows.
|
||||
NAS. Esto solo le da al equipo un ícono y una ventana propia en Windows y Mac.
|
||||
|
||||
El servidor objetivo se configura en `src-tauri/tauri.conf.json` →
|
||||
`app.windows[0].url`.
|
||||
|
||||
Salidas:
|
||||
|
||||
- **Windows** → instalador `.exe` (NSIS).
|
||||
- **macOS** → `.dmg` universal (funciona en Intel y Apple Silicon).
|
||||
|
||||
---
|
||||
|
||||
## Prerrequisitos (solo para construir)
|
||||
|
||||
Quien instala el `.exe` **no necesita nada** (WebView2 ya viene en Windows 10/11).
|
||||
Para *construir* el instalador hacen falta:
|
||||
Quien instala **no necesita nada** (en Windows, WebView2 ya viene en Win 10/11;
|
||||
en Mac, el WebView del sistema). Para *construir* hacen falta:
|
||||
|
||||
- [Node.js 20+](https://nodejs.org)
|
||||
- [Rust](https://rustup.rs) (incluye `cargo`)
|
||||
- En Windows: las "Visual Studio Build Tools" con el componente de C++.
|
||||
- En Windows: "Visual Studio Build Tools" con el componente de C++.
|
||||
- En Mac: Xcode Command Line Tools (`xcode-select --install`).
|
||||
|
||||
> ⚠️ **Importante:** el `.exe` de Windows se construye **en Windows**. Tauri no
|
||||
> compila de forma cruzada desde macOS de manera fiable. Por eso lo normal es
|
||||
> dejar que **GitHub Actions** lo construya (ver más abajo). Si quieres hacerlo
|
||||
> a mano, usa una PC o máquina virtual con Windows.
|
||||
> ⚠️ **Cada sistema se construye en su sistema:** el `.exe` se compila en Windows
|
||||
> y el `.dmg` en Mac. Tauri no compila de forma cruzada de manera fiable. Por eso
|
||||
> lo normal es dejar que **GitHub Actions** construya ambos (ver abajo). Como
|
||||
> excepción cómoda: si trabajas en Mac, el `.dmg` **sí** lo puedes hacer en local.
|
||||
|
||||
---
|
||||
|
||||
## Construir el instalador con GitHub Actions (recomendado)
|
||||
## Construir los instaladores con GitHub Actions (recomendado)
|
||||
|
||||
El flujo no requiere tener Windows a mano:
|
||||
Genera **ambos** instaladores sin tener las dos máquinas a mano:
|
||||
|
||||
1. Sube este proyecto a su propio repositorio (ej. `Labstream2026/labstream-desktop`).
|
||||
2. Cambia la versión en **dos** sitios (deben coincidir):
|
||||
@@ -44,27 +50,45 @@ El flujo no requiere tener Windows a mano:
|
||||
git tag v1.1.0
|
||||
git push origin main --tags
|
||||
```
|
||||
4. GitHub Actions construye el `.exe` y lo publica en **Releases**. El equipo lo
|
||||
descarga desde ahí: `https://github.com/Labstream2026/labstream-desktop/releases`.
|
||||
4. GitHub Actions construye el `.exe` (Windows) y el `.dmg` (macOS) en paralelo y
|
||||
los publica juntos en **Releases**:
|
||||
`https://github.com/Labstream2026/labstream-desktop/releases`.
|
||||
|
||||
También puedes lanzarlo a mano sin etiqueta desde la pestaña **Actions →
|
||||
Build instalador Windows → Run workflow** (el `.exe` queda como *artifact*).
|
||||
También puedes lanzarlo a mano sin etiqueta desde **Actions → Build instaladores
|
||||
→ Run workflow** (los instaladores quedan como *artifacts*).
|
||||
|
||||
---
|
||||
|
||||
## Construir en local (en una PC Windows)
|
||||
## Construir en local
|
||||
|
||||
### En Mac (tu máquina) → genera el `.dmg`
|
||||
|
||||
```bash
|
||||
npm install
|
||||
npm run build # genera iconos + compila el instalador
|
||||
npm run icons
|
||||
npm run tauri build -- --bundles dmg
|
||||
```
|
||||
|
||||
El instalador queda en:
|
||||
El `.dmg` queda en:
|
||||
```
|
||||
src-tauri/target/release/bundle/nsis/Labstream OS_<versión>_x64-setup.exe
|
||||
src-tauri/target/release/bundle/dmg/Labstream OS_<versión>_<arch>.dmg
|
||||
```
|
||||
|
||||
Para desarrollo con recarga en caliente: `npm run dev`.
|
||||
> Para un `.dmg` universal (Intel + Apple Silicon) en local:
|
||||
> ```bash
|
||||
> rustup target add aarch64-apple-darwin x86_64-apple-darwin
|
||||
> npm run tauri build -- --target universal-apple-darwin --bundles dmg
|
||||
> ```
|
||||
|
||||
### En una PC Windows → genera el `.exe`
|
||||
|
||||
```bash
|
||||
npm install
|
||||
npm run tauri build -- --bundles nsis
|
||||
```
|
||||
Queda en `src-tauri/target/release/bundle/nsis/Labstream OS_<versión>_x64-setup.exe`.
|
||||
|
||||
Para desarrollo con recarga en caliente (en cualquier sistema): `npm run dev`.
|
||||
|
||||
---
|
||||
|
||||
@@ -79,17 +103,16 @@ Se usa `MAYOR.MENOR.PARCHE`:
|
||||
| Cambio grande / incompatible | 1.1.0 → 2.0.0 |
|
||||
|
||||
La versión del **envoltorio** es independiente de la de la app web
|
||||
(`labstream-os`). Como la ventana siempre apunta al mismo servidor, casi nunca
|
||||
chocan; documenta aquí si en algún momento una versión del envoltorio exige una
|
||||
versión mínima del backend.
|
||||
(`labstream-os`). Una sola etiqueta de versión genera el instalador de Windows y
|
||||
el de Mac a la vez, así ambas plataformas van siempre sincronizadas.
|
||||
|
||||
---
|
||||
|
||||
## Actualización automática (opcional, recomendable a futuro)
|
||||
|
||||
Hoy, para actualizar, el equipo descarga el nuevo `.exe` del Release y lo
|
||||
reinstala encima. Para que las apps ya instaladas se actualicen solas, Tauri
|
||||
trae un *updater*. Para activarlo (paso futuro):
|
||||
Hoy, para actualizar, el equipo descarga el nuevo instalador del Release y lo
|
||||
reinstala encima. Para que las apps ya instaladas se actualicen solas, Tauri trae
|
||||
un *updater* (funciona igual en Windows y Mac). Para activarlo (paso futuro):
|
||||
|
||||
1. Genera el par de claves de firma:
|
||||
```bash
|
||||
@@ -104,16 +127,20 @@ configuración extra.
|
||||
|
||||
---
|
||||
|
||||
## Aviso de SmartScreen (instalación interna)
|
||||
## Avisos de seguridad del sistema (instalación interna sin firmar)
|
||||
|
||||
Como el instalador **no está firmado** con un certificado de pago, Windows
|
||||
mostrará una pantalla azul *"Windows protegió su PC"* la primera vez. Es normal
|
||||
para apps internas:
|
||||
Como los instaladores **no están firmados** con certificado de pago, la primera
|
||||
vez cada sistema muestra una advertencia. Es normal para apps internas:
|
||||
|
||||
> **Más información → Ejecutar de todos modos**
|
||||
- **Windows (SmartScreen):** pantalla azul *"Windows protegió su PC"* →
|
||||
**Más información → Ejecutar de todos modos**.
|
||||
- **macOS (Gatekeeper):** *"no se puede abrir porque proviene de un desarrollador
|
||||
no identificado"* → clic derecho sobre la app → **Abrir** → **Abrir**. (Si
|
||||
insiste, ejecutar una vez: `xattr -cr "/Applications/Labstream OS.app"`.)
|
||||
|
||||
Si en el futuro se distribuye a clientes externos, conviene un certificado de
|
||||
*code signing* (~150–400 USD/año) para quitar ese aviso.
|
||||
Si en el futuro se distribuye a clientes externos, conviene firmar:
|
||||
*code signing* en Windows (~150–400 USD/año) y un *Apple Developer ID* + notarizado
|
||||
en Mac (99 USD/año) para quitar estos avisos.
|
||||
|
||||
---
|
||||
|
||||
@@ -125,11 +152,11 @@ labstream-desktop/
|
||||
├── dist/index.html pantalla de respaldo (requerida por Tauri)
|
||||
├── package.json scripts de build
|
||||
├── src-tauri/
|
||||
│ ├── tauri.conf.json nombre, versión, URL del servidor, instalador
|
||||
│ ├── tauri.conf.json nombre, versión, URL del servidor, instaladores
|
||||
│ ├── Cargo.toml dependencias Rust + versión
|
||||
│ ├── build.rs
|
||||
│ ├── capabilities/default.json
|
||||
│ ├── icons/ se generan desde app-icon.png
|
||||
│ └── src/{main.rs,lib.rs}
|
||||
└── .github/workflows/build-windows.yml build automático del .exe
|
||||
└── .github/workflows/build.yml build automático de .exe (Windows) y .dmg (macOS)
|
||||
```
|
||||
|
||||
Referencia en una nueva incidencia
Block a user