Comment Migrer de Lokalise vers IntlPull (Guide Étape par Étape)

Aperçu

Migrer de Lokalise vers IntlPull prend environ 10 minutes et préserve :

• Tous les projets et leur structure
• Toutes les clés et valeurs de traduction
• Toutes les langues
• Les entrées de mémoire de traduction
• Le glossaire/terminologie
• Les commentaires et le contexte

Prérequis

Avant de commencer :

1. Clé API Lokalise avec accès en lecture aux projets
2. Compte IntlPull (inscription gratuite)
3. Node.js 18+ (pour la migration CLI)

Méthode 1 : Migration CLI (Recommandée)

La façon la plus rapide de tout migrer en une fois.

Étape 1 : Installer IntlPull CLI

TerminalCopy
npm install -g @intlpullhq/cli

Étape 2 : Obtenir Votre Clé API Lokalise

1. Connectez-vous à Lokalise
2. Allez dans Profile Settings → API Tokens
3. Créez un nouveau token avec accès Read-only
4. Copiez le token

Étape 3 : Exécuter la Migration

TerminalCopy
npx @intlpullhq/cli migrate --from lokalise

On vous demandera :

• Clé API Lokalise
• Clé API IntlPull (obtenez-la depuis le tableau de bord IntlPull)
• Projets à migrer (tous ou sélectionner des spécifiques)

Étape 4 : Vérifier

Une fois terminé, vérifiez votre tableau de bord IntlPull pour confirmer :

• Tous les projets apparaissent
• Toutes les langues sont présentes
• Les comptes de traduction correspondent

Méthode 2 : Migration Web

Si vous préférez une interface visuelle :

Étape 1 : Allez à la Page de Migration

Visitez intlpull.com/migrate et sélectionnez "Lokalise" comme source.

Étape 2 : Connecter Lokalise

Entrez votre clé API Lokalise. IntlPull récupérera votre liste de projets.

Étape 3 : Sélectionner les Projets

Choisissez quels projets migrer :

• Sélectionnez tout pour une migration complète
• Ou choisissez des projets spécifiques

Étape 4 : Configurer les Options

• Importer MT : Oui (recommandé)
• Importer Glossaire : Oui (recommandé)
• Importer Commentaires : Oui (recommandé)

Étape 5 : Lancer la Migration

Cliquez sur "Start Migration" et attendez la fin. Vous verrez la progression pour chaque projet.

Méthode 3 : Export/Import Manuel

Pour plus de contrôle, exportez depuis Lokalise et importez vers IntlPull.

Exporter depuis Lokalise

1. Ouvrez votre projet Lokalise
2. Allez dans Download
3. Sélectionnez le format : JSON (Structured)
4. Sélectionnez toutes les langues
5. Cliquez sur Build and Download

Exporter la Mémoire de Traduction

1. Allez dans Translation Memory
2. Cliquez sur Export
3. Téléchargez en tant que TMX ou CSV

Exporter le Glossaire

1. Allez dans Glossary
2. Cliquez sur Export
3. Téléchargez en tant que TBX ou CSV

Importer vers IntlPull

1. Créez un nouveau projet dans IntlPull
2. Allez dans Import
3. Téléchargez vos fichiers JSON
4. Allez dans Translation Memory → Import
5. Téléchargez votre fichier MT
6. Allez dans Glossary → Import
7. Téléchargez votre fichier glossaire

Étapes Post-Migration

1. Mettre à Jour les Pipelines CI/CD

Remplacez les commandes CLI Lokalise avec IntlPull :

TerminalCopy
1# Avant (Lokalise)
2lokalise2 file download --project-id xxx
3
4# Après (IntlPull)
5npx @intlpullhq/cli download

2. Mettre à Jour les Variables d'Environnement

TerminalCopy
1# Supprimer
2LOKALISE_API_TOKEN=xxx
3LOKALISE_PROJECT_ID=xxx
4
5# Ajouter
6INTLPULL_API_KEY=xxx
7INTLPULL_PROJECT_ID=xxx

3. Configurer OTA (Optionnel)

Si vous voulez des mises à jour de traduction instantanées pour les applications mobiles :

iOS :

SwiftCopy
1import IntlPull
2
3IntlPull.configure(
4    projectId: "your-project-id",
5    apiKey: "your-api-key"
6)

Android :

KotlinCopy
1IntlPull.configure(
2    projectId = "your-project-id",
3    apiKey = "your-api-key"
4)

4. Inviter les Membres de l'Équipe

1. Allez dans Project Settings → Team
2. Invitez les traducteurs et développeurs
3. Définissez les rôles appropriés

5. Annuler l'Abonnement Lokalise

Une fois vérifié :

1. Exportez une sauvegarde finale depuis Lokalise (juste au cas où)
2. Annulez votre abonnement Lokalise
3. Profitez de vos économies !

Dépannage

Erreur "Invalid API Key"

• Assurez-vous que votre token Lokalise a un accès en lecture
• Vérifiez les espaces supplémentaires lors de la copie
• Générez un nouveau token si nécessaire

Traductions Manquantes

• Vérifiez que toutes les langues ont été sélectionnées lors de l'export
• Vérifiez si les traductions étaient en statut "draft" dans Lokalise
• Relancez la migration pour des langues spécifiques si nécessaire

MT Ne S'importe Pas

• L'import MT nécessite un plan Pro ou supérieur
• Vérifiez le format de fichier (TMX ou CSV)
• Contactez le support si les problèmes persistent

Limite de Taux (Rate Limiting)

Pour les grands projets, la migration peut prendre plus de temps en raison des limites de taux API. La CLI gère cela automatiquement avec des tentatives répétées.

Mappage des Données

FAQ

Q : Vais-je perdre des données ? R : Non. Toutes les traductions, entrées MT et termes de glossaire sont préservés.

Q : Puis-je migrer plusieurs projets ? R : Oui. La CLI peut migrer tous les projets en une fois.

Q : Combien de temps prend la migration ? R : Généralement 5-10 minutes pour la plupart des équipes. Les grands projets (100k+ chaînes) peuvent prendre plus de temps.

Q : Puis-je continuer à utiliser Lokalise pendant la migration ? R : Oui. La migration est en lecture seule du côté de Lokalise.

Q : Que faire si quelque chose ne va pas ? R : Contactez notre équipe de support. Nous vous aiderons à assurer une migration complète.

Comparaison des Coûts

Après migration, vous verrez probablement des économies significatives :

Résumé

1. Obtenez les clés API des deux plateformes
2. Lancez la migration via CLI ou interface web
3. Vérifiez les données dans le tableau de bord IntlPull
4. Mettez à jour les intégrations (CI/CD, SDK mobiles)
5. Annulez Lokalise et économisez de l'argent

Besoin d'aide ? Notre équipe de support à la migration est disponible à support@intlpull.com.

Commencez votre migration maintenant →