Tutorial de instalación en Windows

Para Windows 11, con instaladores x64 y ARM64.

En esta página

El instalador de Hangrail para Windows usa un certificado de desarrollo fijo. Aún no se distribuye mediante Microsoft Store y el sistema no confía en el certificado de forma predeterminada. En un equipo nuevo, debes comprobar el editor y decidir si confías en él. Si el equipo ya confía en el mismo certificado, las actualizaciones normales no requieren importarlo de nuevo.

Descarga el instalador adecuado para tu equipo

Abre la sección de descargas de Hangrail. En China puedes priorizar Gitee y usar el enlace alternativo de GitHub si la conexión falla. Elige x64 para equipos Intel/AMD y ARM64 para Windows ARM. Puedes comprobarlo en «Tipo de sistema», en «Configuración → Sistema → Información».

Para la primera instalación, elige el archivo de tu arquitectura Setup.zip. Tras descomprimirlo por completo, la carpeta debe contener un instalador cuyo nombre termine en -Setup.exe, el certificado público Hangrail-Development.cer y las instrucciones Windows-INSTALL.txt. Conserva estos archivos, comprueba primero el certificado y ejecuta después el instalador.

Comprueba el certificado de desarrollo

Haz doble clic en Hangrail-Development.cer para ver el certificado y comprueba el sujeto y la huella en «Detalles». La identidad fija actual es:

Dato que comprobarValor que debe coincidir
Sujeto del certificadoCN=Hangrail Development
Huella SHA-1FA0ED6F4EE444CCA0A6FB851FA37C409B2FBF7B4
SHA-256 del archivo CER5FD005C38FE08C072B91DCB723A9FD6F508704B6A06BBB4432DE8B78928B5EDF

Para comprobar el resumen del CER, abre PowerShell en la carpeta extraída y ejecuta Get-FileHash .\Hangrail-Development.cer -Algorithm SHA256. Las mayúsculas y minúsculas no afectan a la comparación. En «Notas de la versión», en las descargas oficiales, encontrarás el archivo de esa versión SHA256SUMS.txt; sustituye el nombre del archivo del comando por la ruta completa del ZIP descargado para comprobar su resumen. El resumen del certificado no sustituye al del instalador.

Tener el mismo nombre no significa que sea el mismo certificado. Si algún resumen o huella no coincide, detén la instalación y vuelve a verificar el origen en las descargas oficiales.

Decide si confías en el editor

Continúa solo si has confirmado que el origen y el certificado coinciden y quieres confiar en ese editor:

  1. Haz doble clic en el CER público y pulsa «Instalar certificado».
  2. Elige «Equipo local» como ubicación del almacén y confirma los permisos de administrador cuando el sistema lo solicite.
  3. Elige «Colocar todos los certificados en el siguiente almacén», pulsa «Examinar» y selecciona «Personas de confianza».
  4. Confirma el almacén elegido, completa la importación y abre el instalador de la misma carpeta cuyo nombre termine en -Setup.exe.

No selecciones «Entidades de certificación raíz de confianza». Importar en «Equipo local → Personas de confianza» hace que este equipo confíe en los instaladores firmados con ese certificado. Su alcance va más allá del archivo descargado y también afecta a los demás usuarios del equipo. No convierte el certificado en un respaldo de Microsoft ni de una autoridad de certificación pública. El instalador no importa certificados ni cambia la confianza del sistema por sí mismo.

Instala la aplicación y sus componentes de ejecución

Si Hangrail está abierto, guarda las notas y sal normalmente desde el menú de la bandeja. Abre el instalador y pulsa «Instalar Hangrail» (安装 Hangrail). El instalador comprueba el entorno de ejecución de escritorio de .NET para tu arquitectura; si falta, lo descarga del sitio oficial de Microsoft, verifica su resumen y firma digital de Microsoft y te guía para instalarlo. Puede pedir confirmación de administrador.No necesitas instalar .NET SDK.

Si falla la red o cancelas, puedes volver a intentarlo después. Si el entorno de ejecución pide reiniciar, reinicia el equipo y abre otra vez el instalador de Hangrail. Instalar directamente el MSIX reducido no prepara automáticamente el entorno de ejecución; para la primera instalación se recomienda Setup.

Avisos de SmartScreen

Si aparece «Windows protegió su PC» indicando que se bloqueó una aplicación desconocida, comprueba primero el nombre, el origen de la descarga y el resumen del instalador. Solo si confías en este instalador, pulsa «Más información», revisa los detalles y elige «Ejecutar de todas formas», si está disponible. Esta confirmación es para esa ejecución; no necesitas desactivar SmartScreen. Consulta la guía de Microsoft para la primera distribución.

Si se detecta software malicioso, el certificado no coincide o la política del sistema no permite continuar, detén la instalación y comunica el problema. No desactives la protección ni añadas exclusiones para ejecutarlo.

Actualizaciones e instalación bloqueada

Las actualizaciones normales conservan la biblioteca, los grupos y los ajustes. Aun así, conviene crear antes una copia independiente de los datos importantes. Puedes comprobar actualizaciones en «Ajustes → Actualizar» (设置 → 更新) o salir normalmente y actualizar con el instalador oficial.

Si hay un bloqueo de seguridad, comprueba primero el origen de la descarga, la arquitectura, la firma y la confianza del certificado. Los equipos de empresa también pueden tener restricciones de instalación. No necesitas desactivar Defender, deshabilitar la comprobación de firmas ni activar el modo de prueba. Si sigues sin poder verificarlo, envía el error al soporte de Hangrail.

Para conocer los requisitos de firma y confianza de MSIX de Microsoft, consulta la introducción a la firma y la guía de firma de MSIX.