expo-font 13.2.1 → 13.3.0

package/CHANGELOG.md

@@ -10,6 +10,16 @@
 
 ### 💡 Others
 
+## 13.3.0 — 2025-04-30
+
+### 🎉 New features
+
+- [Android] Added support for font weight styles (through XML font definitions) to config plugin. ([#26082](https://github.com/expo/expo/pull/26082) by [@jongbelegen](https://github.com/jongbelegen))
+
+## 13.2.2 — 2025-04-25
+
+_This version does not introduce any user-facing changes._
+
 ## 13.2.1 — 2025-04-21
 
 _This version does not introduce any user-facing changes._

package/android/build.gradle

@@ -4,13 +4,13 @@ plugins {
 }
 
 group = 'host.exp.exponent'
-version = '13.2.1'
+version = '13.3.0'
 
 android {
   namespace "expo.modules.font"
   defaultConfig {
     versionCode 29
-    versionName "13.2.1"
+    versionName "13.3.0"
   }
 }
 

package/expo-module.config.json

@@ -8,7 +8,7 @@
     "publication": {
       "groupId": "host.exp.exponent",
       "artifactId": "expo.modules.font",
-      "version": "13.2.1",
+      "version": "13.3.0",
       "repository": "local-maven-repo"
     }
   }

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.3.0/expo.modules.font-13.3.0.aar.md5

@@ -0,0 +1 @@
+40442d97319105928658a150897f05b0

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.3.0/expo.modules.font-13.3.0.aar.sha1

@@ -0,0 +1 @@
+8fb055a3e3b59bba7a5290a635b1bd7845a01368

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.3.0/expo.modules.font-13.3.0.aar.sha256

@@ -0,0 +1 @@
+5274e21b1ff612d9defa01130a701dee5a7c2459b06d7a54b49d0b843d601120

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.3.0/expo.modules.font-13.3.0.aar.sha512

@@ -0,0 +1 @@
+68cf441a11928d7286379f1985698bdf3925a0dfd852a168968a955f21e32b1d95f1a65a330be805cee8b464cab97ff03a15ad7df77fef45aa25de193ca5b259

package/local-maven-repo/host/exp/exponent/expo.modules.font/{13.2.1/expo.modules.font-13.2.1.module → 13.3.0/expo.modules.font-13.3.0.module}

@@ -3,7 +3,7 @@
   "component": {
     "group": "host.exp.exponent",
     "module": "expo.modules.font",
-    "version": "13.2.1",
+    "version": "13.3.0",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -24,13 +24,13 @@
       },
       "files": [
         {
-          "name": "expo.modules.font-13.2.1.aar",
-          "url": "expo.modules.font-13.2.1.aar",
-          "size": 23940,
-          "sha512": "23e09b1c63cedb2c4e2063a509bdd0ecb91c8815cb946ef3707fba50b7ca2f4ac3c20d825847a1885cec0fd3c29dbd153d730acc552a33e5c031928551c707ab",
-          "sha256": "02e3e22b8a6570b0a9ae2d3fff74bcb898a90480d271d162ef76c2c6415fd763",
-          "sha1": "8a3e0658bef6d46ddbdfaf891baba11daaadbfc8",
-          "md5": "c4a5fbec91ef91f550b4a16b8011c1da"
+          "name": "expo.modules.font-13.3.0.aar",
+          "url": "expo.modules.font-13.3.0.aar",
+          "size": 24048,
+          "sha512": "68cf441a11928d7286379f1985698bdf3925a0dfd852a168968a955f21e32b1d95f1a65a330be805cee8b464cab97ff03a15ad7df77fef45aa25de193ca5b259",
+          "sha256": "5274e21b1ff612d9defa01130a701dee5a7c2459b06d7a54b49d0b843d601120",
+          "sha1": "8fb055a3e3b59bba7a5290a635b1bd7845a01368",
+          "md5": "40442d97319105928658a150897f05b0"
         }
       ]
     },
@@ -57,13 +57,13 @@
       ],
       "files": [
         {
-          "name": "expo.modules.font-13.2.1.aar",
-          "url": "expo.modules.font-13.2.1.aar",
-          "size": 23940,
-          "sha512": "23e09b1c63cedb2c4e2063a509bdd0ecb91c8815cb946ef3707fba50b7ca2f4ac3c20d825847a1885cec0fd3c29dbd153d730acc552a33e5c031928551c707ab",
-          "sha256": "02e3e22b8a6570b0a9ae2d3fff74bcb898a90480d271d162ef76c2c6415fd763",
-          "sha1": "8a3e0658bef6d46ddbdfaf891baba11daaadbfc8",
-          "md5": "c4a5fbec91ef91f550b4a16b8011c1da"
+          "name": "expo.modules.font-13.3.0.aar",
+          "url": "expo.modules.font-13.3.0.aar",
+          "size": 24048,
+          "sha512": "68cf441a11928d7286379f1985698bdf3925a0dfd852a168968a955f21e32b1d95f1a65a330be805cee8b464cab97ff03a15ad7df77fef45aa25de193ca5b259",
+          "sha256": "5274e21b1ff612d9defa01130a701dee5a7c2459b06d7a54b49d0b843d601120",
+          "sha1": "8fb055a3e3b59bba7a5290a635b1bd7845a01368",
+          "md5": "40442d97319105928658a150897f05b0"
         }
       ]
     },
@@ -77,8 +77,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.font-13.2.1-sources.jar",
-          "url": "expo.modules.font-13.2.1-sources.jar",
+          "name": "expo.modules.font-13.3.0-sources.jar",
+          "url": "expo.modules.font-13.3.0-sources.jar",
           "size": 3643,
           "sha512": "04d8003327d266d74c7c2123206ff0c008db185c4fe9ce8518e6c47af1ed8d3118db35e094ceb19451c622318ac15e9fa9eaea609d7fae69cedec95e1656c20a",
           "sha256": "c029366141433ab312f41026590eb119ef648137f3b6cebeb416531fc0b4cccc",

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.3.0/expo.modules.font-13.3.0.module.md5

@@ -0,0 +1 @@
+39892a89e869963c9c3c22db1e9ac015

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.3.0/expo.modules.font-13.3.0.module.sha1

@@ -0,0 +1 @@
+0e565e048cfaf33c73a402d9213aaea96861f038

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.3.0/expo.modules.font-13.3.0.module.sha256

@@ -0,0 +1 @@
+cc4d40a8195d427839a47a13e22301e42b762f9fb08c7e2cd832a4c8e678af0d

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.3.0/expo.modules.font-13.3.0.module.sha512

@@ -0,0 +1 @@
+6306658311812a6a75c4f3151bb8af83e40c13e8600ac1680b6966f491c4d7a34d9850731bac24174ca1b3637aed6b08907d560ac324797c79b4ba9ce44d64fa

package/local-maven-repo/host/exp/exponent/expo.modules.font/{13.2.1/expo.modules.font-13.2.1.pom → 13.3.0/expo.modules.font-13.3.0.pom}

@@ -9,7 +9,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.font</artifactId>
-  <version>13.2.1</version>
+  <version>13.3.0</version>
   <packaging>aar</packaging>
   <name>expo.modules.font</name>
   <url>https://github.com/expo/expo</url>

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.3.0/expo.modules.font-13.3.0.pom.md5

@@ -0,0 +1 @@
+62c0479898237a499ab045cce88b083f

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.3.0/expo.modules.font-13.3.0.pom.sha1

@@ -0,0 +1 @@
+f270178adc59537695ef0a229319fc5259306318

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.3.0/expo.modules.font-13.3.0.pom.sha256

@@ -0,0 +1 @@
+05fedee066cf10e3e67d493f121429e5bf8fa14cbdf0ac657155292fe1fc544a

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.3.0/expo.modules.font-13.3.0.pom.sha512

@@ -0,0 +1 @@
+f9b0c840091a30da5b1ede1661128fb1160defbcb7cb6d1ee51e1cdd4eaf647e5152d441ef5ce425f126875da53a8907e30177c117290bb2ccb388434d5308dc

package/local-maven-repo/host/exp/exponent/expo.modules.font/maven-metadata.xml

@@ -3,11 +3,11 @@
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.font</artifactId>
   <versioning>
-    <latest>13.2.1</latest>
-    <release>13.2.1</release>
+    <latest>13.3.0</latest>
+    <release>13.3.0</release>
     <versions>
-      <version>13.2.1</version>
+      <version>13.3.0</version>
     </versions>
-    <lastUpdated>20250421220312</lastUpdated>
+    <lastUpdated>20250430211456</lastUpdated>
   </versioning>
 </metadata>

package/local-maven-repo/host/exp/exponent/expo.modules.font/maven-metadata.xml.md5

@@ -1 +1 @@
-06143ab0d257dc624f9835145348dbfa
+0e736e64d8af843891863db86c8fda30

package/local-maven-repo/host/exp/exponent/expo.modules.font/maven-metadata.xml.sha1

@@ -1 +1 @@
-ac9deaae8995da9fdbae4ae7018ec1e5b099246f
+603e3a4be8441e24654e3088d1e423d4de8f2af7

package/local-maven-repo/host/exp/exponent/expo.modules.font/maven-metadata.xml.sha256

@@ -1 +1 @@
-d363da4f98031768ca2e736f11cf3b6a0532e4df72e0e715aafff487989b1515
+3232a95e4e0859392951a3f0c6d3c95ff67164999f9fcdb8d4e99b2292cdcaae

package/local-maven-repo/host/exp/exponent/expo.modules.font/maven-metadata.xml.sha512

@@ -1 +1 @@
-762605d0ba1fa9f023b626a29e2171218017723388f793c4f7815bafe0a4d6ba6dde57db836243eace21f166b13cb0bc82c192cb8575ab898e2d2ffd983891ba
+e4f33387eed6c2e709f4d8f7702f874d639396ea928e38dc4d369ffa2d41d5ec7d4b6b10e11aef3533696f6d5f2afd2ee8978564f0f8f9dc4fec700919b4d496

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-font",
-  "version": "13.2.1",
+  "version": "13.3.0",
   "description": "Load fonts at runtime and use them in React Native components.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -10,6 +10,8 @@
     "clean": "expo-module clean",
     "lint": "expo-module lint",
     "test": "expo-module test",
+    "build:plugin": "expo-module build plugin",
+    "test:plugin": "expo-module test plugin",
     "test:rsc": "jest --config jest-rsc.config.js",
     "prepare": "expo-module prepare",
     "prepublishOnly": "expo-module prepublishOnly",
@@ -50,11 +52,11 @@
   "devDependencies": {
     "@testing-library/react-native": "^13.1.0",
     "@types/fontfaceobserver": "^2.1.3",
-    "expo-module-scripts": "^4.1.2"
+    "expo-module-scripts": "^4.1.6"
   },
   "peerDependencies": {
     "expo": "*",
     "react": "*"
   },
-  "gitHead": "9ec1a9d27c26ee62e106c4676e0a8557c303668c"
+  "gitHead": "84355076bc31a356aa3d23257f387f221885f53d"
 }

package/plugin/build/utils.d.ts

@@ -1 +1,2 @@
+export declare function toValidAndroidResourceName(value: string): string;
 export declare function resolveFontPaths(fonts: string[], projectRoot: string): Promise<string[]>;

package/plugin/build/utils.js

@@ -3,9 +3,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.toValidAndroidResourceName = toValidAndroidResourceName;
 exports.resolveFontPaths = resolveFontPaths;
 const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
+// rule: File-based resource names must contain only lowercase a-z, 0-9, or underscore
+function toValidAndroidResourceName(value) {
+    const valueWithoutFileExtension = path_1.default.parse(value).name;
+    const withUnderscores = valueWithoutFileExtension
+        .replace(/([a-z])([A-Z])/g, '$1_$2')
+        .replace(/([A-Z])([A-Z][a-z])/g, '$1_$2');
+    return withUnderscores
+        .toLowerCase()
+        .replace(/[^a-z0-9]/g, '_')
+        .replace(/_+/g, '_');
+}
 async function resolveFontPaths(fonts, projectRoot) {
     const promises = fonts.map(async (p) => {
         const resolvedPath = path_1.default.resolve(projectRoot, p);

package/plugin/build/withFonts.d.ts

@@ -1,8 +1,17 @@
 import { type ConfigPlugin } from 'expo/config-plugins';
+export type FontObject = {
+    fontFamily: string;
+    fontDefinitions: {
+        path: string;
+        weight: number;
+        style?: 'normal' | 'italic' | undefined;
+    }[];
+};
+export type Font = string | FontObject;
 export type FontProps = {
     fonts?: string[];
     android?: {
-        fonts?: string[];
+        fonts?: Font[];
     };
     ios?: {
         fonts?: string[];

package/plugin/build/withFontsAndroid.d.ts

@@ -1,2 +1,24 @@
 import { type ConfigPlugin } from 'expo/config-plugins';
-export declare const withFontsAndroid: ConfigPlugin<string[]>;
+import type { Font, FontObject } from './withFonts';
+export declare const withFontsAndroid: ConfigPlugin<Font[]>;
+type GroupedFontObject = Record<string, FontObject['fontDefinitions']>;
+export declare function groupByFamily(array: FontObject[]): GroupedFontObject;
+export declare function getXmlSpecs(fontsDir: string, xmlFontObjects: GroupedFontObject): {
+    path: string;
+    xml: {
+        'font-family': {
+            $: {
+                'xmlns:app': string;
+            };
+            font: {
+                $: {
+                    'app:font': string;
+                    'app:fontStyle': "normal" | "italic";
+                    'app:fontWeight': string;
+                };
+            }[];
+        };
+    };
+}[];
+export declare function generateFontManagerCalls(xmlFontObjects: GroupedFontObject, language: 'java' | 'kt'): string[];
+export {};

package/plugin/build/withFontsAndroid.js

@@ -4,19 +4,123 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.withFontsAndroid = void 0;
+exports.groupByFamily = groupByFamily;
+exports.getXmlSpecs = getXmlSpecs;
+exports.generateFontManagerCalls = generateFontManagerCalls;
+const codeMod_1 = require("@expo/config-plugins/build/android/codeMod");
+const generateCode_1 = require("@expo/config-plugins/build/utils/generateCode");
 const config_plugins_1 = require("expo/config-plugins");
 const promises_1 = __importDefault(require("fs/promises"));
+const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const utils_1 = require("./utils");
+const assetsFontsFir = 'app/src/main/assets/fonts';
+const resourcesFontsDir = 'app/src/main/res/font';
 const withFontsAndroid = (config, fonts) => {
+    const assetFontPaths = fonts.filter((it) => typeof it === 'string');
+    config = copyFontsToDir(config, assetFontPaths, assetsFontsFir);
+    const xmlFonts = fonts.filter((it) => typeof it === 'object');
+    config = addXmlFonts(config, xmlFonts);
+    return config;
+};
+exports.withFontsAndroid = withFontsAndroid;
+function groupByFamily(array) {
+    return array.reduce((result, item) => {
+        const keyValue = item['fontFamily'];
+        result[keyValue] ||= [];
+        result[keyValue].push(...item.fontDefinitions);
+        return result;
+    }, {});
+}
+function addXmlFonts(config, xmlFontObjects) {
+    const fontsByFamily = groupByFamily(xmlFontObjects);
+    const fontPaths = Object.values(fontsByFamily)
+        .map((font) => font.map((it) => it.path))
+        .flat();
+    config = copyFontsToDir(config, fontPaths, resourcesFontsDir, (filenameWithExt) => {
+        const filename = (0, utils_1.toValidAndroidResourceName)(filenameWithExt);
+        const ext = path_1.default.extname(filenameWithExt);
+        return `${filename}${ext}`;
+    });
+    config = addFontXmlToMainApplication(config, fontsByFamily);
+    return (0, config_plugins_1.withDangerousMod)(config, [
+        'android',
+        async (config) => {
+            const fontsDir = path_1.default.join(config.modRequest.platformProjectRoot, 'app/src/main/res/font');
+            const xmlSpecs = getXmlSpecs(fontsDir, fontsByFamily);
+            await Promise.all(xmlSpecs.map(config_plugins_1.XML.writeXMLAsync));
+            return config;
+        },
+    ]);
+}
+const resourceNameConflictAvoidancePrefix = 'xml_';
+function getXmlSpecs(fontsDir, xmlFontObjects) {
+    return Object.entries(xmlFontObjects).map(([fontFamily, fontDefinitions]) => {
+        const filePath = path_1.default.join(fontsDir, `${resourceNameConflictAvoidancePrefix + (0, utils_1.toValidAndroidResourceName)(fontFamily)}.xml`);
+        // each font family has one xml resource file with potentially multiple font definitions
+        // the font files (e.g. ttf) at `path` are copied to res/font
+        // with their name changed to be a valid resource and referenced in the xml file
+        return {
+            path: filePath,
+            xml: {
+                'font-family': {
+                    // using `app` namespace for better compat:
+                    // https://developer.android.com/develop/ui/views/text-and-emoji/fonts-in-xml#using-support-lib
+                    $: {
+                        'xmlns:app': 'http://schemas.android.com/apk/res-auto',
+                    },
+                    font: fontDefinitions.map((definition) => {
+                        return {
+                            $: {
+                                'app:font': `@font/${(0, utils_1.toValidAndroidResourceName)(definition.path)}`,
+                                'app:fontStyle': definition.style || 'normal',
+                                'app:fontWeight': String(definition.weight),
+                            },
+                        };
+                    }),
+                },
+            },
+        };
+    });
+}
+function addFontXmlToMainApplication(config, xmlFontObjects) {
+    return (0, config_plugins_1.withMainApplication)(config, (config) => {
+        const { modResults, modResults: { language }, } = config;
+        modResults.contents = (0, codeMod_1.addImports)(modResults.contents, ['com.facebook.react.common.assets.ReactFontManager'], language === 'java');
+        const fontManagerCalls = generateFontManagerCalls(xmlFontObjects, language).join(os_1.default.EOL);
+        const withInit = (0, generateCode_1.mergeContents)({
+            src: modResults.contents,
+            comment: '    //',
+            tag: 'xml-fonts-init',
+            offset: 1,
+            anchor: /super\.onCreate\(\)/,
+            newSrc: fontManagerCalls,
+        });
+        return {
+            ...config,
+            modResults: {
+                ...modResults,
+                contents: withInit.contents,
+            },
+        };
+    });
+}
+function generateFontManagerCalls(xmlFontObjects, language) {
+    const lineEnding = language === 'java' ? ';' : '';
+    const indent = '    ';
+    return Object.keys(xmlFontObjects).map((family) => `${indent}ReactFontManager.getInstance().addCustomFont(this, "${family}", R.font.${resourceNameConflictAvoidancePrefix + (0, utils_1.toValidAndroidResourceName)(family)})${lineEnding}`);
+}
+function copyFontsToDir(config, paths, inAppDestination, filenameProcessor = (filenameWithExt) => filenameWithExt) {
     return (0, config_plugins_1.withDangerousMod)(config, [
         'android',
         async (config) => {
-            const resolvedFonts = await (0, utils_1.resolveFontPaths)(fonts, config.modRequest.projectRoot);
+            const fontsDir = path_1.default.join(config.modRequest.platformProjectRoot, inAppDestination);
+            await promises_1.default.mkdir(fontsDir, { recursive: true });
+            const resolvedFonts = await (0, utils_1.resolveFontPaths)(paths, config.modRequest.projectRoot);
             await Promise.all(resolvedFonts.map(async (asset) => {
-                const fontsDir = path_1.default.join(config.modRequest.platformProjectRoot, 'app/src/main/assets/fonts');
-                await promises_1.default.mkdir(fontsDir, { recursive: true });
-                const output = path_1.default.join(fontsDir, path_1.default.basename(asset));
+                const filenameWithExt = path_1.default.basename(asset);
+                const outputFileName = filenameProcessor(filenameWithExt);
+                const output = path_1.default.join(fontsDir, outputFileName);
                 if (output.endsWith('.ttf') || output.endsWith('.otf')) {
                     await promises_1.default.copyFile(asset, output);
                 }
@@ -24,5 +128,4 @@ const withFontsAndroid = (config, fonts) => {
             return config;
         },
     ]);
-};
-exports.withFontsAndroid = withFontsAndroid;
+}

package/plugin/src/utils.ts

@@ -1,6 +1,20 @@
 import fs from 'fs/promises';
 import path from 'path';
 
+// rule: File-based resource names must contain only lowercase a-z, 0-9, or underscore
+export function toValidAndroidResourceName(value: string) {
+  const valueWithoutFileExtension = path.parse(value).name;
+
+  const withUnderscores = valueWithoutFileExtension
+    .replace(/([a-z])([A-Z])/g, '$1_$2')
+    .replace(/([A-Z])([A-Z][a-z])/g, '$1_$2');
+
+  return withUnderscores
+    .toLowerCase()
+    .replace(/[^a-z0-9]/g, '_')
+    .replace(/_+/g, '_');
+}
+
 export async function resolveFontPaths(fonts: string[], projectRoot: string) {
   const promises = fonts.map(async (p) => {
     const resolvedPath = path.resolve(projectRoot, p);

package/plugin/src/withFonts.ts

@@ -5,10 +5,21 @@ import { withFontsIos } from './withFontsIos';
 
 const pkg = require('expo-font/package.json');
 
+export type FontObject = {
+  fontFamily: string;
+  fontDefinitions: {
+    path: string;
+    weight: number;
+    style?: 'normal' | 'italic' | undefined;
+  }[];
+};
+
+export type Font = string | FontObject;
+
 export type FontProps = {
   fonts?: string[];
   android?: {
-    fonts?: string[];
+    fonts?: Font[];
   };
   ios?: {
     fonts?: string[];

package/plugin/src/withFontsAndroid.ts

@@ -1,22 +1,168 @@
-import { type ConfigPlugin, withDangerousMod } from 'expo/config-plugins';
+import { addImports } from '@expo/config-plugins/build/android/codeMod';
+import { mergeContents } from '@expo/config-plugins/build/utils/generateCode';
+import { type ExpoConfig } from '@expo/config-types';
+import { type ConfigPlugin, withDangerousMod, withMainApplication, XML } from 'expo/config-plugins';
 import fs from 'fs/promises';
+import os from 'os';
 import path from 'path';
 
-import { resolveFontPaths } from './utils';
+import { resolveFontPaths, toValidAndroidResourceName } from './utils';
+import type { Font, FontObject } from './withFonts';
+
+const assetsFontsFir = 'app/src/main/assets/fonts';
+const resourcesFontsDir = 'app/src/main/res/font';
+
+export const withFontsAndroid: ConfigPlugin<Font[]> = (config, fonts) => {
+  const assetFontPaths = fonts.filter((it) => typeof it === 'string');
+  config = copyFontsToDir(config, assetFontPaths, assetsFontsFir);
+
+  const xmlFonts = fonts.filter((it) => typeof it === 'object');
+  config = addXmlFonts(config, xmlFonts);
+
+  return config;
+};
+
+type GroupedFontObject = Record<string, FontObject['fontDefinitions']>;
+
+export function groupByFamily(array: FontObject[]): GroupedFontObject {
+  return array.reduce<GroupedFontObject>((result, item) => {
+    const keyValue = item['fontFamily'];
+    result[keyValue] ||= [];
+    result[keyValue].push(...item.fontDefinitions);
+    return result;
+  }, {});
+}
+
+function addXmlFonts(config: ExpoConfig, xmlFontObjects: FontObject[]) {
+  const fontsByFamily = groupByFamily(xmlFontObjects);
+
+  const fontPaths = Object.values(fontsByFamily)
+    .map((font) => font.map((it) => it.path))
+    .flat();
+
+  config = copyFontsToDir(config, fontPaths, resourcesFontsDir, (filenameWithExt) => {
+    const filename = toValidAndroidResourceName(filenameWithExt);
+    const ext = path.extname(filenameWithExt);
+    return `${filename}${ext}`;
+  });
+
+  config = addFontXmlToMainApplication(config, fontsByFamily);
 
-export const withFontsAndroid: ConfigPlugin<string[]> = (config, fonts) => {
   return withDangerousMod(config, [
     'android',
     async (config) => {
-      const resolvedFonts = await resolveFontPaths(fonts, config.modRequest.projectRoot);
+      const fontsDir = path.join(config.modRequest.platformProjectRoot, 'app/src/main/res/font');
+
+      const xmlSpecs = getXmlSpecs(fontsDir, fontsByFamily);
+
+      await Promise.all(xmlSpecs.map(XML.writeXMLAsync));
+
+      return config;
+    },
+  ]);
+}
+
+const resourceNameConflictAvoidancePrefix = 'xml_';
+
+export function getXmlSpecs(fontsDir: string, xmlFontObjects: GroupedFontObject) {
+  return Object.entries(xmlFontObjects).map(([fontFamily, fontDefinitions]) => {
+    const filePath = path.join(
+      fontsDir,
+      `${resourceNameConflictAvoidancePrefix + toValidAndroidResourceName(fontFamily)}.xml`
+    );
+    // each font family has one xml resource file with potentially multiple font definitions
+    // the font files (e.g. ttf) at `path` are copied to res/font
+    // with their name changed to be a valid resource and referenced in the xml file
+    return {
+      path: filePath,
+      xml: {
+        'font-family': {
+          // using `app` namespace for better compat:
+          // https://developer.android.com/develop/ui/views/text-and-emoji/fonts-in-xml#using-support-lib
+          $: {
+            'xmlns:app': 'http://schemas.android.com/apk/res-auto',
+          },
+          font: fontDefinitions.map((definition) => {
+            return {
+              $: {
+                'app:font': `@font/${toValidAndroidResourceName(definition.path)}`,
+                'app:fontStyle': definition.style || 'normal',
+                'app:fontWeight': String(definition.weight),
+              },
+            };
+          }),
+        },
+      },
+    };
+  });
+}
+
+function addFontXmlToMainApplication(config: ExpoConfig, xmlFontObjects: GroupedFontObject) {
+  return withMainApplication(config, (config) => {
+    const {
+      modResults,
+      modResults: { language },
+    } = config;
+
+    modResults.contents = addImports(
+      modResults.contents,
+      ['com.facebook.react.common.assets.ReactFontManager'],
+      language === 'java'
+    );
+
+    const fontManagerCalls = generateFontManagerCalls(xmlFontObjects, language).join(os.EOL);
+
+    const withInit = mergeContents({
+      src: modResults.contents,
+      comment: '    //',
+      tag: 'xml-fonts-init',
+      offset: 1,
+      anchor: /super\.onCreate\(\)/,
+      newSrc: fontManagerCalls,
+    });
+
+    return {
+      ...config,
+      modResults: {
+        ...modResults,
+        contents: withInit.contents,
+      },
+    };
+  });
+}
+
+export function generateFontManagerCalls(
+  xmlFontObjects: GroupedFontObject,
+  language: 'java' | 'kt'
+) {
+  const lineEnding = language === 'java' ? ';' : '';
+  const indent = '    ';
+
+  return Object.keys(xmlFontObjects).map(
+    (family) =>
+      `${indent}ReactFontManager.getInstance().addCustomFont(this, "${family}", R.font.${resourceNameConflictAvoidancePrefix + toValidAndroidResourceName(family)})${lineEnding}`
+  );
+}
+
+function copyFontsToDir(
+  config: ExpoConfig,
+  paths: string[],
+  inAppDestination: typeof assetsFontsFir | typeof resourcesFontsDir,
+  filenameProcessor = (filenameWithExt: string) => filenameWithExt
+) {
+  return withDangerousMod(config, [
+    'android',
+    async (config) => {
+      const fontsDir = path.join(config.modRequest.platformProjectRoot, inAppDestination);
+      await fs.mkdir(fontsDir, { recursive: true });
+
+      const resolvedFonts = await resolveFontPaths(paths, config.modRequest.projectRoot);
+
       await Promise.all(
         resolvedFonts.map(async (asset) => {
-          const fontsDir = path.join(
-            config.modRequest.platformProjectRoot,
-            'app/src/main/assets/fonts'
-          );
-          await fs.mkdir(fontsDir, { recursive: true });
-          const output = path.join(fontsDir, path.basename(asset));
+          const filenameWithExt = path.basename(asset);
+          const outputFileName = filenameProcessor(filenameWithExt);
+          const output = path.join(fontsDir, outputFileName);
           if (output.endsWith('.ttf') || output.endsWith('.otf')) {
             await fs.copyFile(asset, output);
           }
@@ -25,4 +171,4 @@ export const withFontsAndroid: ConfigPlugin<string[]> = (config, fonts) => {
       return config;
     },
   ]);
-};
+}

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.2.1/expo.modules.font-13.2.1.aar.md5

@@ -1 +0,0 @@
-c4a5fbec91ef91f550b4a16b8011c1da

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.2.1/expo.modules.font-13.2.1.aar.sha1

@@ -1 +0,0 @@
-8a3e0658bef6d46ddbdfaf891baba11daaadbfc8

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.2.1/expo.modules.font-13.2.1.aar.sha256

@@ -1 +0,0 @@
-02e3e22b8a6570b0a9ae2d3fff74bcb898a90480d271d162ef76c2c6415fd763

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.2.1/expo.modules.font-13.2.1.aar.sha512

@@ -1 +0,0 @@
-23e09b1c63cedb2c4e2063a509bdd0ecb91c8815cb946ef3707fba50b7ca2f4ac3c20d825847a1885cec0fd3c29dbd153d730acc552a33e5c031928551c707ab

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.2.1/expo.modules.font-13.2.1.module.md5

@@ -1 +0,0 @@
-ab2111506fee5ab397664a22323363e9

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.2.1/expo.modules.font-13.2.1.module.sha1

@@ -1 +0,0 @@
-744c03e7065961577e85e6a6906545ba5f715369

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.2.1/expo.modules.font-13.2.1.module.sha256

@@ -1 +0,0 @@
-67b68f0ded24f2aaf72c4e89269c04f815ab133341e300b6dbcb7ea8c0211b08

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.2.1/expo.modules.font-13.2.1.module.sha512

@@ -1 +0,0 @@
-fd4147e6cd7d0153a8025a673cfe3eaeb9125423c425b616afdf6585067ea799132c929c9cb0c39d13632e7729b586115a1999a13f13afeb93f216a0b10ecb05

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.2.1/expo.modules.font-13.2.1.pom.md5

@@ -1 +0,0 @@
-fbe47c6658d57afb5f9f9300a151962e

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.2.1/expo.modules.font-13.2.1.pom.sha1

@@ -1 +0,0 @@
-a9aed5a8695cde23f07557b07b37c99ee42698f0

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.2.1/expo.modules.font-13.2.1.pom.sha256

@@ -1 +0,0 @@
-f3f3b799afdcda81128d46eb305131cdbadb5af9ae0076b6d921e9dc8f89d929

package/local-maven-repo/host/exp/exponent/expo.modules.font/13.2.1/expo.modules.font-13.2.1.pom.sha512

@@ -1 +0,0 @@
-29e2e1c0252322dfbc167060ac6f9424d8df0cc699e4e3c18108fa1dfbb36dd5ae1fad14e0b74931174dfb3489282233343860f00a55a23d29366bde0575b48b