# General Translation Changelog: generaltranslation 8.0.0: Branching e deprecazioni API URL: https://generaltranslation.com/it/blog/generaltranslation_v8.mdx Docs index: https://generaltranslation.com/llms.txt Description: Authors: Brian Lou Published: 2025-11-10 ## Panoramica In **generaltranslation v8** stiamo introducendo modifiche significative alla nostra API e deprecando alcune funzioni ed endpoint. **Le versioni meno recenti dell'API non saranno più supportate.** Le versioni di `generaltranslation` precedenti alla `7.5` causeranno probabilmente errori. Le versioni di `gtx-cli` precedenti alla `2.1.5` causeranno probabilmente errori. *** ## Motivazione Per migliorare l'esperienza degli sviluppatori, agevolare lo sviluppo futuro e semplificare la gestione delle traduzioni, stiamo introducendo il branching e deprecando alcuni endpoint API non più utilizzati. *** ## Funzionalità Le API più recenti supportano il branching, che ti consente di creare traduzioni diverse per branch diversi del progetto. Ogni file è ora associato a un branch. Il versionamento dei file è ora determinato da `branchId`, `fileId` e `versionId`. In precedenza, le traduzioni dei file erano associate a un solo branch. Per impostazione predefinita, le traduzioni dei file memorizzate nella cache usavano la versione del file aggiornata più di recente. Nella versione 8, l'aggiornamento delle traduzioni di un file userà ora la versione più recente del file nel branch specificato. Il versionamento è legato alla cronologia del branch, anziché al timestamp. Il nuovo sistema di versionamento rispecchia il modello di branching di git: * Aggiornare un file sorgente in un branch creerà una nuova versione del file. * Unire un branch in main genererà un collegamento tra il file sorgente nel branch main e il file sorgente nel branch unito. * Le traduzioni future incorporeranno le traduzioni di entrambi i branch. * Eseguire il checkout di un branch creerà una nuova versione del file * Le traduzioni in questo branch faranno riferimento alle traduzioni precedenti del branch main. Per abilitare questa funzionalità, aggiungi il flag `--enable-branching` al comando `gtx-cli translate` nell'ultima versione di gtx-cli. Per impostazione predefinita, il branching è disabilitato e tutti i file del progetto sono associati al branch main. Per usare questa funzionalità, la tua organizzazione deve avere un piano a pagamento. ## Modifiche ### `generaltranslation` * Deprecato `checkTranslationStatus` * Deprecato [`downloadFile`](/docs/platform/core/reference/gt-class-methods/translation/download-file) * `downloadTranslatedFile` rinominato in [`downloadFile`](/docs/platform/core/reference/gt-class-methods/translation/download-file) * A seconda che sia specificata un'impostazione regionale, scarica il sorgente o la traduzione corrispondente * Modificati i parametri di [`downloadFile`](/docs/platform/core/reference/gt-class-methods/translation/download-file) e [`downloadFileBatch`](/docs/platform/core/reference/gt-class-methods/translation/download-file-batch) * Deprecato `enqueueEntries` * Modificati i parametri di [`enqueueFiles`](/docs/platform/core/reference/gt-class-methods/translation/enqueue-files) (aggiunti branchIds) * Deprecato `fetchTranslations` * Deprecato `shouldSetupProject` * Modificati i parametri di `submitUserEditDiffs` (aggiunti branchIds, campi id resi obbligatori) * Modificati i parametri di [`uploadSourceFiles`](/docs/platform/core/reference/gt-class-methods/translation/upload-source-files) (aggiunti branchIds) * Modificati i parametri di [`uploadTranslations`](/docs/platform/core/reference/gt-class-methods/translation/upload-translations) (aggiunti branchIds) * Modificati i parametri di [`querySourceFile`](/docs/platform/core/reference/gt-class-methods/translation/query-source-file) (aggiunti branchIds) * Aggiunto [`checkJobStatus`](/docs/platform/core/reference/gt-class-methods/translation/check-job-status) * Aggiunto [`queryFileData`](/docs/platform/core/reference/gt-class-methods/translation/query-file-data) * Deprecato `checkSetupStatus` (usa invece [`checkJobStatus`](/docs/platform/core/reference/gt-class-methods/translation/check-job-status)) * Deprecato `checkFileTranslations` (usa invece [`queryFileData`](/docs/platform/core/reference/gt-class-methods/translation/query-file-data)) ### `gtx-cli` * Aggiunto il flag `--enable-branching` al comando [`translate`](/docs/cli/reference/commands/translate) * Aggiunto il flag `--branch` al comando [`translate`](/docs/cli/reference/commands/translate) * (Facoltativo) Sovrascrive il branch da usare per la traduzione * Aggiunto il flag `--disable-branch-detection` al comando [`translate`](/docs/cli/reference/commands/translate) * (Facoltativo) Se disabilitato, la CLI non tenterà automaticamente di rilevare i branch da usare. * Usa questo flag se `git` non è installato o se il progetto non è un repository Git. * Migliorati il monitoraggio dell'avanzamento della traduzione e la registrazione nei log * Migliorata la gestione degli errori di traduzione * Ottimizzate le prestazioni dell'API per evitare upload di file non necessari ### `gt-sanity` * Aggiornato per utilizzare l'ultima versione di `generaltranslation` * Per impostazione predefinita, le traduzioni usano il branch main. * Il supporto per il branching dell'anteprima delle bozze dei documenti sarà aggiunto in una release futura. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.