mirror of
https://github.com/apache/cordova-android.git
synced 2025-01-19 07:02:51 +08:00
817 lines
34 KiB
JavaScript
817 lines
34 KiB
JavaScript
/**
|
|
Licensed to the Apache Software Foundation (ASF) under one
|
|
or more contributor license agreements. See the NOTICE file
|
|
distributed with this work for additional information
|
|
regarding copyright ownership. The ASF licenses this file
|
|
to you under the Apache License, Version 2.0 (the
|
|
"License"); you may not use this file except in compliance
|
|
with the License. You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing,
|
|
software distributed under the License is distributed on an
|
|
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
KIND, either express or implied. See the License for the
|
|
specific language governing permissions and limitations
|
|
under the License.
|
|
*/
|
|
|
|
var fs = require('fs-extra');
|
|
var path = require('path');
|
|
const nopt = require('nopt');
|
|
const glob = require('fast-glob');
|
|
var events = require('cordova-common').events;
|
|
var AndroidManifest = require('./AndroidManifest');
|
|
var checkReqs = require('./check_reqs');
|
|
var xmlHelpers = require('cordova-common').xmlHelpers;
|
|
var CordovaError = require('cordova-common').CordovaError;
|
|
var ConfigParser = require('cordova-common').ConfigParser;
|
|
var FileUpdater = require('cordova-common').FileUpdater;
|
|
var PlatformJson = require('cordova-common').PlatformJson;
|
|
var PlatformMunger = require('cordova-common').ConfigChanges.PlatformMunger;
|
|
var PluginInfoProvider = require('cordova-common').PluginInfoProvider;
|
|
const utils = require('./utils');
|
|
const gradleConfigDefaults = require('./gradle-config-defaults');
|
|
|
|
const GradlePropertiesParser = require('./config/GradlePropertiesParser');
|
|
|
|
function parseArguments (argv) {
|
|
return nopt({
|
|
// `jvmargs` is a valid option however, we don't actually want to parse it because we want the entire string as is.
|
|
// jvmargs: String
|
|
}, {}, argv || [], 0);
|
|
}
|
|
|
|
module.exports.prepare = function (cordovaProject, options) {
|
|
var self = this;
|
|
|
|
let args = {};
|
|
if (options && options.options) {
|
|
args = parseArguments(options.options.argv);
|
|
}
|
|
|
|
var platformJson = PlatformJson.load(this.locations.root, this.platform);
|
|
var munger = new PlatformMunger(this.platform, this.locations.root, platformJson, new PluginInfoProvider());
|
|
|
|
this._config = updateConfigFilesFrom(cordovaProject.projectConfig, munger, this.locations);
|
|
|
|
// Update Gradle cdv-gradle-config.json
|
|
updateUserProjectGradleConfig(this);
|
|
|
|
// Update Project's Gradle Properties
|
|
updateUserProjectGradlePropertiesConfig(this, args);
|
|
|
|
// Update own www dir with project's www assets and plugins' assets and js-files
|
|
return Promise.resolve(updateWww(cordovaProject, this.locations)).then(function () {
|
|
// update project according to config.xml changes.
|
|
return updateProjectAccordingTo(self._config, self.locations);
|
|
}).then(function () {
|
|
updateIcons(cordovaProject, path.relative(cordovaProject.root, self.locations.res));
|
|
updateSplashes(cordovaProject, path.relative(cordovaProject.root, self.locations.res));
|
|
updateFileResources(cordovaProject, path.relative(cordovaProject.root, self.locations.root));
|
|
}).then(function () {
|
|
events.emit('verbose', 'Prepared android project successfully');
|
|
});
|
|
};
|
|
|
|
/** @param {PlatformApi} project */
|
|
function updateUserProjectGradleConfig (project) {
|
|
// Generate project gradle config
|
|
const projectGradleConfig = {
|
|
...gradleConfigDefaults,
|
|
...getUserGradleConfig(project._config)
|
|
};
|
|
|
|
// Write out changes
|
|
const projectGradleConfigPath = path.join(project.root, 'cdv-gradle-config.json');
|
|
fs.writeJSONSync(projectGradleConfigPath, projectGradleConfig, { spaces: 2 });
|
|
}
|
|
|
|
function getUserGradleConfig (configXml) {
|
|
const configXmlToGradleMapping = [
|
|
{ xmlKey: 'android-minSdkVersion', gradleKey: 'MIN_SDK_VERSION', type: Number },
|
|
{ xmlKey: 'android-maxSdkVersion', gradleKey: 'MAX_SDK_VERSION', type: Number },
|
|
{ xmlKey: 'android-targetSdkVersion', gradleKey: 'SDK_VERSION', type: Number },
|
|
{ xmlKey: 'android-buildToolsVersion', gradleKey: 'BUILD_TOOLS_VERSION', type: String },
|
|
{ xmlKey: 'GradleVersion', gradleKey: 'GRADLE_VERSION', type: String },
|
|
{ xmlKey: 'AndroidGradlePluginVersion', gradleKey: 'AGP_VERSION', type: String },
|
|
{ xmlKey: 'GradlePluginKotlinVersion', gradleKey: 'KOTLIN_VERSION', type: String },
|
|
{ xmlKey: 'AndroidXAppCompatVersion', gradleKey: 'ANDROIDX_APP_COMPAT_VERSION', type: String },
|
|
{ xmlKey: 'AndroidXWebKitVersion', gradleKey: 'ANDROIDX_WEBKIT_VERSION', type: String },
|
|
{ xmlKey: 'GradlePluginGoogleServicesVersion', gradleKey: 'GRADLE_PLUGIN_GOOGLE_SERVICES_VERSION', type: String },
|
|
{ xmlKey: 'GradlePluginGoogleServicesEnabled', gradleKey: 'IS_GRADLE_PLUGIN_GOOGLE_SERVICES_ENABLED', type: Boolean },
|
|
{ xmlKey: 'GradlePluginKotlinEnabled', gradleKey: 'IS_GRADLE_PLUGIN_KOTLIN_ENABLED', type: Boolean }
|
|
];
|
|
|
|
return configXmlToGradleMapping.reduce((config, mapping) => {
|
|
const rawValue = configXml.getPreference(mapping.xmlKey, 'android');
|
|
|
|
// ignore missing preferences (which occur as '')
|
|
if (rawValue) {
|
|
config[mapping.gradleKey] = parseStringAsType(rawValue, mapping.type);
|
|
}
|
|
|
|
return config;
|
|
}, {});
|
|
}
|
|
|
|
/** Converts given string to given type */
|
|
function parseStringAsType (value, type) {
|
|
switch (type) {
|
|
case String:
|
|
return String(value);
|
|
case Number:
|
|
return parseFloat(value);
|
|
case Boolean:
|
|
return value.toLowerCase() === 'true';
|
|
default:
|
|
throw new CordovaError('Invalid type: ' + type);
|
|
}
|
|
}
|
|
|
|
function updateUserProjectGradlePropertiesConfig (project, args) {
|
|
const gradlePropertiesUserConfig = {};
|
|
|
|
// Get the min SDK version from config.xml
|
|
if (args.jvmargs) gradlePropertiesUserConfig['org.gradle.jvmargs'] = args.jvmargs;
|
|
|
|
const isGradlePluginKotlinEnabled = project._config.getPreference('GradlePluginKotlinEnabled', 'android');
|
|
if (isGradlePluginKotlinEnabled) {
|
|
const gradlePluginKotlinCodeStyle = project._config.getPreference('GradlePluginKotlinCodeStyle', 'android');
|
|
gradlePropertiesUserConfig['kotlin.code.style'] = gradlePluginKotlinCodeStyle || 'official';
|
|
}
|
|
|
|
const gradlePropertiesParser = new GradlePropertiesParser(project.root);
|
|
gradlePropertiesParser.configure(gradlePropertiesUserConfig);
|
|
}
|
|
|
|
module.exports.clean = function (options) {
|
|
// A cordovaProject isn't passed into the clean() function, because it might have
|
|
// been called from the platform shell script rather than the CLI. Check for the
|
|
// noPrepare option passed in by the non-CLI clean script. If that's present, or if
|
|
// there's no config.xml found at the project root, then don't clean prepared files.
|
|
var projectRoot = path.resolve(this.root, '../..');
|
|
if ((options && options.noPrepare) || !fs.existsSync(this.locations.configXml) ||
|
|
!fs.existsSync(this.locations.configXml)) {
|
|
return Promise.resolve();
|
|
}
|
|
|
|
var projectConfig = new ConfigParser(this.locations.configXml);
|
|
|
|
var self = this;
|
|
return Promise.resolve().then(function () {
|
|
cleanWww(projectRoot, self.locations);
|
|
cleanIcons(projectRoot, projectConfig, path.relative(projectRoot, self.locations.res));
|
|
cleanSplashes(projectRoot, projectConfig, path.relative(projectRoot, self.locations.res));
|
|
cleanFileResources(projectRoot, projectConfig, path.relative(projectRoot, self.locations.root));
|
|
});
|
|
};
|
|
|
|
/**
|
|
* Updates config files in project based on app's config.xml and config munge,
|
|
* generated by plugins.
|
|
*
|
|
* @param {ConfigParser} sourceConfig A project's configuration that will
|
|
* be merged into platform's config.xml
|
|
* @param {ConfigChanges} configMunger An initialized ConfigChanges instance
|
|
* for this platform.
|
|
* @param {Object} locations A map of locations for this platform
|
|
*
|
|
* @return {ConfigParser} An instance of ConfigParser, that
|
|
* represents current project's configuration. When returned, the
|
|
* configuration is already dumped to appropriate config.xml file.
|
|
*/
|
|
function updateConfigFilesFrom (sourceConfig, configMunger, locations) {
|
|
events.emit('verbose', 'Generating platform-specific config.xml from defaults for android at ' + locations.configXml);
|
|
|
|
// First cleanup current config and merge project's one into own
|
|
// Overwrite platform config.xml with defaults.xml.
|
|
fs.copySync(locations.defaultConfigXml, locations.configXml);
|
|
|
|
// Then apply config changes from global munge to all config files
|
|
// in project (including project's config)
|
|
configMunger.reapply_global_munge().save_all();
|
|
|
|
events.emit('verbose', 'Merging project\'s config.xml into platform-specific android config.xml');
|
|
// Merge changes from app's config.xml into platform's one
|
|
var config = new ConfigParser(locations.configXml);
|
|
xmlHelpers.mergeXml(sourceConfig.doc.getroot(),
|
|
config.doc.getroot(), 'android', /* clobber= */true);
|
|
|
|
config.write();
|
|
return config;
|
|
}
|
|
|
|
/**
|
|
* Logs all file operations via the verbose event stream, indented.
|
|
*/
|
|
function logFileOp (message) {
|
|
events.emit('verbose', ' ' + message);
|
|
}
|
|
|
|
/**
|
|
* Updates platform 'www' directory by replacing it with contents of
|
|
* 'platform_www' and app www. Also copies project's overrides' folder into
|
|
* the platform 'www' folder
|
|
*
|
|
* @param {Object} cordovaProject An object which describes cordova project.
|
|
* @param {Object} destinations An object that contains destination
|
|
* paths for www files.
|
|
*/
|
|
function updateWww (cordovaProject, destinations) {
|
|
var sourceDirs = [
|
|
path.relative(cordovaProject.root, cordovaProject.locations.www),
|
|
path.relative(cordovaProject.root, destinations.platformWww)
|
|
];
|
|
|
|
// If project contains 'merges' for our platform, use them as another overrides
|
|
var merges_path = path.join(cordovaProject.root, 'merges', 'android');
|
|
if (fs.existsSync(merges_path)) {
|
|
events.emit('verbose', 'Found "merges/android" folder. Copying its contents into the android project.');
|
|
sourceDirs.push(path.join('merges', 'android'));
|
|
}
|
|
|
|
var targetDir = path.relative(cordovaProject.root, destinations.www);
|
|
events.emit(
|
|
'verbose', 'Merging and updating files from [' + sourceDirs.join(', ') + '] to ' + targetDir);
|
|
FileUpdater.mergeAndUpdateDir(
|
|
sourceDirs, targetDir, { rootDir: cordovaProject.root }, logFileOp);
|
|
}
|
|
|
|
/**
|
|
* Cleans all files from the platform 'www' directory.
|
|
*/
|
|
function cleanWww (projectRoot, locations) {
|
|
var targetDir = path.relative(projectRoot, locations.www);
|
|
events.emit('verbose', 'Cleaning ' + targetDir);
|
|
|
|
// No source paths are specified, so mergeAndUpdateDir() will clear the target directory.
|
|
FileUpdater.mergeAndUpdateDir(
|
|
[], targetDir, { rootDir: projectRoot, all: true }, logFileOp);
|
|
}
|
|
|
|
/**
|
|
* Updates project structure and AndroidManifest according to project's configuration.
|
|
*
|
|
* @param {ConfigParser} platformConfig A project's configuration that will
|
|
* be used to update project
|
|
* @param {Object} locations A map of locations for this platform
|
|
*/
|
|
function updateProjectAccordingTo (platformConfig, locations) {
|
|
// Update app name by editing res/values/strings.xml
|
|
var strings = xmlHelpers.parseElementtreeSync(locations.strings);
|
|
|
|
var name = platformConfig.name();
|
|
strings.find('string[@name="app_name"]').text = name.replace(/'/g, '\\\'');
|
|
|
|
var shortName = platformConfig.shortName && platformConfig.shortName();
|
|
if (shortName && shortName !== name) {
|
|
strings.find('string[@name="launcher_name"]').text = shortName.replace(/'/g, '\\\'');
|
|
}
|
|
|
|
fs.writeFileSync(locations.strings, strings.write({ indent: 4 }), 'utf-8');
|
|
events.emit('verbose', 'Wrote out android application name "' + name + '" to ' + locations.strings);
|
|
|
|
// Java packages cannot support dashes
|
|
var androidPkgName = (platformConfig.android_packageName() || platformConfig.packageName()).replace(/-/g, '_');
|
|
|
|
var manifest = new AndroidManifest(locations.manifest);
|
|
var manifestId = manifest.getPackageId();
|
|
|
|
manifest.getActivity()
|
|
.setOrientation(platformConfig.getPreference('orientation'))
|
|
.setLaunchMode(findAndroidLaunchModePreference(platformConfig));
|
|
|
|
manifest.setVersionName(platformConfig.version())
|
|
.setVersionCode(platformConfig.android_versionCode() || default_versionCode(platformConfig.version()))
|
|
.setPackageId(androidPkgName)
|
|
.write();
|
|
|
|
// Java file paths shouldn't be hard coded
|
|
const javaDirectory = path.join(locations.javaSrc, manifestId.replace(/\./g, '/'));
|
|
const java_files = glob.sync('**/*.java', { cwd: javaDirectory, absolute: true }).filter(f => {
|
|
const contents = fs.readFileSync(f, 'utf-8');
|
|
return /extends\s+CordovaActivity/.test(contents);
|
|
});
|
|
|
|
if (java_files.length === 0) {
|
|
throw new CordovaError('No Java files found that extend CordovaActivity.');
|
|
} else if (java_files.length > 1) {
|
|
events.emit('log', 'Multiple candidate Java files that extend CordovaActivity found. Guessing at the first one, ' + java_files[0]);
|
|
}
|
|
|
|
const destFile = java_files[0];
|
|
|
|
// var destFile = path.join(locations.root, 'app', 'src', 'main', 'java', androidPkgName.replace(/\./g, '/'), path.basename(java_files[0]));
|
|
// fs.ensureDirSync(path.dirname(destFile));
|
|
// events.emit('verbose', java_files[0]);
|
|
// events.emit('verbose', destFile);
|
|
// console.log(locations);
|
|
// fs.copySync(java_files[0], destFile);
|
|
utils.replaceFileContents(destFile, /package [\w.]*;/, 'package ' + androidPkgName + ';');
|
|
events.emit('verbose', 'Wrote out Android package name "' + androidPkgName + '" to ' + destFile);
|
|
|
|
var removeOrigPkg = checkReqs.isWindows() || checkReqs.isDarwin()
|
|
? manifestId.toUpperCase() !== androidPkgName.toUpperCase()
|
|
: manifestId !== androidPkgName;
|
|
|
|
if (removeOrigPkg) {
|
|
// If package was name changed we need to remove old java with main activity
|
|
fs.removeSync(java_files[0]);
|
|
// remove any empty directories
|
|
var currentDir = path.dirname(java_files[0]);
|
|
var sourcesRoot = path.resolve(locations.root, 'src');
|
|
while (currentDir !== sourcesRoot) {
|
|
if (fs.existsSync(currentDir) && fs.readdirSync(currentDir).length === 0) {
|
|
fs.rmdirSync(currentDir);
|
|
currentDir = path.resolve(currentDir, '..');
|
|
} else {
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
// Consturct the default value for versionCode as
|
|
// PATCH + MINOR * 100 + MAJOR * 10000
|
|
// see http://developer.android.com/tools/publishing/versioning.html
|
|
function default_versionCode (version) {
|
|
var nums = version.split('-')[0].split('.');
|
|
var versionCode = 0;
|
|
if (+nums[0]) {
|
|
versionCode += +nums[0] * 10000;
|
|
}
|
|
if (+nums[1]) {
|
|
versionCode += +nums[1] * 100;
|
|
}
|
|
if (+nums[2]) {
|
|
versionCode += +nums[2];
|
|
}
|
|
|
|
events.emit('verbose', 'android-versionCode not found in config.xml. Generating a code based on version in config.xml (' + version + '): ' + versionCode);
|
|
return versionCode;
|
|
}
|
|
|
|
function getImageResourcePath (resourcesDir, type, density, name, sourceName) {
|
|
// Use same extension as source with special case for 9-Patch files
|
|
const ext = sourceName.endsWith('.9.png')
|
|
? '.9.png' : path.extname(sourceName).toLowerCase();
|
|
|
|
const subDir = density ? `${type}-${density}` : type;
|
|
return path.join(resourcesDir, subDir, name + ext);
|
|
}
|
|
|
|
function getAdaptiveImageResourcePath (resourcesDir, type, density, name, sourceName) {
|
|
if (/\.9\.png$/.test(sourceName)) {
|
|
name = name.replace(/\.png$/, '.9.png');
|
|
}
|
|
var resourcePath = path.join(resourcesDir, (density ? type + '-' + density + '-v26' : type), name);
|
|
return resourcePath;
|
|
}
|
|
|
|
function makeSplashCleanupMap (projectRoot, resourcesDir) {
|
|
// Build an initial resource map that deletes all existing splash screens
|
|
const existingSplashPaths = glob.sync(
|
|
`${resourcesDir.replace(/\\/g, '/')}/drawable-*/screen.{png,9.png,webp,jpg,jpeg}`,
|
|
{ cwd: projectRoot }
|
|
);
|
|
return makeCleanResourceMap(existingSplashPaths);
|
|
}
|
|
|
|
function updateSplashes (cordovaProject, platformResourcesDir) {
|
|
var resources = cordovaProject.projectConfig.getSplashScreens('android');
|
|
|
|
// if there are no "splash" elements in config.xml
|
|
if (resources.length === 0) {
|
|
events.emit('verbose', 'This app does not have splash screens defined');
|
|
// We must not return here!
|
|
// If the user defines no splash screens, the cleanup map will cause any
|
|
// existing splash screen images (e.g. the defaults that we copy into a
|
|
// new app) to be removed from the app folder, which is what we want.
|
|
}
|
|
|
|
// Build an initial resource map that deletes all existing splash screens
|
|
const resourceMap = makeSplashCleanupMap(cordovaProject.root, platformResourcesDir);
|
|
|
|
var hadMdpi = false;
|
|
resources.forEach(function (resource) {
|
|
if (!resource.density) {
|
|
return;
|
|
}
|
|
if (resource.density === 'mdpi') {
|
|
hadMdpi = true;
|
|
}
|
|
var targetPath = getImageResourcePath(
|
|
platformResourcesDir, 'drawable', resource.density, 'screen', path.basename(resource.src));
|
|
resourceMap[targetPath] = resource.src;
|
|
});
|
|
|
|
// There's no "default" drawable, so assume default == mdpi.
|
|
if (!hadMdpi && resources.defaultResource) {
|
|
var targetPath = getImageResourcePath(
|
|
platformResourcesDir, 'drawable', 'mdpi', 'screen', path.basename(resources.defaultResource.src));
|
|
resourceMap[targetPath] = resources.defaultResource.src;
|
|
}
|
|
|
|
events.emit('verbose', 'Updating splash screens at ' + platformResourcesDir);
|
|
FileUpdater.updatePaths(
|
|
resourceMap, { rootDir: cordovaProject.root }, logFileOp);
|
|
}
|
|
|
|
function cleanSplashes (projectRoot, projectConfig, platformResourcesDir) {
|
|
var resources = projectConfig.getSplashScreens('android');
|
|
if (resources.length > 0) {
|
|
const resourceMap = makeSplashCleanupMap(projectRoot, platformResourcesDir);
|
|
|
|
events.emit('verbose', 'Cleaning splash screens at ' + platformResourcesDir);
|
|
|
|
// No source paths are specified in the map, so updatePaths() will delete the target files.
|
|
FileUpdater.updatePaths(
|
|
resourceMap, { rootDir: projectRoot, all: true }, logFileOp);
|
|
}
|
|
}
|
|
|
|
function updateIcons (cordovaProject, platformResourcesDir) {
|
|
const icons = cordovaProject.projectConfig.getIcons('android');
|
|
|
|
// Skip if there are no app defined icons in config.xml
|
|
if (icons.length === 0) {
|
|
events.emit('verbose', 'This app does not have launcher icons defined');
|
|
return;
|
|
}
|
|
|
|
// 1. loop icons determin if there is an error in the setup.
|
|
// 2. during initial loop, also setup for legacy support.
|
|
const errorMissingAttributes = [];
|
|
const errorLegacyIconNeeded = [];
|
|
let hasAdaptive = false;
|
|
icons.forEach((icon, key) => {
|
|
if (
|
|
(icon.background && !icon.foreground) ||
|
|
(!icon.background && icon.foreground) ||
|
|
(!icon.background && !icon.foreground && !icon.src)
|
|
) {
|
|
errorMissingAttributes.push(icon.density ? icon.density : 'size=' + (icon.height || icon.width));
|
|
}
|
|
|
|
if (icon.foreground) {
|
|
hasAdaptive = true;
|
|
|
|
if (
|
|
!icon.src &&
|
|
(
|
|
icon.foreground.startsWith('@color') ||
|
|
path.extname(path.basename(icon.foreground)) === '.xml'
|
|
)
|
|
) {
|
|
errorLegacyIconNeeded.push(icon.density ? icon.density : 'size=' + (icon.height || icon.width));
|
|
} else if (!icon.src) {
|
|
icons[key].src = icon.foreground;
|
|
}
|
|
}
|
|
});
|
|
|
|
const errorMessage = [];
|
|
if (errorMissingAttributes.length > 0) {
|
|
errorMessage.push('One of the following attributes are set but missing the other for the density type: ' + errorMissingAttributes.join(', ') + '. Please ensure that all require attributes are defined.');
|
|
}
|
|
|
|
if (errorLegacyIconNeeded.length > 0) {
|
|
errorMessage.push('For the following icons with the density of: ' + errorLegacyIconNeeded.join(', ') + ', adaptive foreground with a defined color or vector can not be used as a standard fallback icon for older Android devices. To support older Android environments, please provide a value for the src attribute.');
|
|
}
|
|
|
|
if (errorMessage.length > 0) {
|
|
throw new CordovaError(errorMessage.join(' '));
|
|
}
|
|
|
|
let resourceMap = Object.assign(
|
|
{},
|
|
mapImageResources(cordovaProject.root, platformResourcesDir, 'mipmap', 'ic_launcher.png'),
|
|
mapImageResources(cordovaProject.root, platformResourcesDir, 'mipmap', 'ic_launcher_foreground.png'),
|
|
mapImageResources(cordovaProject.root, platformResourcesDir, 'mipmap', 'ic_launcher_background.png'),
|
|
mapImageResources(cordovaProject.root, platformResourcesDir, 'mipmap', 'ic_launcher_foreground.xml'),
|
|
mapImageResources(cordovaProject.root, platformResourcesDir, 'mipmap', 'ic_launcher_background.xml'),
|
|
mapImageResources(cordovaProject.root, platformResourcesDir, 'mipmap', 'ic_launcher.xml')
|
|
);
|
|
|
|
const preparedIcons = prepareIcons(icons);
|
|
|
|
if (hasAdaptive) {
|
|
resourceMap = updateIconResourceForAdaptive(preparedIcons, resourceMap, platformResourcesDir);
|
|
}
|
|
|
|
resourceMap = updateIconResourceForLegacy(preparedIcons, resourceMap, platformResourcesDir);
|
|
|
|
events.emit('verbose', 'Updating icons at ' + platformResourcesDir);
|
|
FileUpdater.updatePaths(resourceMap, { rootDir: cordovaProject.root }, logFileOp);
|
|
}
|
|
|
|
function updateIconResourceForAdaptive (preparedIcons, resourceMap, platformResourcesDir) {
|
|
const android_icons = preparedIcons.android_icons;
|
|
const default_icon = preparedIcons.default_icon;
|
|
|
|
// The source paths for icons and splashes are relative to
|
|
// project's config.xml location, so we use it as base path.
|
|
let background;
|
|
let foreground;
|
|
let targetPathBackground;
|
|
let targetPathForeground;
|
|
|
|
for (const density in android_icons) {
|
|
let backgroundVal = '@mipmap/ic_launcher_background';
|
|
let foregroundVal = '@mipmap/ic_launcher_foreground';
|
|
|
|
background = android_icons[density].background;
|
|
foreground = android_icons[density].foreground;
|
|
|
|
if (!background || !foreground) {
|
|
// This icon isn't an adaptive icon, so skip it
|
|
continue;
|
|
}
|
|
|
|
if (background.startsWith('@color')) {
|
|
// Colors Use Case
|
|
backgroundVal = background; // Example: @color/background_foobar_1
|
|
} else if (path.extname(path.basename(background)) === '.xml') {
|
|
// Vector Use Case
|
|
targetPathBackground = getAdaptiveImageResourcePath(platformResourcesDir, 'mipmap', density, 'ic_launcher_background.xml', path.basename(android_icons[density].background));
|
|
resourceMap[targetPathBackground] = android_icons[density].background;
|
|
} else if (path.extname(path.basename(background)) === '.png') {
|
|
// Images Use Case
|
|
targetPathBackground = getAdaptiveImageResourcePath(platformResourcesDir, 'mipmap', density, 'ic_launcher_background.png', path.basename(android_icons[density].background));
|
|
resourceMap[targetPathBackground] = android_icons[density].background;
|
|
}
|
|
|
|
if (foreground.startsWith('@color')) {
|
|
// Colors Use Case
|
|
foregroundVal = foreground;
|
|
} else if (path.extname(path.basename(foreground)) === '.xml') {
|
|
// Vector Use Case
|
|
targetPathForeground = getAdaptiveImageResourcePath(platformResourcesDir, 'mipmap', density, 'ic_launcher_foreground.xml', path.basename(android_icons[density].foreground));
|
|
resourceMap[targetPathForeground] = android_icons[density].foreground;
|
|
} else if (path.extname(path.basename(foreground)) === '.png') {
|
|
// Images Use Case
|
|
targetPathForeground = getAdaptiveImageResourcePath(platformResourcesDir, 'mipmap', density, 'ic_launcher_foreground.png', path.basename(android_icons[density].foreground));
|
|
resourceMap[targetPathForeground] = android_icons[density].foreground;
|
|
}
|
|
|
|
// create an XML for DPI and set color
|
|
const icLauncherTemplate = `<?xml version="1.0" encoding="utf-8"?>
|
|
<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
|
|
<background android:drawable="` + backgroundVal + `" />
|
|
<foreground android:drawable="` + foregroundVal + `" />
|
|
</adaptive-icon>`;
|
|
|
|
const launcherXmlPath = path.join(platformResourcesDir, 'mipmap-' + density + '-v26', 'ic_launcher.xml');
|
|
|
|
// Remove the XML from the resourceMap so the file does not get removed.
|
|
delete resourceMap[launcherXmlPath];
|
|
|
|
fs.writeFileSync(path.resolve(launcherXmlPath), icLauncherTemplate);
|
|
}
|
|
|
|
// There's no "default" drawable, so assume default == mdpi.
|
|
if (default_icon && !android_icons.mdpi) {
|
|
let defaultTargetPathBackground;
|
|
let defaultTargetPathForeground;
|
|
|
|
if (background.startsWith('@color')) {
|
|
// Colors Use Case
|
|
targetPathBackground = default_icon.background;
|
|
} else if (path.extname(path.basename(background)) === '.xml') {
|
|
// Vector Use Case
|
|
defaultTargetPathBackground = getAdaptiveImageResourcePath(platformResourcesDir, 'mipmap', 'mdpi', 'ic_launcher_background.xml', path.basename(default_icon.background));
|
|
resourceMap[defaultTargetPathBackground] = default_icon.background;
|
|
} else if (path.extname(path.basename(background)) === '.png') {
|
|
// Images Use Case
|
|
defaultTargetPathBackground = getAdaptiveImageResourcePath(platformResourcesDir, 'mipmap', 'mdpi', 'ic_launcher_background.png', path.basename(default_icon.background));
|
|
resourceMap[defaultTargetPathBackground] = default_icon.background;
|
|
}
|
|
|
|
if (foreground.startsWith('@color')) {
|
|
// Colors Use Case
|
|
targetPathForeground = default_icon.foreground;
|
|
} else if (path.extname(path.basename(foreground)) === '.xml') {
|
|
// Vector Use Case
|
|
defaultTargetPathForeground = getAdaptiveImageResourcePath(platformResourcesDir, 'mipmap', 'mdpi', 'ic_launcher_foreground.xml', path.basename(default_icon.foreground));
|
|
resourceMap[defaultTargetPathForeground] = default_icon.foreground;
|
|
} else if (path.extname(path.basename(foreground)) === '.png') {
|
|
// Images Use Case
|
|
defaultTargetPathForeground = getAdaptiveImageResourcePath(platformResourcesDir, 'mipmap', 'mdpi', 'ic_launcher_foreground.png', path.basename(default_icon.foreground));
|
|
resourceMap[defaultTargetPathForeground] = default_icon.foreground;
|
|
}
|
|
}
|
|
|
|
return resourceMap;
|
|
}
|
|
|
|
function updateIconResourceForLegacy (preparedIcons, resourceMap, platformResourcesDir) {
|
|
const android_icons = preparedIcons.android_icons;
|
|
const default_icon = preparedIcons.default_icon;
|
|
|
|
// The source paths for icons and splashes are relative to
|
|
// project's config.xml location, so we use it as base path.
|
|
for (var density in android_icons) {
|
|
var targetPath = getImageResourcePath(platformResourcesDir, 'mipmap', density, 'ic_launcher', path.basename(android_icons[density].src));
|
|
resourceMap[targetPath] = android_icons[density].src;
|
|
}
|
|
|
|
// There's no "default" drawable, so assume default == mdpi.
|
|
if (default_icon && !android_icons.mdpi) {
|
|
var defaultTargetPath = getImageResourcePath(platformResourcesDir, 'mipmap', 'mdpi', 'ic_launcher', path.basename(default_icon.src));
|
|
resourceMap[defaultTargetPath] = default_icon.src;
|
|
}
|
|
|
|
return resourceMap;
|
|
}
|
|
|
|
function prepareIcons (icons) {
|
|
// http://developer.android.com/design/style/iconography.html
|
|
const SIZE_TO_DENSITY_MAP = {
|
|
36: 'ldpi',
|
|
48: 'mdpi',
|
|
72: 'hdpi',
|
|
96: 'xhdpi',
|
|
144: 'xxhdpi',
|
|
192: 'xxxhdpi'
|
|
};
|
|
|
|
const android_icons = {};
|
|
let default_icon;
|
|
|
|
// find the best matching icon for a given density or size
|
|
// @output android_icons
|
|
var parseIcon = function (icon, icon_size) {
|
|
// do I have a platform icon for that density already
|
|
var density = icon.density || SIZE_TO_DENSITY_MAP[icon_size];
|
|
if (!density) {
|
|
// invalid icon defition ( or unsupported size)
|
|
return;
|
|
}
|
|
var previous = android_icons[density];
|
|
if (previous && previous.platform) {
|
|
return;
|
|
}
|
|
android_icons[density] = icon;
|
|
};
|
|
|
|
// iterate over all icon elements to find the default icon and call parseIcon
|
|
for (var i = 0; i < icons.length; i++) {
|
|
var icon = icons[i];
|
|
var size = icon.width;
|
|
|
|
if (!size) {
|
|
size = icon.height;
|
|
}
|
|
|
|
if (!size && !icon.density) {
|
|
if (default_icon) {
|
|
const found = {};
|
|
const favor = {};
|
|
|
|
// populating found icon.
|
|
if (icon.background && icon.foreground) {
|
|
found.background = icon.background;
|
|
found.foreground = icon.foreground;
|
|
}
|
|
if (icon.src) {
|
|
found.src = icon.src;
|
|
}
|
|
|
|
if (default_icon.background && default_icon.foreground) {
|
|
favor.background = default_icon.background;
|
|
favor.foreground = default_icon.foreground;
|
|
}
|
|
if (default_icon.src) {
|
|
favor.src = default_icon.src;
|
|
}
|
|
|
|
events.emit('verbose', 'Found extra default icon: ' + JSON.stringify(found) + ' and ignoring in favor of ' + JSON.stringify(favor) + '.');
|
|
} else {
|
|
default_icon = icon;
|
|
}
|
|
} else {
|
|
parseIcon(icon, size);
|
|
}
|
|
}
|
|
|
|
return {
|
|
android_icons: android_icons,
|
|
default_icon: default_icon
|
|
};
|
|
}
|
|
|
|
function cleanIcons (projectRoot, projectConfig, platformResourcesDir) {
|
|
var icons = projectConfig.getIcons('android');
|
|
|
|
// Skip if there are no app defined icons in config.xml
|
|
if (icons.length === 0) {
|
|
events.emit('verbose', 'This app does not have launcher icons defined');
|
|
return;
|
|
}
|
|
|
|
const resourceMap = Object.assign(
|
|
{},
|
|
mapImageResources(projectRoot, platformResourcesDir, 'mipmap', 'ic_launcher.png'),
|
|
mapImageResources(projectRoot, platformResourcesDir, 'mipmap', 'ic_launcher_foreground.png'),
|
|
mapImageResources(projectRoot, platformResourcesDir, 'mipmap', 'ic_launcher_background.png'),
|
|
mapImageResources(projectRoot, platformResourcesDir, 'mipmap', 'ic_launcher_foreground.xml'),
|
|
mapImageResources(projectRoot, platformResourcesDir, 'mipmap', 'ic_launcher_background.xml'),
|
|
mapImageResources(projectRoot, platformResourcesDir, 'mipmap', 'ic_launcher.xml')
|
|
);
|
|
|
|
events.emit('verbose', 'Cleaning icons at ' + platformResourcesDir);
|
|
|
|
// No source paths are specified in the map, so updatePaths() will delete the target files.
|
|
FileUpdater.updatePaths(resourceMap, { rootDir: projectRoot, all: true }, logFileOp);
|
|
}
|
|
|
|
/**
|
|
* Gets a map containing resources of a specified name from all drawable folders in a directory.
|
|
*/
|
|
function mapImageResources (rootDir, subDir, type, resourceName) {
|
|
const pathMap = {};
|
|
const globOptions = { cwd: path.join(rootDir, subDir), onlyDirectories: true };
|
|
glob.sync(type + '-*', globOptions).forEach(drawableFolder => {
|
|
const imagePath = path.join(subDir, drawableFolder, resourceName);
|
|
pathMap[imagePath] = null;
|
|
});
|
|
return pathMap;
|
|
}
|
|
|
|
/** Returns resource map that deletes all given paths */
|
|
function makeCleanResourceMap (resourcePaths) {
|
|
const pathMap = {};
|
|
resourcePaths.map(path.normalize)
|
|
.forEach(resourcePath => {
|
|
pathMap[resourcePath] = null;
|
|
});
|
|
return pathMap;
|
|
}
|
|
|
|
function updateFileResources (cordovaProject, platformDir) {
|
|
var files = cordovaProject.projectConfig.getFileResources('android');
|
|
|
|
// if there are resource-file elements in config.xml
|
|
if (files.length === 0) {
|
|
events.emit('verbose', 'This app does not have additional resource files defined');
|
|
return;
|
|
}
|
|
|
|
var resourceMap = {};
|
|
files.forEach(function (res) {
|
|
var targetPath = path.join(platformDir, res.target);
|
|
resourceMap[targetPath] = res.src;
|
|
});
|
|
|
|
events.emit('verbose', 'Updating resource files at ' + platformDir);
|
|
FileUpdater.updatePaths(
|
|
resourceMap, { rootDir: cordovaProject.root }, logFileOp);
|
|
}
|
|
|
|
function cleanFileResources (projectRoot, projectConfig, platformDir) {
|
|
var files = projectConfig.getFileResources('android', true);
|
|
if (files.length > 0) {
|
|
events.emit('verbose', 'Cleaning resource files at ' + platformDir);
|
|
|
|
var resourceMap = {};
|
|
files.forEach(function (res) {
|
|
var filePath = path.join(platformDir, res.target);
|
|
resourceMap[filePath] = null;
|
|
});
|
|
|
|
FileUpdater.updatePaths(
|
|
resourceMap, { rootDir: projectRoot, all: true }, logFileOp);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Gets and validates 'AndroidLaunchMode' prepference from config.xml. Returns
|
|
* preference value and warns if it doesn't seems to be valid
|
|
*
|
|
* @param {ConfigParser} platformConfig A configParser instance for
|
|
* platform.
|
|
*
|
|
* @return {String} Preference's value from config.xml or
|
|
* default value, if there is no such preference. The default value is
|
|
* 'singleTop'
|
|
*/
|
|
function findAndroidLaunchModePreference (platformConfig) {
|
|
var launchMode = platformConfig.getPreference('AndroidLaunchMode');
|
|
if (!launchMode) {
|
|
// Return a default value
|
|
return 'singleTop';
|
|
}
|
|
|
|
var expectedValues = ['standard', 'singleTop', 'singleTask', 'singleInstance'];
|
|
var valid = expectedValues.indexOf(launchMode) >= 0;
|
|
if (!valid) {
|
|
// Note: warn, but leave the launch mode as developer wanted, in case the list of options changes in the future
|
|
events.emit('warn', 'Unrecognized value for AndroidLaunchMode preference: ' +
|
|
launchMode + '. Expected values are: ' + expectedValues.join(', '));
|
|
}
|
|
|
|
return launchMode;
|
|
}
|