d302591c25
OnlyOffice fallaba al editar y al descargar SOLO en la app de escritorio de Windows. En el navegador y en la app de macOS iba bien. La causa estaba en el propio shell, no en el servidor de documentos. En Windows, wry inyecta los scripts de inicio en TODOS los marcos e ignora for_main_frame_only (wry-0.55.1/src/webview2/mod.rs:492-495, documentado en su lib.rs:990); macOS si respeta la bandera (wkwebview/mod.rs:643-645). Y __TAURI__ viaja con ellos, asi que la guarda «if (!T || !T.event) return» no frenaba nada. Resultado: INIT_JS_TPL corria DENTRO del iframe del Document Server con ORIGIN apuntando todavia a la app; como alli location.href es el de docs.*, cada enlace del editor se resolvia contra ese origen, daba isExt() = true y se desviaba al navegador del sistema —que no tiene la sesion: «no se puede acceder»—, y window.open devolvia null. Cambios: 1. Guarda de marco y origen al principio del script inyectado: solo actua en el documento PRINCIPAL y solo en el origen de la app. En macOS es un no-op (alli nunca corrio en subframes). De paso arregla que en Windows el shell tambien secuestrara los enlaces de las paginas de SSO. 2. El manejador de atajos ignora e.altKey. AltGr enciende ctrlKey en Windows, asi que escribir [ o ] con teclado espanol disparaba history.back()/forward() en vez de escribir el caracter — en el editor y en cualquier campo de la app. 3. Aviso nativo al terminar una descarga. No es un adorno: wry trae un manejador de descargas por defecto (wry-0.55.1/src/lib.rs:830), de modo que en WebView2 siempre se registra DownloadStarting y siempre responde SetHandled(true) (webview2/mod.rs:858-861), lo que apaga la interfaz de descargas de Windows. El archivo bajaba a Descargas pero nada lo decia y parecia roto. Quitar el manejador NO devuelve la interfaz nativa: el de wry sigue puesto. 4. Feature «devtools» de tauri: el inspector queda disponible tambien en release. Sin el, un fallo que solo aparece en la app instalada no se puede mirar por dentro. Descartado a proposito: registrar on_new_window. En macOS el delegado ejecuta webview.window().unwrap() y current_window.screen().unwrap() ANTES del match (wry-0.55.1/src/wkwebview/class/wry_web_view_ui_delegate.rs:150-154), tambien en la rama Deny; y este shell oculta la ventana al cerrar, con lo que NSWindow.screen puede ser nil y la app entera abortaria. Cambiar un fallo de Windows por un crash en macOS no compensa. Verificado: cargo check limpio; sintaxis del script inyectado validada con node; y simulacion de la guarda — marco principal + origen propio interviene, iframe de OnlyOffice no interviene, origen ajeno no interviene. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Labstream OS — App de escritorio (Windows + macOS)
Cliente de escritorio para Labstream OS, hecho con Tauri 2.
Desde la v1.1.0 no es un envoltorio de una sola vista: es un shell con pestañas
(multiwebview) sobre el servidor del NAS (https://os.labstreamsas.com).
No contiene la app: el backend, la base de datos, OnlyOffice, etc. siguen en el NAS. Esto le da al equipo un cliente nativo de verdad en Windows y Mac:
- Pestañas como en un navegador: los enlaces internos con
target="_blank"(documentos, entregables, exportaciones, OnlyOffice…) abren pestaña dentro de la app — antes morían en silencio. También ⌘/Ctrl+clic y clic central. Atajos: ⌘/Ctrl+T nueva, ⌘/Ctrl+W cerrar, Ctrl+Tab rotar, ⌘/Ctrl+1…9 ir a la n. La sesión (pestañas abiertas, activa) se restaura al reabrir. - Zoom de interfaz: ⌘/Ctrl
+/−/0y Ctrl+rueda, con indicador en la barra y persistencia entre sesiones (50%–250%). - Documentos dentro de la app: los visores/editores del propio servidor (OnlyOffice, PDFs, reproductor de revisión) abren en pestañas; solo lo de OTRO origen (Drive…) sale al navegador del sistema. El login por Authentik sigue funcionando dentro.
- Notas de voz / cámara: pide permiso de micrófono y cámara (entitlements de macOS).
- Descargas (entregables, exportaciones) con el diálogo nativo de guardado.
- Bandeja del sistema: cerrar la ventana la oculta; la app sigue notificando. En macOS, el clic en el Dock también reabre la ventana, y hay menú nativo en español (Edición/Vista/Archivo) con los atajos.
- Arranque automático al iniciar sesión y sesión persistente (no re-loguea).
- Una sola instancia (release): abrirla de nuevo enfoca la ventana existente.
- Menú de opciones ⋮ (v1.2.0) en la barra — también con clic derecho sobre ella: pestañas, zoom, recargar, abrir la página en el navegador, Iniciar con el sistema (elección recordada) y Buscar actualización… con aviso del resultado. Es un popup nativo del sistema, igual en Windows y macOS, y vive solo en el shell (la web app no se toca).
La barra de pestañas vive en dist/index.html (webview local «chrome»); las
pestañas son webviews hijos tab-*. Shell ↔ Rust se hablan por eventos ls-*.
El servidor objetivo se configura en src-tauri/src/lib.rs → constante SERVER_URL.
Salidas:
- Windows → instalador
.exe(NSIS). - macOS →
.dmguniversal (funciona en Intel y Apple Silicon).
Prerrequisitos (solo para construir)
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+
- Rust (incluye
cargo) - En Windows: "Visual Studio Build Tools" con el componente de C++.
- En Mac: Xcode Command Line Tools (
xcode-select --install).
⚠️ Cada sistema se construye en su sistema: el
.exese compila en Windows y el.dmgen 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.dmgsí lo puedes hacer en local.
Construir los instaladores con GitHub Actions (recomendado)
Genera ambos instaladores sin tener las dos máquinas a mano:
- Sube este proyecto a su propio repositorio (ej.
Labstream2026/labstream-desktop). - Cambia la versión en dos sitios (deben coincidir):
src-tauri/tauri.conf.json→"version"src-tauri/Cargo.toml→version- (opcional)
package.json→"version"
- Crea y publica la etiqueta de versión:
git commit -am "Versión 1.1.0" git tag v1.1.0 git push origin main --tags - 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 Actions → Build instaladores → Run workflow (los instaladores quedan como artifacts).
Construir en local
En Mac (tu máquina) → genera el .dmg
npm install
npm run icons
npm run tauri build -- --bundles dmg
El .dmg queda en:
src-tauri/target/release/bundle/dmg/Labstream OS_<versión>_<arch>.dmg
Para un
.dmguniversal (Intel + Apple Silicon) en local: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
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.
Versiones (SemVer)
Se usa MAYOR.MENOR.PARCHE:
| Cambio | Ejemplo |
|---|---|
| Corrección / arreglo | 1.0.0 → 1.0.1 |
| Función nueva compatible | 1.0.1 → 1.1.0 |
| Cambio grande / incompatible | 1.1.0 → 2.0.0 |
La versión del envoltorio es independiente de la de la app web
(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 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):
- Genera el par de claves de firma:
npm run tauri signer generate -- -w ~/.tauri/labstream.key - Añade el
plugin-updatery la clave pública entauri.conf.json, y guarda la clave privada como secret en GitHub (TAURI_SIGNING_PRIVATE_KEY). - Apunta el updater al
latest.jsonque publica el Release.
Se deja sin activar a propósito para que la primera versión compile sin configuración extra.
Avisos de seguridad del sistema (instalación interna sin firmar)
Como los instaladores no están firmados con certificado de pago, la primera vez cada sistema muestra una advertencia. Es normal para apps internas:
- 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 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.
Estructura
labstream-desktop/
├── app-icon.png fuente del ícono (1024×1024)
├── dist/index.html pantalla de respaldo (requerida por Tauri)
├── package.json scripts de build
├── src-tauri/
│ ├── tauri.conf.json nombre, versión, iconos, instaladores, entitlements
│ ├── Cargo.toml dependencias Rust + versión
│ ├── Info.plist textos de permiso (micrófono/cámara) en macOS
│ ├── Entitlements.plist entitlements de macOS (audio-input, cámara, red)
│ ├── build.rs
│ ├── capabilities/default.json
│ ├── icons/ se generan desde app-icon.png
│ └── src/{main.rs,lib.rs} lib.rs crea la ventana + SERVER_URL + tray
└── .github/workflows/build.yml build automático de .exe (Windows) y .dmg (macOS)