Saltar al contenido principal

Compilar y contribuir

Organización del depósito​

RutaRol
Podbook.xcodeprojProyecto Xcode, esquema Podbook para iOS y macOS.
Packages/Core/Sources/CalibreKitCliente del servidor Calibre.
Packages/Core/Sources/PodbookUIBiblioteca, lectores, traducción, narración y anotaciones.
Packages/Core/TestsPruebas 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.