Traduzca archivos Java .properties con IA que ofrece una calidad equiparable a la humana. Suba su archivo, elija los idiomas y descargue las traducciones en cuestión de minutos.
Traducción de su aplicación por primera vez con PTC
Paso 1
Regístrese para una prueba gratuita
Cree una cuenta de PTC para comenzar. Durante la prueba gratuita de 30 días, puede traducir 20.000 palabras a dos idiomas de su elección.
Después del periodo de prueba, puede continuar usando PTC configurando el pago por uso, que desbloquea la traducción a todos los idiomas disponibles y le permite pagar solo por lo que traduce.
Paso 2
Informe a PTC sobre su proyecto y elija los idiomas de destino
Después de registrarse, complete un breve asistente de configuración donde proporcionará a PTC una descripción breve de su aplicación. Este contexto es importante porque ayuda a PTC a elegir el tono y la terminología adecuados. Es lo que permite a PTC ofrecer traducciones que se sienten naturales en cada idioma.
También deberá seleccionar sus idiomas de traducción. PTC proporciona traducciones contextuales a más de 33 idiomas, cubriendo los idiomas hablados en todos los mercados principales.
Paso 3
Cargue su archivo Java
Encuentre el archivo .properties en su proyecto (normalmente en src/main/resources) y súbalo. En este paso, también puede establecer las rutas de salida para sus archivos de traducción.
Paso 4
Vea y descargue las traducciones
PTC tarda unos minutos en traducir su archivo. Una vez que las traducciones estén listas, puede revisarlas en la pestaña Traducciones.
Las traducciones se muestran en una vista clara de estilo de tabla. Cualquier traducción que exceda la longitud establecida se resalta en amarillo. Esto facilita la detección temprana de posibles problemas. Puede:
- Mantener la traducción más larga y ajustar su interfaz de usuario para que se ajuste a ella, o
- Pedir a PTC que acorte la traducción preservando su significado
Una vez que esté satisfecho, vaya a la pestaña Archivos de recursos y descargue un archivo ZIP con los archivos .properties traducidos.
Añada estos archivos de nuevo a la carpeta src/main/resources de su proyecto, junto con su archivo fuente original. Asegúrese de que los nombres de los archivos sigan la convención de configuración regional de Java (por ejemplo: messages_fr.properties, messages_es.properties).
En tiempo de ejecución, ResourceBundle elige automáticamente el archivo correcto en función de la configuración regional del usuario. No es necesario que cambie su código.
Pase a un flujo de trabajo de localización continua
Si bien cargar su archivo Java.properties es una excelente manera de hacerse una idea de cómo funciona PTC, no tiene que cargar archivos.properties cada vez que necesite nuevas traducciones.
PTC puede mantener sus traducciones actualizadas automáticamente para que pueda lanzar nuevas versiones de productos en todos los idiomas sin trabajo adicional.
Opción 1
Integre PTC con su repositorio git
Para su proyecto existente, vaya a Configuración → Solicitudes de fusión y haga clic en el botón Añadir integración Git para conectar su repositorio de GitHub, GitLab o Bitbucket a PTC.
Una vez que configure la integración:
- PTC supervisará las ramas que elija para detectar cambios en los archivos
.properties - Cuando se actualiza un archivo, PTC traduce automáticamente las cadenas nuevas o modificadas
- Recibirá las traducciones de vuelta a través de una solicitud de combinación en su repositorio
De esta manera, sus traducciones se actualizan cada vez que realiza un cambio en el archivo fuente.
Opción 2
Integre PTC en su proceso de CI
Si prefiere no conectar su repositorio, vaya a Configuración → Gestionar tokens de API y genere un token de acceso para usar la API de PTC en su flujo de trabajo de CI/CD.
- Su trabajo de CI sube el archivo
.propertiesactualizado a PTC a través de la API - PTC procesa la solicitud de traducción
- Su trabajo de CI vuelve a llamar a la API para recuperar los archivos traducidos una vez que estén listos
De esta manera, las traducciones siempre se sincronizan como parte de su canalización de compilación.
Traducción de otro texto con PTC
No todo el texto de su aplicación se encuentra en archivos .properties. También puede tener contenido como:
- Correos electrónicos o mensajes de incorporación
- Documentación o textos de ayuda
- Textos de marketing (como descripciones de productos)
Para que su localización sea completa, puede traducirlos utilizando la función Pegar para traducir de PTC.
- Desde su panel de control de PTC, vaya a Traducciones → Pegar para traducir
- Elija el tipo de texto que está traduciendo, péguelo y haga clic para traducir
- Copie el texto traducido e insértelo en su aplicación, documentación o material de marketing
Esto garantiza que cada parte del contenido orientado al usuario sea coherente y esté localizado con la misma traducción de IA de alta calidad que sus archivos .properties.
Preparación de archivos de propiedades para traducciones de alta calidad
Ahora que sabe cómo traducir archivos .properties con PTC, tenga en cuenta que la calidad de sus archivos fuente afecta directamente a la calidad de sus traducciones. Estas prácticas recomendadas para los archivos .properties de Java evitan traducciones incorrectas, errores de tiempo de ejecución y experiencias de usuario confusas.
Utilice claves claras y descriptivas
Su archivo .properties define las claves, y su código Java llama a esas claves. Si las claves son crípticas, se hace difícil saber a qué cadena pertenece cada una.
Ejemplo
Clave descriptiva en un archivo .properties:
button.submit=Submit
error.unauthorized=You are not authorized to access this page.Claves crípticas que no dan contexto:
btn1=Submit
msg2=UnauthorizedEl uso de claves descriptivas hace que sea obvio para qué se utiliza cada cadena. Si solo utiliza códigos cortos como btn1 o msg2, se hace casi imposible saber qué texto pertenece a qué parte de su aplicación, especialmente cuando añade más cadenas o incorpora nuevos desarrolladores al proyecto.
Mantenga todo el texto orientado al usuario en archivos .properties
Todo el texto que ven sus usuarios debe provenir de archivos .properties. No deje etiquetas, mensajes o instrucciones codificadas en clases Java.
Ejemplo
Correcto: texto orientado al usuario en .properties:
En un archivo .properties:
button.submit=SubmitEn Java:
button.setText(bundle.getString("button.submit"));Incorrecto: codificado directamente en el código:
button.setText("Submit");Las cadenas codificadas no serán traducidas por PTC. Su aplicación mostrará una mezcla de texto traducido y no traducido, lo que se siente poco profesional y confuso para los usuarios.
Utilice placeholders para contenido dinámico
Para contenido variable, escriba la frase completa en su archivo .properties y utilice placeholders numerados ({0}, {1}) en lugar de concatenar cadenas en el código.
Ejemplo
Correcto en el archivo .properties:
En un archivo .properties:
greeting=Hello, {0}! You have {1} new messages.En el código Java, utilice MessageFormat para insertar los valores en tiempo de ejecución:
String message = MessageFormat.format(
bundle.getString("greeting"), user, count);Incorrecto: concatenando en el código:
System.out.println("Hello, " + user + "! You have " + count + " new messages.");La concatenación de fragmentos imposibilita que PTC comprenda la frase completa. Muchos idiomas cambian el orden de las palabras, las formas plurales y las reglas de concordancia. Una frase como “¡Hola, Maria! Tiene 3 mensajes nuevos.” no puede expresarse correctamente si se divide en fragmentos.
Mediante el uso de placeholders, PTC traduce toda la frase de forma natural, y Java inserta los valores correctos en tiempo de ejecución.
Escape los caracteres especiales correctamente
Algunos caracteres están reservados en los archivos .properties porque afectan a la forma en que Java analiza el archivo:
=o:→ separa las claves de los valores#o!→ inicia un comentario\→ introduce secuencias de escape (como\npara nueva línea)
Si desea que estos caracteres aparezcan como parte del texto, escápelos con una barra invertida.
Ejemplo
Correcto: dos puntos escapados en el valor:
message=Save using key\: Ctrl+SIncorrecto: los dos puntos sin escape se tratan como un separador:
message=Save using key: Ctrl+SSi los caracteres especiales no se escapan, Java divide la cadena incorrectamente y PTC solo ve parte del texto. Eso significa que sus traducciones volverán incompletas, y en tiempo de ejecución sus usuarios pueden ver mensajes faltantes o rotos.
Guarde los archivos en UTF-8
Guarde siempre los archivos .properties en UTF-8. Sin UTF-8, los caracteres que no pertenecen a ASCII se corrompen (por ejemplo, é se convierte en é). Esto hace que las traducciones sean ilegibles y obliga a realizar correcciones manuales de codificación.
Empiece a traducir su aplicación Java hoy mismo
Traduzca sus archivos Java .properties con IA, que gestiona el contexto, los marcadores de posición y la estructura de los archivos de forma automática. Pruebe PTC gratis, sin necesidad de tarjeta de crédito.
