Commit 3bd11d70 authored by Kourser's avatar Kourser
Browse files

fix: la traduction accusait les langues, pas le simulateur

« La traduction ne semble pas fonctionner » : elle ne peut pas, et le
message disait pourquoi de travers.

Apple documente que le framework Translation ne traduit pas dans le
simulateur. Ce qu'il fait en revanche, c'est répondre « unsupported » à
LanguageAvailability — et l'app reprenait cette réponse telle quelle,
donc « Paire de langues non prise en charge ». Les langues n'y étaient
pour rien. Le motif est maintenant le simulateur, et il le dit.

Deux autres choses sont sorties en regardant ce code.

La disponibilité était vérifiée pour « en → fr » en dur, quelle que soit
la langue du livre — alors que la traduction elle-même passe source:nil
et laisse le framework détecter. Un livre en allemand s'annonçait donc
traduisible sur la foi d'une paire qu'on ne lui avait pas demandée. Le
lecteur connaît déjà la langue de la publication, il la transmet.

Et un livre déjà dans la langue cible le dit, au lieu de ressortir comme
une paire non prise en charge.

Vérifié à l'écran : sélection dans « Profileuse », Traduire, et le
panneau affiche « La traduction d'Apple ne fonctionne pas dans le
simulateur. Il faut un iPhone ou un iPad. »

Co-Authored-By: default avatarClaude Opus 5 <noreply@anthropic.com>
parent 9126de8f
Loading
Loading
Loading
Loading
+11 −0
Changes for CHANGELOG.md: 11 added lines, 0 removed lines.
Original line number Diff line number Diff line
@@ -15,6 +15,17 @@ adopte le [versionnage sémantique](https://semver.org/lang/fr/).
  effacées une fois le script écrit.

### Corrigé
- La traduction annonçait « Paire de langues non prise en charge » dans le
  simulateur. Apple documente que son framework `Translation` n'y traduit pas ;
  la vérification de disponibilité y répond « non pris en charge », et l'app
  reprenait cette réponse telle quelle — en accusant les langues d'un problème
  qui n'a rien à voir avec elles. Elle dit maintenant que c'est le simulateur.
- La disponibilité était vérifiée pour « en → fr » en dur, quelle que soit la
  langue du livre. Le lecteur connaît déjà celle de la publication et la
  transmet : un livre en allemand n'est plus annoncé traduisible sur la foi
  d'une paire qu'on n'a pas demandée.
- Un livre déjà en français le dit, au lieu de passer pour une paire de langues
  non prise en charge.
- Le Keychain refuse d'écrire sans droit déclaré. L'app n'avait que le droit de
  plafond mémoire ; `SecItemAdd` répondait `errSecMissingEntitlement` (-34018)
  et le mot de passe du serveur n'était jamais enregistré, y compris dans le
+40 −3
Changes for Packages/Core/Sources/PodbookUI/Translation/SentenceTranslator.swift: 40 added lines, 3 removed lines.
Original line number Diff line number Diff line
@@ -18,6 +18,13 @@ public enum TranslationModelStatus: Sendable, Hashable {
    /// the user; we cannot do it silently.
    case downloadable
    case unsupported
    /// The book is already in the target language.
    case sameLanguage
    /// Apple's framework does not translate in the Simulator, at all. Reported
    /// as its own case because the availability check there answers
    /// « unsupported », and showing that blames the language pair for
    /// something that has nothing to do with it.
    case simulator
    case frameworkUnavailable
    case unknown

@@ -28,6 +35,12 @@ public enum TranslationModelStatus: Sendable, Hashable {
        case .installed: "Modèle installé — traduction hors-ligne"
        case .downloadable: "Modèle à télécharger — iOS le proposera au premier usage"
        case .unsupported: "Paire de langues non prise en charge"
        case .sameLanguage: "Ce livre est déjà en français."
        case .simulator:
            """
            La traduction d'Apple ne fonctionne pas dans le simulateur. \
            Il faut un iPhone ou un iPad.
            """
        case .frameworkUnavailable: "Traduction Apple indisponible sur cette version du système"
        case .unknown: "Disponibilité inconnue"
        }
@@ -76,6 +89,20 @@ public final class SentenceTranslator {
    public let engineID = "apple.translation"
    public let targetLanguageCode: String

    /// The book's own language, when the reader knows it.
    ///
    /// Only the availability check needs it — the translation itself passes
    /// `source: nil` and lets the framework detect, so a French footnote in an
    /// English book is left alone. But checking availability against a
    /// hard-coded « en » answers the wrong question for a book in any other
    /// language.
    public var sourceLanguageCode: String? {
        didSet {
            guard oldValue != sourceLanguageCode else { return }
            Task { await refreshModelStatus() }
        }
    }

    private let cache: TranslationCache

    public init(cache: TranslationCache = TranslationCache(), targetLanguageCode: String = "fr") {
@@ -86,9 +113,19 @@ public final class SentenceTranslator {
    // MARK: - Availability

    public func refreshModelStatus() async {
        #if canImport(Translation)
        #if targetEnvironment(simulator)
        // Apple documents it: the framework returns nothing here. Asking
        // `LanguageAvailability` anyway answers « unsupported », which reads as
        // a problem with the languages and sends the search in that direction.
        modelStatus = .simulator
        #elseif canImport(Translation)
        let bookLanguage = sourceLanguageCode.map { String($0.prefix(2)) }
        if let bookLanguage, bookLanguage == String(targetLanguageCode.prefix(2)) {
            modelStatus = .sameLanguage
            return
        }
        let availability = LanguageAvailability()
        let source = Locale.Language(identifier: "en")
        let source = Locale.Language(identifier: bookLanguage ?? "en")
        let target = Locale.Language(identifier: targetLanguageCode)
        switch await availability.status(from: source, to: target) {
        case .installed: modelStatus = .installed
@@ -119,7 +156,7 @@ public final class SentenceTranslator {
            return
        }

        guard modelStatus != .frameworkUnavailable, modelStatus != .unsupported else {
        guard modelStatus.isUsable || modelStatus == .unknown else {
            phase = .failed(source: source, message: modelStatus.label)
            return
        }
+5 −0
Changes for Packages/Core/Sources/PodbookUI/Views/ReaderView.swift: 5 added lines, 0 removed lines.
Original line number Diff line number Diff line
@@ -252,6 +252,11 @@ public struct ReaderView: View {
                onTextSource: { source, language in
                    textSource = source
                    narrationLanguage = language
                    // La disponibilité se vérifie depuis la langue du livre et
                    // non depuis un « en » supposé : un livre en allemand
                    // s'annonçait traduisible parce qu'on interrogeait la
                    // mauvaise paire.
                    translator.sourceLanguageCode = language
                }
            )
            #else
+56 −0
Changes for Packages/Core/Tests/PodbookUITests/TranslationTests.swift: 56 added lines, 0 removed lines.
Original line number Diff line number Diff line
@@ -201,3 +201,59 @@ struct SentenceTranslatorTests {
                "la traduction de la phrase précédente ne doit pas écraser la demande en cours")
    }
}

@MainActor
@Suite("Pourquoi la traduction ne part pas")
struct TranslationRefusalTests {
    @Test("Dans le simulateur, le motif est le simulateur — pas la paire de langues")
    func simulatorSaysSo() async {
        let translator = SentenceTranslator()
        await translator.refreshModelStatus()

        #if targetEnvironment(simulator)
        #expect(translator.modelStatus == .simulator)
        let label = TranslationModelStatus.simulator.label
        #expect(label.contains("simulateur"))
        // « Paire de langues non prise en charge » accusait les langues d'un
        // problème qui n'a rien à voir avec elles.
        #expect(label.contains("paire") == false)
        #expect(label.contains("Paire") == false)
        #else
        #expect(translator.modelStatus != .simulator)
        #endif
    }

    @Test("Un livre déjà en français le dit clairement")
    func sameLanguageIsItsOwnReason() {
        let label = TranslationModelStatus.sameLanguage.label
        #expect(label.contains("déjà en français"))
        #expect(TranslationModelStatus.sameLanguage.isUsable == false)
    }

    @Test("Un motif non traduisible fait échouer la demande avec ce motif")
    func refusalCarriesTheReason() async {
        for status in [
            TranslationModelStatus.simulator,
            .sameLanguage,
            .unsupported,
            .frameworkUnavailable,
        ] {
            let translator = SentenceTranslator()
            translator.modelStatus = status
            await translator.translate("Something to translate.")

            guard case .failed(_, let message) = translator.phase else {
                Issue.record("\(status) aurait dû refuser")
                continue
            }
            #expect(message == status.label)
        }
    }

    @Test("Changer la langue du livre relance la vérification")
    func languageChangeRefreshes() {
        let translator = SentenceTranslator()
        translator.sourceLanguageCode = "de-DE"
        #expect(translator.sourceLanguageCode == "de-DE")
    }
}
+1 −1
Changes for README.md: 1 added line, 1 removed line.
Original line number Diff line number Diff line
@@ -194,7 +194,7 @@ Sans elles, l'app compile, se lance, et ne joint jamais le serveur.

**Aucun son n'a été écouté.** La narration enchaîne ses phrases dans l'ordre sur un vrai livre, et ses mécanismes sont testés — découpage en phrases, conversion du débit vers l'échelle d'`AVSpeechUtterance`, enregistrement de la position une fois par phrase et non par mot, reprise à la position stockée. Mais la qualité de la voix, le débit à l'oreille et le comportement avec un autoradio restent à juger sur un appareil.

**Aucune traduction n'est passée par le framework d'Apple.** Apple documente que `Translation` ne traduit pas dans le simulateur — il faut un appareil réel. Ce qui est testé ici, c'est tout ce qui entoure l'appel : le cache, la mise en attente, le rejet quand le modèle manque, l'abandon d'un résultat devenu obsolète. L'appel lui-même attend un iPhone ou un iPad.
**Aucune traduction n'est passée par le framework d'Apple,** et ça ne changera pas tant que l'app tourne dans le simulateur : Apple documente que `Translation` n'y traduit pas. La vérification de disponibilité y répond « non pris en charge », ce que l'app affichait comme un problème de paire de langues — elle nomme maintenant le simulateur. Ce qui est testé, c'est tout ce qui entoure l'appel : le cache, la mise en attente, le refus et son motif, l'abandon d'un résultat devenu obsolète. L'appel lui-même attend un iPhone ou un iPad.

**Rien n'est signé.** Les builds vérifiés ici passent par `CODE_SIGNING_ALLOWED=NO`. Pour un build sur appareil, activer « Increased Memory Limit » dans Signing & Capabilities de la cible.