Skip to content

docs(web): la web y el manual explican cómo instalar rFirma en macOS - #2061

Merged
sgomez merged 6 commits into
mainfrom
agent/issue-2059-macos-install-docs
Oct 20, 2026
Merged

sgomez merged 6 commits into
mainfrom
agent/issue-2059-macos-install-docs

Conversation

@sgomez

@sgomez sgomez commented Oct 20, 2026 •

Copy link
Copy Markdown
Owner

Closes #2059

What changed

  • Pestaña macOS de la web: brew install --cask sgomez/rfirma/rfirma (con botón de copiar), botón de descarga del .dmg y la nota de xattr -c /Applications/rfirma.app para la primera vez, en los cinco idiomas. Se retira la clave install.soon, sin uso.
  • El botón del .dmg descarga del servidor propio, como el de Windows: la landing lo saca de /macos/latest.json (el nombre de la actualización con .dmg, que es como lo nombra just bundle). Sin el feed, el enlace se queda en la Release. El .dmg en /macos/ lo pone ci(macos): El CI de macOS instala y desinstala el cask con el paquete recién construido #2062. windows-download.ts pasa a server-download.ts, que sirve a los dos.
  • Textos de instalación de Windows y macOS, en la web y en el manual, en frases cortas y sin tecnicismos.
  • El JSON-LD declara macOS.

Test plan

  • server-download.test.ts: URL del instalador de Windows, del .dmg a partir de la actualización, y la Release si el feed apunta fuera o no trae la plataforma.
  • just check-landing en verde en local.

Implements #2059: La web y el manual explican cómo instalar rFirma en macOS
- pestaña macOS con brew, enlace al .dmg de la última Release y nota de xattr -c
- manual: actualizaciones, llavero y qué retirar antes de brew uninstall
Implements #2059: el cask no puede quitar la cuarentena (ID-553 corregida)

@sgomez sgomez left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

NEEDS_FIXES. El código no necesita cambios; lo que bloquea es el orden de merge.

Alcance: completo (no había reviews previas), head a65c0951. Checks del CI para ese sha: Landing en verde (las cadenas Rust, TS y Java se saltan por alcance). CodeQL seguía en marcha: Analyze (python), Analyze (javascript-typescript) y Analyze (java-kotlin).

[blocking]

  • #2059 está bloqueado por #2023, que sigue abierto, y el tap no existe. sgomez/homebrew-rfirma no se resuelve en GitHub y la última Release (v0.15.0) no trae .dmg. El propio issue da el motivo del bloqueo: «la web no anuncia un tap que aún no instala». La web se publica con la próxima tag cortada desde main (release.yml), así que si esta PR entra ahora, brew install --cask sgomez/rfirma/rfirma falla para quien lo copie de la web o del manual. Hay que retener el merge hasta que #2023 esté cerrado, con el tap público, y la Release que acompañe a la web traiga el .dmg de Apple Silicon.

[note]

  • Lo de «retira desde rFirma» es cierto y está en el código de main. En macOS, el botón Retirar certificado de la fila de la CA local del panel de estado (StatusView.tsx, visible si esa fila sale correct) llama a withdraw_rfirma (desktop/adapters/tauri.rs). Con una sola acción, la orden quita los ajustes de confianza del dominio de usuario y borra las copias del llavero (MacosUserTrust::withdraw, con SecTrustSettingsRemoveTrustSettings y SecItemDelete, en site/adapters/macos_trust.rs), y devuelve afirma:// a la siguiente app que lo declare (LaunchServices::remove_for, prueba withdrawing_rfirma_hands_the_scheme_back_to_autofirma). Lo que dice el README del tap («borra la CA en Acceso a Llaveros», «abre AutoFirma para volver a ella») es la vía manual y se queda corto: es el README el que conviene alinear con este manual en #2023, no al revés.
  • El párrafo de macOS dice «retira desde rFirma» sin nombrar la acción. La sección «Antes de desinstalar» de más abajo sí la nombra, pero la presenta solo como lo del navegador. Si se nombrara aquí (Retirar certificado, en el panel de estado, que en macOS también suelta afirma://), el paso se podría seguir sin bajar a esa sección.
  • El botón «Descargar el .dmg de macOS» lleva a la página de la Release, no al fichero. Es razonable: latest.json solo publica el .app.tar.gz del actualizador, así que no hay un mountWindowsDownload que se pueda reutilizar.
  • Revisado y correcto: macOS 15.4 coincide con minimumSystemVersion (packaging/macos/tauri.macos.json, ADR-0040); rfirma_<versión>_aarch64.dmg coincide con el nombre del bundle de Tauri (productName: rfirma); el botón de copiar usa el [data-copy-for] genérico de Landing.astro; install.soon ya no tiene usos; las claves nuevas están en los cinco idiomas; Linux y Windows no cambian.

<span class="install-copy__idle">{t("install.copy")}</span>
<span class="install-copy__done">{t("install.copied")}</span>
</button>
<pre id="code-macos" class="install-code">brew install --cask sgomez/rfirma/rfirma</pre>

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[blocking] Esta orden aún no instala nada: sgomez/homebrew-rfirma no existe y #2023, del que depende #2059 («la web no anuncia un tap que aún no instala»), sigue abierto. No hay que tocar el código. Lo que hay que hacer es retener el merge hasta que el tap sea público y una Release traiga el .dmg de Apple Silicon.

actualizar, el llavero puede volver a pedirte permiso para que rFirma use tus
certificados; es esperable.

Antes de ejecutar `brew uninstall`, retira desde rFirma lo que dejó en tu usuario: el

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[note] Comprobado en main: Retirar certificado (panel de estado → withdraw_rfirma) quita en macOS la CA local de la confianza del usuario y del llavero, y devuelve afirma:// a la siguiente app que lo declare. La afirmación es correcta. Podría nombrar la acción aquí, como hace «Antes de desinstalar».

@sgomez
sgomez marked this pull request as ready for review October 20, 2026 10:08
@sgomez
sgomez merged commit 78d8f4f into main Oct 20, 2026
14 checks passed
@sgomez
sgomez deleted the agent/issue-2059-macos-install-docs branch October 20, 2026 10:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

La web y el manual explican cómo instalar rFirma en macOS

1 participant