Cumplimiento de la política de fuentes Emoji de Google
Google ha introducido una política de emojis para Android que obliga a los desarrolladores de aplicaciones a admitir la última versión de los emojis Unicode. La política establece lo siguiente:
Las aplicaciones con implementaciones personalizadas de emojis, incluidas las proporcionadas por bibliotecas de terceros, deben ser totalmente compatibles con la última versión de Unicode cuando se ejecuten en Android 12 o superior en un plazo de cuatro meses tras el lanzamiento de los nuevos emojis Unicode.
Esta guía muestra cómo cumplir con esta política, ya sea incluyendo una fuente de emojis o utilizando las fuentes descargables de Google para Android.
Incorporar una fuente de emojis frente a las fuentes descargables de Google
Ambos métodos para admitir los emojis más recientes presentan ventajas e inconvenientes. La mejor opción depende de cada aplicación. A continuación se enumeran algunas ventajas e inconvenientes de los dos métodos:
Ventajas de incluir la fuente:
- Carga más rápida de la fuente
- Funciona cuando el usuario no tiene conexión a Internet
- Funciona en todos los sistemas operativos
- Es independiente (no tiene otras dependencias aparte de Qt)
- Solución más sencilla
Desventajas de incluir la fuente:
- Aumenta el tamaño de la aplicación (NotoColorEmoji ocupa unos 10 MB)
- Requiere actualizar la fuente en las nuevas versiones
- Las aplicaciones más antiguas no actualizarán los emojis automáticamente
Ventajas de las fuentes descargables de Google:
- No modifica el tamaño de la aplicación
- Se actualizan automáticamente
- Varias aplicaciones sin relación entre sí comparten la misma fuente
Desventajas de las fuentes descargables de Google:
- Dependen de los Servicios móviles de Google
- Solo para Android
- Descargará la fuente si no está previamente almacenada en la caché
- No funciona sin conexión a Internet si no se ha almacenado previamente en la caché
- Es más complejo que incluir la fuente en el paquete
Cómo incluir una fuente
Es necesario obtener e incluir la fuente y, posteriormente, cargarla utilizando QML o C++.
Cómo obtener una fuente
Para esta guía, utilizaremos la fuente Google NotoColorEmoji. NotoColorEmoji es una fuente con licencia SIL OPEN FONT LICENSE.
Nota: Si la descargas del repositorio, descarga la fuente NotoColorEmoji_WindowsCompatible.ttf en lugar de NotoColorEmoji.ttf. NotoColorEmoji.ttf está compilada internamente con un formato diferente y solo es compatible con Android, Chrome y Chromium OS. Dado que Qt se ejecuta en otras plataformas, el cargador de fuentes de Qt requiere una fuente TrueType/OpenType con el formato estándar.
Añadir la fuente
La forma correcta de incluir la fuente es añadirla a los archivos del sistema de recursos de Qt. Por ejemplo, puedes crear un archivo de recursos independiente para la fuente —«font.qrc»— con NotoColorEmoji_WindowsCompatible.ttf. Para integrar el nuevo archivo de recursos, utiliza el siguiente código en CMakeLists.txt:
qt_add_big_resources(PROJECT_SOURCES font.qrc)Carga de la fuente incluida en C++
Para cargar la fuente en C++, utiliza ` QFontDatabase`.
// Loading NotoColorEmoji bundled using C++ QFontDatabase
QFontDatabase::addApplicationFont(QStringLiteral(":/NotoColorEmoji_WindowsCompatible.ttf"));Nota: El código anterior debe utilizarse antes de que QQmlApplicationEngine cargue el QML, de modo que, cuando se cargue el QML, la fuente ya esté presente y lista para su uso.
Carga de la fuente incluida en QML
Para cargar la fuente en QML, utiliza ` FontLoader`:
// Loading NotoColorEmoji using QML FontLoader
FontLoader {
source:"NotoColorEmoji_WindowsCompatible.ttf"
}Uso de las fuentes descargables de Google:
El uso de las fuentes descargables de Google para la fuente de emojis proporciona una fuente de emojis que se actualiza automáticamente sin aumentar el tamaño de la aplicación. El proceso para descargar una fuente mediante la función «Fuentes descargables» se puede consultar con más detalle en Android: Proceso de fuentes descargables
Para esta guía, el proceso será el siguiente:
- Comienza el código en C++
- C++ llama a una función de Java
- Java llama a GDF para obtener la fuente
- Java abre el URI de la fuente
- Java devuelve el descriptor de archivo a C++
- C++ carga la fuente utilizando QFontDatabase
Configuración
Google Downloadable Fonts está disponible para el nivel de API 26 (Android 8.0). Sin embargo, es posible ofrecer compatibilidad con API anteriores, hasta la API 14, si la aplicación utiliza AndroidX.
Nota: La documentación de Android hace referencia a la biblioteca Android: Support Library en lugar de a AndroidX. No obstante, dado que la biblioteca de soporte ya no se mantiene y ha sido sustituida por AndroidX, hemos seguido la recomendación de Google de utilizar AndroidX en su lugar.
Personalización de la plantilla de paquetes de Android
En primer lugar, es necesario personalizar las plantillas de paquetes de Android. Para ello, en Qt Creator, ve a la pestaña «Proyectos» y, a continuación, busca en «Configuración de compilación» la opción «Compilar APK de Android». Debería encontrarse dentro de «Pasos de compilación»; expande los detalles y aparecerá un botón llamado «Crear plantillas».

Haz clic en «Crear plantillas», sigue el asistente y, al final, se creará una carpeta con varios archivos de configuración para Android. Por defecto, será una carpeta llamada « android » dentro del directorio del proyecto.
Consulta Plantillas de paquetes de Android para obtener información sobre cómo personalizar las plantillas de Android utilizando qmake.
En caso de que utilices CMake y Qt 6, como en esta guía, debes configurar la propiedad QT_ANDROID_PACKAGE_SOURCE_DIR. Ejemplo:
set_property(TARGET emojiremotefont PROPERTY
QT_ANDROID_PACKAGE_SOURCE_DIR
${CMAKE_CURRENT_SOURCE_DIR}/android)Añadir AndroidX
Para añadir AndroidX, abre el archivo « build.gradle » dentro de la carpeta «QT_ANDROID_PACKAGE_SOURCE_DIR» añadida anteriormente e incluye allí la dependencia:
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])
implementation 'androidx.appcompat:appcompat:1.4.1'
}Para utilizar AndroidX, debemos configurar el indicador correspondiente. Para ello, crea un archivo llamado « gradle.properties » dentro de «QT_ANDROID_PACKAGE_SOURCE_DIR» y añade esta línea:
android.useAndroidX=trueAñadir certificados de proveedores de fuentes
Dado que estamos utilizando AndroidX, hay otra configuración necesaria: añadir los certificados del proveedor de fuentes de Android. Para utilizar el proveedor de fuentes GMS, descarga los certificados del proveedor de fuentes GMS de Android. Si utilizas otros proveedores de fuentes, deberás obtener los certificados directamente del propio proveedor.
Tras descargar el archivo, añádelo a los recursos de Android (no al sistema de recursos de Qt) copiándolo en la carpeta « values » dentro de la carpeta de plantillas de Android. La siguiente imagen muestra la carpeta correcta en (1):

Código Java
¡Bien, vamos a profundizar ahora en el código!
Tenemos que añadir código Java/Kotlin a nuestras plantillas de Android. Colócalo en la carpeta « src », dentro de la carpeta de plantillas de Android. Es posible que tengas que crear la carpeta « src » y la estructura de carpetas para tus archivos Java. Puedes ver esta estructura de carpetas en la imagen «Carpeta de plantillas de Android» de la sección anterior, en (2).
Para obtener la fuente en C++, es necesario que el código Java:
- Crear una solicitud de fuente
- Obtener las fuentes de «FontsContractCompat» utilizando la solicitud de fuente
- Obtener la información de la fuente y el URI de la fuente (archivo con esquema de contenido)
- Abrir el URI y obtener un descriptor de archivo
- Devolver el descriptor de archivo al código C++
Para crear una solicitud de fuente, necesitas la información del proveedor de fuentes (autoridad, paquete y certificados) y la consulta de búsqueda de la fuente. Para los certificados, utiliza el archivo de certificados del proveedor de fuentes GMS fonts_cert.xml añadido previamente a los recursos de Android.
// GMS fonts provider data
private static final String PROVIDER_AUTHORITY = "com.google.android.gms.fonts";
private static final String PROVIDER_PACKAGE = "com.google.android.gms";
// Emoji font search query (copied from EmojiCompat source)
private static final String EMOJI_QUERY = "emojicompat-emoji-font";
// Font Certificates resources strings (from fonts_certs.xml)
private static final String FONT_CERTIFICATE_ID = "com_google_android_gms_fonts_certs";
private static final String FONT_CERTIFICATE_TYPE = "array";
(...)
// obtain id for the font_certs.xml
int certificateId = context.getResources().getIdentifier(
FONT_CERTIFICATE_ID,
FONT_CERTIFICATE_TYPE,
context.getPackageName());
// creating the request
FontRequest request = new FontRequest(
PROVIDER_AUTHORITY,
PROVIDER_PACKAGE,
EMOJI_QUERY,
certificateId);Ahora, utiliza la solicitud que acabas de crear para obtener la fuente:
// fetch the font
FontsContractCompat.FontFamilyResult result =
FontsContractCompat.fetchFonts(context, null, request);Obtén el archivo « FontInfo » y la URI:
final FontsContractCompat.FontInfo[] fontInfos = result.getFonts();
final Uri emojiFontUri = fontInfos[0].getUri();Abre un nuevo descriptor de archivo nativo a partir de la URI:
final ContentResolver resolver = context.getContentResolver();
// in this case the Font URI is always a content scheme file, made
// so the app requesting it has permissions to open
final ParcelFileDescriptor fileDescriptor =
resolver.openFileDescriptor(fontInfos[0].getUri(), "r");
// the detachFd will return a native file descriptor that we must close
// later in C++ code
int fd = fileDescriptor.detachFd();
// return fd to C++Nota: Todo lo programado en Java podría hacerse en C++ utilizando JNI. El código presentado en la guía está simplificado. El código listo para producción debe revisarse, con capturas de excepciones, etc...
Código C++
Bien, ya está todo listo en el lado de Java. Pasemos al lado de C++.
C++ se encarga de llamar al código Java y de utilizar el descriptor de archivo para cargar la fuente en Qt.
Para comprender mejor cómo funciona la comunicación entre C++ y Java en Qt 6, consulta el ejemplo «Qt for Android Notifier ».
Tras obtener el descriptor de archivo desde el código Java, envuelve el descriptor de archivo en una clase ` QFile ` y carga el archivo de fuente utilizando ` QFontDatabase`:
QFile file;
file.open(fd, QFile::OpenModeFlag::ReadOnly, QFile::FileHandleFlag::AutoCloseHandle);
QFontDatabase::addApplicationFontFromData(file->readAll());© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.