Contribuir a Paper

Usa Xcode 27 o posterior, Node 24 y un Mac con Apple Silicon. Inicializa la revisión exacta del submódulo Platform con git submodule update --init --recursive. Si modificas los archivos incorporados de Deckle o Record, actualiza también su procedencia y las pruebas conservadas.

Cierra la copia instalada de Paper antes de ejecutar una compilación de desarrollo o las pruebas nativas. De lo contrario, la regla de instancia única abre la app que ya estaba en ejecución. Los ajustes habituales de la app están separados de las preferencias desechables de las pruebas nativas.

Antes de abrir un pull request:

node script/validate.mjs
node --test Tests/relay/*.test.mjs
swift test --package-path shared/dust-wave-platform/desktop
swift test
./script/build_and_run.sh --verify

CI ejecuta las mismas comprobaciones de código, contratos y Swift, y compila una app con firma ad hoc en el runner oficial de GitHub xcode-27. La entrada real del puntero, el inicio de sesión, HDR en hardware físico, otras versiones del sistema y la instalación real de actualizaciones se comprueban por separado. Consulta pruebas.

Mantén las reglas puras de visibilidad y horarios en PaperCore, y las integraciones del sistema en adaptadores acotados. Conserva una app pequeña y reutiliza los módulos compartidos. No añadas capturas de pantalla, event taps, cambios de gamma, envíos ocultos ni un actualizador propio. Los contratos de informes específicos se quedan en Paper; la agregación del relay sigue siendo compartida. Mantén exactos Package.resolved y la revisión de Platform.

Incluye pasos claros para reproducir el problema y las comprobaciones pertinentes. Usa informes y medios sintéticos como ejemplos. Nunca añadas al repositorio credenciales, registros reales de fallos, rutas privadas ni resultados locales. Las compilaciones van en dist/ y las pruebas de entrega en outputs/, ambos ignorados por Git. La app usa MIT; las herramientas separadas de pruebas de pantalla usan GPL-3.0 y no deben incluirse en Paper.app.

Material de origen

Esta página sigue el código de Paper en 8713988. Su contenido técnico se mantiene en CONTRIBUTING.md. Los detalles sobre los servicios de este sitio web se mantienen aquí.