Compilar y contribuir
Organización del depósito
| Ruta | Rol |
|---|---|
Podbook.xcodeproj | Proyecto Xcode, esquema Podbook para iOS y macOS. |
Packages/Core/Sources/CalibreKit | Cliente del servidor Calibre. |
Packages/Core/Sources/PodbookUI | Biblioteca, lectores, traducción, narración y anotaciones. |
Packages/Core/Tests | Pruebas de los dos módulos. |
docs/ | Estudios de diseño y levantamiento de API Calibre. |
website/ | Esta documentación Docusaurus. |
scripts/ | Iconos y entrega de la aplicación. |
Compile la solicitud
Utilice un Xcode compatible con las plataformas de destino del proyecto. Desde la raíz:
xcodebuild -project Podbook.xcodeproj -scheme Podbook \
-destination 'generic/platform=iOS' build
xcodebuild -project Podbook.xcodeproj -scheme Podbook \
-destination 'generic/platform=macOS' build
Para verificar sin firma, agregue CODE_SIGNING_ALLOWED=NO. La instalación en el dispositivo requiere una configuración de firma adecuada. La compilación de un simulador no valida la traducción de Apple ni la salida de audio.
Pruebas y sobre macOS
cd Packages/Core
swift test
swift run PodbookApp
El paquete condiciona las dependencias Readium a iOS. El sobre macOS le permite inspeccionar la biblioteca y el PDF; no proporciona un reproductor EPUB.
Las pruebas utilizan en particular un transporte Calibre simulado, cachés aislados y un narrador ficticio. Verifican la persistencia, las posiciones, la elección de voz, el seguimiento de oraciones y la eliminación de anotaciones. No validan de oído una voz ni una traducción real del sistema.
Sondear un servidor
Desde Packages/Core, la sonda inspecciona un servidor de desarrollo:
swift run calibre-probe http://mac.local:8080
La conversión modifica la biblioteca del servidor. Utilice su opción dedicada solo para una solicitud explícita en una biblioteca adecuada para pruebas.
Estudios técnicos
El especificaciones y documentos de diseño permanece publicado desde docs/. Algunas páginas describen la arquitectura deseada, estimaciones o vías de futuro; la guía del usuario y el código son los puntos de referencia para los comandos presentes.
El lectura de API Calibre introduce rutas, convenciones de biblioteca y límites de validación.
Documentación y entrega
El sitio se construye independientemente de Swift. el guía editorial muestra vista previa local, URL y páginas CI GitLab.
Usos de entrega de aplicaciones scripts/release.sh y configuraciones regionales no versionadas. La publicación de documentación no ejecuta este script ni firma la aplicación.