react-native-legal 1.0.0-next.1

package/plugin-utils/build/android.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addListActivityUtil = exports.applyAndConfigureAboutLibrariesPluginUtil = exports.declareAboutLibrariesPluginUtil = void 0;
+const common_1 = require("./common");
+/**
+ * Applies Gradle Plugin Portal & AboutLibraries Gradle plugin repositories (if needed) inside root build.gradle
+ */
+function declareAboutLibrariesPluginUtil(androidBuildGradleContent) {
+    if (!androidBuildGradleContent.match(PLUGIN_CLASSPATH)?.length) {
+        // Add Gradle Plugin Portal repository if it's not included
+        if (!androidBuildGradleContent.match(GRADLE_PLUGIN_PORTAL_URL)?.length) {
+            androidBuildGradleContent = androidBuildGradleContent.replace(/repositories\s?{/, `repositories {\n        maven { url = uri("${GRADLE_PLUGIN_PORTAL_URL}") }`);
+            console.log('Gradle Plugin Portal repository - ADDED');
+        }
+        else {
+            console.log('Gradle Plugin Portal repository already added - SKIP');
+        }
+        // Declare the AboutLibraries plugin
+        androidBuildGradleContent = androidBuildGradleContent.replace(/dependencies\s?{/, `dependencies {\n        classpath("${PLUGIN_CLASSPATH}:${PLUGIN_VERSION}")`);
+        console.log('About Libraries Gradle Plugin repository - ADDED');
+    }
+    else {
+        console.log('About Libraries Gradle Plugin already added - SKIP');
+    }
+    return androidBuildGradleContent;
+}
+exports.declareAboutLibrariesPluginUtil = declareAboutLibrariesPluginUtil;
+/**
+ * Applies and configures AboutLibraries Grale plugin (if needed) inside app's build.gradle
+ */
+function applyAndConfigureAboutLibrariesPluginUtil(androidAppBuildGradleContent) {
+    // Apply plugin
+    const applyPluginBlockRegex = new RegExp(`apply\\s+plugin:\\s+['"]${PLUGIN_APPLY_BLOCK_IDENTIFIER}['"]`);
+    if (!androidAppBuildGradleContent.match(applyPluginBlockRegex)?.length) {
+        androidAppBuildGradleContent += `\n${PLUGIN_APPLY_BLOCK}`;
+        console.log('About Libraries Gradle Plugin - APPLIED');
+    }
+    else {
+        console.log('About Libraries Gradle Plugin already applied - SKIP');
+    }
+    // Configure plugin
+    const pluginConfigRegex = /aboutLibraries {/;
+    if (!androidAppBuildGradleContent.match(pluginConfigRegex)?.length) {
+        androidAppBuildGradleContent += '\n\naboutLibraries {\n    configPath = "config"\n    prettyPrint = true\n}';
+        console.log('About Libraries Gradle Plugin - CONFIGURED');
+    }
+    else {
+        console.log('About Libraries Gradle Plugin already configured - SKIP');
+    }
+    return androidAppBuildGradleContent;
+}
+exports.applyAndConfigureAboutLibrariesPluginUtil = applyAndConfigureAboutLibrariesPluginUtil;
+/**
+ * adds a list activity to the list of application's activities
+ */
+function addListActivityUtil(activities) {
+    const listActivity = prepareListActivity();
+    if (!(0, common_1.arrayIncludesObject)(activities, listActivity)) {
+        activities?.push(listActivity);
+        console.log('About Libraries activity - ADDED');
+    }
+    else {
+        console.log('About Libraries activity already added - SKIP');
+    }
+    return activities;
+}
+exports.addListActivityUtil = addListActivityUtil;
+/**
+ * This JS object will evaluate to the following XML content:
+ *
+ * <activity
+ *   android:name="com.reactnativelegal.ReactNativeLegalActivity"
+ *   android:exported="false"
+ *   android:launchMode="singleTask"
+ * />
+ */
+function prepareListActivity() {
+    return {
+        $: {
+            'android:name': PLUGIN_ACTIVITY,
+            'android:exported': 'false',
+            'android:launchMode': 'singleTask',
+        },
+    };
+}
+const GRADLE_PLUGIN_PORTAL_URL = 'https://plugins.gradle.org/m2';
+const PLUGIN_ACTIVITY = 'com.reactnativelegal.ReactNativeLegalActivity';
+const PLUGIN_APPLY_BLOCK = "apply plugin: 'com.mikepenz.aboutlibraries.plugin'";
+const PLUGIN_APPLY_BLOCK_IDENTIFIER = 'com.mikepenz.aboutlibraries.plugin';
+const PLUGIN_CLASSPATH = 'com.mikepenz.aboutlibraries.plugin:aboutlibraries-plugin';
+const PLUGIN_VERSION = '11.6.3';

package/plugin-utils/build/common.d.ts

@@ -0,0 +1,45 @@
+type LicenseObj = {
+    author?: string;
+    content?: string;
+    description?: string;
+    type?: string;
+    url?: string;
+    version: string;
+};
+/**
+ * Makes a deep-check between array items and provided object, returns true if array has provided object.
+ */
+export declare function arrayIncludesObject(array?: unknown[], object?: unknown): boolean | undefined;
+/**
+ * Scans `package.json` and searches for all packages under `dependencies` field. Supports monorepo projects.
+ */
+export declare function scanDependencies(appPackageJsonPath: string): Record<string, LicenseObj>;
+/**
+ * Generates LicensePlist-compatible metadata for NPM dependencies
+ *
+ * This will take scanned NPM licenses and produce following output inside iOS project's directory:
+ *
+ * | - ios
+ * | ---- myawesomeapp
+ * | ---- myawesomeapp.xcodeproj
+ * | ---- myawesomeapp.xcodeworkspace
+ * | ---- license_plist.yml <--- generated LicensePlist config with NPM dependencies
+ * | ---- Podfile
+ * | ---- Podfile.lock
+ */
+export declare function generateLicensePlistNPMOutput(licenses: Record<string, LicenseObj>, iosProjectPath: string): void;
+/**
+ * Generates AboutLibraries-compatible metadata for NPM dependencies
+ *
+ * This will take scanned NPM licenses and produce following output inside android project's directory:
+ *
+ * | - android
+ * | ---- app
+ * | ---- config <--- generated AboutLibraries config directory
+ * | ------- libraries <--- generated directory with JSON files list of NPM dependencies
+ * | ------- licenses <--- generated directory with JSON files list of used licenses
+ * | ---- build.gradle
+ * | ---- settings.gradle
+ */
+export declare function generateAboutLibrariesNPMOutput(licenses: Record<string, LicenseObj>, androidProjectPath: string): void;
+export {};

package/plugin-utils/build/common.js

@@ -0,0 +1,312 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAboutLibrariesNPMOutput = exports.generateLicensePlistNPMOutput = exports.scanDependencies = exports.arrayIncludesObject = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const glob = require('glob');
+function compareObjects(a, b) {
+    if (a == null || b == null || typeof a !== 'object' || typeof b !== 'object') {
+        return a === b;
+    }
+    const entriesA = Object.entries(a);
+    const entriesB = Object.entries(b);
+    return (entriesA.length === entriesB.length &&
+        entriesA
+            .map(([keyA, valueA]) => {
+            const entry = entriesB.find(([keyB]) => keyA === keyB);
+            if (!entry) {
+                return valueA === entry;
+            }
+            const [, valueB] = entry;
+            return compareObjects(valueA, valueB);
+        })
+            .reduce((acc, curr) => acc && curr, true));
+}
+/**
+ * Makes a deep-check between array items and provided object, returns true if array has provided object.
+ */
+function arrayIncludesObject(array, object) {
+    return array?.map((item) => compareObjects(item, object)).reduce((acc, curr) => acc || curr, false);
+}
+exports.arrayIncludesObject = arrayIncludesObject;
+/**
+ * Scans `package.json` and searches for all packages under `dependencies` field. Supports monorepo projects.
+ */
+function scanDependencies(appPackageJsonPath) {
+    const appPackageJson = require(path_1.default.resolve(appPackageJsonPath));
+    const dependencies = appPackageJson.dependencies;
+    return Object.keys(dependencies).reduce((acc, dependency) => {
+        try {
+            const localPackageJsonPath = getPackageJsonPath(dependency);
+            if (!localPackageJsonPath) {
+                console.warn(`[react-native-legal] skipping ${dependency} could not find package.json`);
+                return acc;
+            }
+            const localPackageJson = require(path_1.default.resolve(localPackageJsonPath));
+            const licenseFiles = glob.sync('LICEN{S,C}E{.md,}', {
+                cwd: path_1.default.dirname(localPackageJsonPath),
+                absolute: true,
+                nocase: true,
+                nodir: true,
+                ignore: '**/{__tests__,__fixtures__,__mocks__}/**',
+            });
+            acc[dependency] = {
+                author: parseAuthorField(localPackageJson),
+                content: licenseFiles?.[0] ? fs_1.default.readFileSync(licenseFiles[0], { encoding: 'utf-8' }) : undefined,
+                description: localPackageJson.description,
+                type: parseLicenseField(localPackageJson),
+                url: parseRepositoryFieldToUrl(localPackageJson),
+                version: localPackageJson.version,
+            };
+        }
+        catch (error) {
+            console.warn(`[react-native-legal] could not process package.json for ${dependency}`);
+        }
+        return acc;
+    }, {});
+}
+exports.scanDependencies = scanDependencies;
+function needsQuoting(value) {
+    return (value === '' || // empty string
+        /^[#:>|-]/.test(value) || // starts with special char
+        /^['"{}[\],&*#?|<>=!%@`]/.test(value) || // starts with indicator chars
+        /^[\s]|[\s]$/.test(value) || // has leading/trailing whitespace
+        /^[\d.+-]/.test(value) || // looks like a number/bool/null
+        /[\n"'\\\s]/.test(value) || // contains newlines, quotes, backslash, or spaces
+        /^(true|false|yes|no|null|on|off)$/i.test(value) // is a YAML keyword
+    );
+}
+function formatYamlKey(key) {
+    return /[@/_.]/.test(key) ? `"${key}"` : key;
+}
+function formatYamlValue(value, indent) {
+    if (value.includes('\n')) {
+        const indentedValue = value
+            .split('\n')
+            .map((line) => `${' '.repeat(indent)}${line}`)
+            .join('\n');
+        // Return the block indicator on the same line as the content
+        return `|${indentedValue ? '\n' + indentedValue : ''}`;
+    }
+    if (needsQuoting(value)) {
+        if (value.includes("'") && !value.includes('"')) {
+            return `"${value.replace(/["\\]/g, '\\$&')}"`;
+        }
+        return `'${value.replace(/'/g, "''")}'`;
+    }
+    return value;
+}
+function toYaml(obj, indent = 0) {
+    const spaces = ' '.repeat(indent);
+    if (obj == null)
+        return '';
+    if (Array.isArray(obj)) {
+        return obj.map((item) => `${spaces}- ${toYaml(item, indent + 2).trimStart()}`).join('\n');
+    }
+    if (typeof obj === 'object') {
+        return Object.entries(obj)
+            .filter(([, v]) => v != null)
+            .map(([key, value]) => {
+            const formattedKey = formatYamlKey(key);
+            const formattedValue = toYaml(value, indent + 2);
+            if (Array.isArray(value)) {
+                return `${spaces}${formattedKey}:\n${formattedValue}`;
+            }
+            if (typeof value === 'object' && value !== null) {
+                return `${spaces}${formattedKey}:\n${formattedValue}`;
+            }
+            if (typeof value === 'string' && value.includes('\n')) {
+                return `${spaces}${formattedKey}: ${formattedValue}`;
+            }
+            return `${spaces}${formattedKey}: ${formattedValue}`;
+        })
+            .join('\n');
+    }
+    return typeof obj === 'string' ? formatYamlValue(obj, indent) : String(obj);
+}
+/**
+ * Generates LicensePlist-compatible metadata for NPM dependencies
+ *
+ * This will take scanned NPM licenses and produce following output inside iOS project's directory:
+ *
+ * | - ios
+ * | ---- myawesomeapp
+ * | ---- myawesomeapp.xcodeproj
+ * | ---- myawesomeapp.xcodeworkspace
+ * | ---- license_plist.yml <--- generated LicensePlist config with NPM dependencies
+ * | ---- Podfile
+ * | ---- Podfile.lock
+ */
+function generateLicensePlistNPMOutput(licenses, iosProjectPath) {
+    const renames = {};
+    const licenseEntries = Object.entries(licenses).map(([dependency, licenseObj]) => {
+        const normalizedName = normalizePackageName(dependency);
+        if (dependency !== normalizedName) {
+            renames[normalizedName] = dependency;
+        }
+        return {
+            name: normalizedName,
+            version: licenseObj.version,
+            ...(licenseObj.url && { source: licenseObj.url }),
+            body: licenseObj.content ?? licenseObj.type ?? 'UNKNOWN',
+        };
+    });
+    const yamlDoc = {
+        ...(Object.keys(renames).length > 0 && { rename: renames }),
+        manual: licenseEntries,
+    };
+    const yamlContent = [
+        '# BEGIN Generated NPM license entries',
+        toYaml(yamlDoc),
+        '# END Generated NPM license entries',
+    ].join('\n');
+    fs_1.default.writeFileSync(path_1.default.join(iosProjectPath, 'license_plist.yml'), yamlContent, { encoding: 'utf-8' });
+}
+exports.generateLicensePlistNPMOutput = generateLicensePlistNPMOutput;
+/**
+ * Generates AboutLibraries-compatible metadata for NPM dependencies
+ *
+ * This will take scanned NPM licenses and produce following output inside android project's directory:
+ *
+ * | - android
+ * | ---- app
+ * | ---- config <--- generated AboutLibraries config directory
+ * | ------- libraries <--- generated directory with JSON files list of NPM dependencies
+ * | ------- licenses <--- generated directory with JSON files list of used licenses
+ * | ---- build.gradle
+ * | ---- settings.gradle
+ */
+function generateAboutLibrariesNPMOutput(licenses, androidProjectPath) {
+    const aboutLibrariesConfigDirPath = path_1.default.join(androidProjectPath, 'config');
+    const aboutLibrariesConfigLibrariesDirPath = path_1.default.join(aboutLibrariesConfigDirPath, 'libraries');
+    const aboutLibrariesConfigLicensesDirPath = path_1.default.join(aboutLibrariesConfigDirPath, 'licenses');
+    if (!fs_1.default.existsSync(aboutLibrariesConfigDirPath)) {
+        fs_1.default.mkdirSync(aboutLibrariesConfigDirPath);
+    }
+    if (!fs_1.default.existsSync(aboutLibrariesConfigLibrariesDirPath)) {
+        fs_1.default.mkdirSync(aboutLibrariesConfigLibrariesDirPath);
+    }
+    if (!fs_1.default.existsSync(aboutLibrariesConfigLicensesDirPath)) {
+        fs_1.default.mkdirSync(aboutLibrariesConfigLicensesDirPath);
+    }
+    Object.entries(licenses)
+        .map(([dependency, licenseObj]) => {
+        return {
+            artifactVersion: licenseObj.version,
+            content: licenseObj.content ?? '',
+            description: licenseObj.description ?? '',
+            developers: [{ name: licenseObj.author ?? '', organisationUrl: '' }],
+            licenses: [prepareAboutLibrariesLicenseField(licenseObj)],
+            name: dependency,
+            tag: '',
+            type: licenseObj.type,
+            uniqueId: normalizePackageName(dependency),
+        };
+    })
+        .map((jsonPayload) => {
+        const libraryJsonPayload = {
+            artifactVersion: jsonPayload.artifactVersion,
+            description: jsonPayload.description,
+            developers: jsonPayload.developers,
+            licenses: jsonPayload.licenses,
+            name: jsonPayload.name,
+            tag: jsonPayload.tag,
+            uniqueId: jsonPayload.uniqueId,
+        };
+        const licenseJsonPayload = {
+            content: jsonPayload.content,
+            hash: jsonPayload.licenses[0],
+            name: jsonPayload.type ?? '',
+            url: '',
+        };
+        const libraryJsonFilePath = path_1.default.join(aboutLibrariesConfigLibrariesDirPath, `${normalizePackageName(jsonPayload.name)}.json`);
+        const licenseJsonFilePath = path_1.default.join(aboutLibrariesConfigLicensesDirPath, `${licenseJsonPayload.hash}.json`);
+        fs_1.default.writeFileSync(libraryJsonFilePath, JSON.stringify(libraryJsonPayload));
+        if (!fs_1.default.existsSync(licenseJsonFilePath)) {
+            fs_1.default.writeFileSync(licenseJsonFilePath, JSON.stringify(licenseJsonPayload));
+        }
+    });
+}
+exports.generateAboutLibrariesNPMOutput = generateAboutLibrariesNPMOutput;
+function prepareAboutLibrariesLicenseField(license) {
+    if (!license.type) {
+        return '';
+    }
+    return `${license.type}_${sha512(license.content ?? license.type)}`;
+}
+function sha512(text) {
+    return crypto_1.default.createHash('sha512').update(text).digest('hex');
+}
+function parseAuthorField(json) {
+    if (typeof json.author === 'object' && typeof json.author.name === 'string') {
+        return json.author.name;
+    }
+    if (typeof json.author === 'string') {
+        return json.author;
+    }
+}
+function parseLicenseField(json) {
+    if (typeof json.license === 'object' && typeof json.license.type === 'string') {
+        return json.license.type;
+    }
+    if (typeof json.license === 'string') {
+        return json.license;
+    }
+}
+function parseRepositoryFieldToUrl(json) {
+    if (typeof json.repository === 'object' && typeof json.repository.url === 'string') {
+        return normalizeRepositoryUrl(json.repository.url);
+    }
+    if (typeof json.repository === 'string') {
+        return normalizeRepositoryUrl(json.repository);
+    }
+}
+function normalizeRepositoryUrl(url) {
+    return url
+        .replace('git+ssh://git@', 'git://')
+        .replace('.git', '')
+        .replace('git+https://github.com', 'https://github.com')
+        .replace('.git', '')
+        .replace('git://github.com', 'https://github.com')
+        .replace('.git', '')
+        .replace('git@github.com:', 'https://github.com/')
+        .replace('.git', '')
+        .replace('github:', 'https://github.com/')
+        .replace('.git', '');
+}
+function getPackageJsonPath(dependency) {
+    try {
+        return require.resolve(`${dependency}/package.json`);
+    }
+    catch (error) {
+        return resolvePackageJsonFromEntry(dependency);
+    }
+}
+function resolvePackageJsonFromEntry(dependency) {
+    try {
+        const entryPath = require.resolve(dependency);
+        const packageDir = findPackageRoot(entryPath);
+        if (!packageDir)
+            return null;
+        const packageJsonPath = path_1.default.join(packageDir, 'package.json');
+        return fs_1.default.existsSync(packageJsonPath) ? packageJsonPath : null;
+    }
+    catch {
+        return null;
+    }
+}
+function findPackageRoot(entryPath) {
+    let currentDir = path_1.default.dirname(entryPath);
+    while (currentDir !== path_1.default.dirname(currentDir)) {
+        if (fs_1.default.existsSync(path_1.default.join(currentDir, 'package.json')))
+            return currentDir;
+        currentDir = path_1.default.dirname(currentDir);
+    }
+}
+function normalizePackageName(packageName) {
+    return packageName.replace('/', '_');
+}

package/plugin-utils/build/ios.d.ts

@@ -0,0 +1,11 @@
+import type { XcodeProject } from 'xcode';
+/**
+ * Creates a Settings.bundle from a template and invokes a callback responsible for linking new file to the iOS project
+ */
+export declare function addSettingsBundleUtil(iosProjectPath: string, addResourceFileToGroup: ({ settingsBundleFilename }: {
+    settingsBundleFilename: string;
+}) => void): void;
+/**
+ * Creates a shell script build phase (if needed) and links it to native targets build phases
+ */
+export declare function registerLicensePlistBuildPhaseUtil(projectTargetId: string, pbxproj: XcodeProject): XcodeProject;

package/plugin-utils/build/ios.js

@@ -0,0 +1,86 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerLicensePlistBuildPhaseUtil = exports.addSettingsBundleUtil = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Creates a Settings.bundle from a template and invokes a callback responsible for linking new file to the iOS project
+ */
+function addSettingsBundleUtil(iosProjectPath, addResourceFileToGroup) {
+    const settingsBundleFilename = 'Settings.bundle';
+    const settingsBundleRootPlistFilename = 'Root.plist';
+    const settingsBundlePath = path_1.default.join(iosProjectPath, settingsBundleFilename);
+    const settingsBundleRootPlistPath = path_1.default.join(settingsBundlePath, settingsBundleRootPlistFilename);
+    if (!fs_1.default.existsSync(settingsBundleRootPlistPath)) {
+        // Create `Settings.bundle` directory
+        if (!fs_1.default.existsSync(settingsBundlePath)) {
+            fs_1.default.mkdirSync(settingsBundlePath, { recursive: true });
+        }
+        // Create `Settings.bundle/Root.plist`
+        fs_1.default.writeFileSync(settingsBundleRootPlistPath, SETTINGS_BUNDLE_ROOT_PLIST_CONTENT);
+        // Link `Settings.bundle` to the resources
+        addResourceFileToGroup({ settingsBundleFilename });
+        console.log('Settings.bundle/Root.plist - ADDED');
+    }
+    else {
+        console.log('Settings.bundle/Root.plist already present - SKIP');
+    }
+}
+exports.addSettingsBundleUtil = addSettingsBundleUtil;
+/**
+ * Creates a shell script build phase (if needed) and links it to native targets build phases
+ */
+function registerLicensePlistBuildPhaseUtil(projectTargetId, pbxproj) {
+    const nativeTargetSection = pbxproj.pbxNativeTargetSection();
+    const nativeTarget = nativeTargetSection[projectTargetId];
+    if (pbxproj.buildPhase(GENERATE_LICENSE_PLIST_BUILD_PHASE_COMMENT, projectTargetId)) {
+        console.log(`LicensePlist buildPhase already added in "${nativeTarget.name}" - SKIP`);
+        return pbxproj;
+    }
+    /**
+     * The build phase will generate licenses metadata using `LicensePlist` library and store it inside `Settings.bundle`.
+     *
+     * This will return an object with the uuid of the newly created build phase and its associated comment.
+     */
+    const newBuildPhase = pbxproj.addBuildPhase([], 'PBXShellScriptBuildPhase', GENERATE_LICENSE_PLIST_BUILD_PHASE_COMMENT, projectTargetId, {
+        shellPath: '/bin/sh',
+        shellScript: '${PODS_ROOT}/LicensePlist/license-plist --output-path ./Settings.bundle',
+    });
+    /**
+     * In order to correctly link all metadata from `Settings.bundle` to the app
+     * the newly created build phase has to be invoked before `Copy Bundle Resources` build phase.
+     *
+     * To make sure that happens, let's put newly created build phase as a first in the sequence.
+     * It can be done by overriding `PBXNativeTarget["buildPhases"]` array.
+     */
+    const newBuildPhasesInNativeTarget = [
+        { value: newBuildPhase.uuid, comment: GENERATE_LICENSE_PLIST_BUILD_PHASE_COMMENT },
+    ].concat(nativeTarget.buildPhases.filter(({ value }) => value !== newBuildPhase.uuid));
+    nativeTarget.buildPhases = newBuildPhasesInNativeTarget;
+    console.log(`LicensePlist buildPhase in nativeTarget "${nativeTarget.name}" - ADDED`);
+    return pbxproj;
+}
+exports.registerLicensePlistBuildPhaseUtil = registerLicensePlistBuildPhaseUtil;
+const GENERATE_LICENSE_PLIST_BUILD_PHASE_COMMENT = 'Generate licenses with LicensePlist';
+const SETTINGS_BUNDLE_ROOT_PLIST_CONTENT = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>StringsTable</key>
+  <string>Root</string>
+  <key>PreferenceSpecifiers</key>
+  <array>
+    <dict>
+      <key>Type</key>
+      <string>PSChildPaneSpecifier</string>
+      <key>Title</key>
+      <string>Licenses</string>
+      <key>File</key>
+      <string>com.mono0926.LicensePlist</string>
+    </dict>
+  </array>
+</dict>
+</plist>`;

package/plugin-utils/src/android.ts

@@ -0,0 +1,99 @@
+import { arrayIncludesObject } from './common';
+
+/**
+ * Applies Gradle Plugin Portal & AboutLibraries Gradle plugin repositories (if needed) inside root build.gradle
+ */
+export function declareAboutLibrariesPluginUtil(androidBuildGradleContent: string) {
+  if (!androidBuildGradleContent.match(PLUGIN_CLASSPATH)?.length) {
+    // Add Gradle Plugin Portal repository if it's not included
+    if (!androidBuildGradleContent.match(GRADLE_PLUGIN_PORTAL_URL)?.length) {
+      androidBuildGradleContent = androidBuildGradleContent.replace(
+        /repositories\s?{/,
+        `repositories {\n        maven { url = uri("${GRADLE_PLUGIN_PORTAL_URL}") }`,
+      );
+      console.log('Gradle Plugin Portal repository - ADDED');
+    } else {
+      console.log('Gradle Plugin Portal repository already added - SKIP');
+    }
+
+    // Declare the AboutLibraries plugin
+    androidBuildGradleContent = androidBuildGradleContent.replace(
+      /dependencies\s?{/,
+      `dependencies {\n        classpath("${PLUGIN_CLASSPATH}:${PLUGIN_VERSION}")`,
+    );
+    console.log('About Libraries Gradle Plugin repository - ADDED');
+  } else {
+    console.log('About Libraries Gradle Plugin already added - SKIP');
+  }
+
+  return androidBuildGradleContent;
+}
+
+/**
+ * Applies and configures AboutLibraries Grale plugin (if needed) inside app's build.gradle
+ */
+export function applyAndConfigureAboutLibrariesPluginUtil(androidAppBuildGradleContent: string) {
+  // Apply plugin
+  const applyPluginBlockRegex = new RegExp(`apply\\s+plugin:\\s+['"]${PLUGIN_APPLY_BLOCK_IDENTIFIER}['"]`);
+
+  if (!androidAppBuildGradleContent.match(applyPluginBlockRegex)?.length) {
+    androidAppBuildGradleContent += `\n${PLUGIN_APPLY_BLOCK}`;
+    console.log('About Libraries Gradle Plugin - APPLIED');
+  } else {
+    console.log('About Libraries Gradle Plugin already applied - SKIP');
+  }
+
+  // Configure plugin
+  const pluginConfigRegex = /aboutLibraries {/;
+
+  if (!androidAppBuildGradleContent.match(pluginConfigRegex)?.length) {
+    androidAppBuildGradleContent += '\n\naboutLibraries {\n    configPath = "config"\n    prettyPrint = true\n}';
+    console.log('About Libraries Gradle Plugin - CONFIGURED');
+  } else {
+    console.log('About Libraries Gradle Plugin already configured - SKIP');
+  }
+
+  return androidAppBuildGradleContent;
+}
+
+/**
+ * adds a list activity to the list of application's activities
+ */
+export function addListActivityUtil<T>(activities: T[]): T[] {
+  const listActivity = prepareListActivity();
+
+  if (!arrayIncludesObject(activities, listActivity)) {
+    activities?.push(listActivity as T);
+    console.log('About Libraries activity - ADDED');
+  } else {
+    console.log('About Libraries activity already added - SKIP');
+  }
+
+  return activities;
+}
+
+/**
+ * This JS object will evaluate to the following XML content:
+ *
+ * <activity
+ *   android:name="com.reactnativelegal.ReactNativeLegalActivity"
+ *   android:exported="false"
+ *   android:launchMode="singleTask"
+ * />
+ */
+function prepareListActivity() {
+  return {
+    $: {
+      'android:name': PLUGIN_ACTIVITY,
+      'android:exported': 'false',
+      'android:launchMode': 'singleTask',
+    },
+  } as const;
+}
+
+const GRADLE_PLUGIN_PORTAL_URL = 'https://plugins.gradle.org/m2';
+const PLUGIN_ACTIVITY = 'com.reactnativelegal.ReactNativeLegalActivity';
+const PLUGIN_APPLY_BLOCK = "apply plugin: 'com.mikepenz.aboutlibraries.plugin'";
+const PLUGIN_APPLY_BLOCK_IDENTIFIER = 'com.mikepenz.aboutlibraries.plugin';
+const PLUGIN_CLASSPATH = 'com.mikepenz.aboutlibraries.plugin:aboutlibraries-plugin';
+const PLUGIN_VERSION = '11.6.3';