repository·master·Indexed 43 days ago
https://github.com/apache/cordova-docsSource code and build configuration for the official Apache Cordova website (cordova.apache.org). Includes guidelines for contributing to the documentation and blog, Jekyll configuration, Gulp build processes, and deployment workflows via Travis CI and SVN.
This repository hosts the source code for the official Cordova website (cordova.apache.org). The site is structured as a static site generated using Jekyll.
Key components include:
/www./www/docs./www/blog./www/plugins.Note that some content is dynamically pulled in during the build process.
The cordova-common package version 2.1.0 introduced several improvements to configuration parsing and attribute handling:
<config-file> Support: Added support for the <config-file> tag within config.xml.allows-arbitrary-loads-for-media attribute when using getAccesses.framework tag.JSON output to use 2 spaces for indentation.The 7.0.0 release includes several significant updates and breaking changes:
CordovaInterface now includes a Context getter, allowing contexts to be retrieved without an Activity.x86_64, arm64, and armeabi architectures when building plugins using the NDK.The BlackBerry 3.8.0 release includes the following improvements:
blackberry10 platform on any workstation OS.http://localhost:8472 in the Content-Security-Policy header.www/ directory.parseUri handling complex URLs and exception logging in packager.js.A Cordova project created via the CLI follows a specific directory structure. Understanding these directories is critical for managing assets, configuration, and version control.
myapp/
├── config.xml
├── node_modules/
├── package.json
├── platforms/
├── plugins/
└── wwwwww/: The primary location for your web assets (HTML, CSS, JavaScript, images). Always edit files here. These files are automatically copied to each platform's directory during cordova prepare.config.xml: The main configuration file for your application. Use this to define preferences and customize project behavior.package.json: A manifest of your project's JavaScript dependencies (Cordova, platforms, and plugins) and plugin variable values.platforms/: Contains the source code and build scripts for added platforms (e.g., Android, iOS). Warning: Do not edit files here directly; they are routinely overwritten by the CLI.plugins/: A staging area where installed plugins are copied before being applied to platforms. Do not commit this to version control.node_modules/: Contains npm dependency packages for Cordova and your project. This is the unedited source of truth; do not edit files here.myapp/
├── config.xml
├── node_modules/
├── package.json
├── platforms/
├── plugins/
└── wwwThe Cordova Docs website uses Jekyll for its build process. Configuration is managed through several YAML files located in the conf/ directory. The specific configuration applied depends on the command used to trigger the build (e.g., gulp build or gulp serve).
These files are present in the repository after checkout:
_config.yml: The primary Jekyll configuration file._version.yml: Defines the latest version of the documentation._dev.yml: Used for default/development builds._prod.yml: Applied when the --prod option is used during the build._nodocs.yml: Applied when the --nodocs option is used during the build._defaults.yml: This file is generated by the build process and defines specific configuration values for different sections of the documentation.The cordova-common 3.0.0 release introduced several significant updates to platform handling and utility methods:
PluginInfo.getPodSpecs method.ConfigParser to support Adaptive Icons.Resolve Config Path for OSX.config_munge within ios.json and android.json.plist_helpers and implemented cross-spawn for platform-independent process spawning.cordova-registry-mapper dependency.The Android platform in Cordova 3.6 introduced several key features and fixes:
BUILD_MULTIPLE_APKS environment variable to allow splitting APKs based on architecture.external-launch-whitelist for filtering intent launches.iframe and GoogleMaps.// characters.exec() is now restricted to file: or the starting URL's domain.android_sdk_version.js error messages, and setNativeToJsBridgeMode crashes.Cordova 3.3.0 introduced initial support for the following platforms:
The cordova-common 3.2.0 release introduced several utility improvements for Cordova tooling, specifically focusing on configuration management and process handling:
setPreference and setPlatformPreference for managing configuration settings.superspawn by catching leaked exceptions and converting them into rejections, ensuring more predictable asynchronous behavior.plist document indentation issues.fs-extra to v8.The cordova-ios 4.0.0 release introduced several significant changes and improvements:
.pbxproj to .xcconfig files and implemented cordova/build*.xcconfig support for better IDE integration.AppDelegate (like handleOpenURL and push notification delegates) have been moved to dedicated plugins.<allow-navigation> and <allow-intent> tags.PlatformApi for iOS.ios-sim updated to 5.0.3ios-deploy updated to 1.7.0xcodebuild updated to 6.0.0CDVWhiteList, and deployment issues with Unicode characters in display names.The cordova-electron platform provides the following capabilities for building desktop applications:
electron-builder@^20.38.4 to support Linux, macOS, and Windows, including signing for macOS and Windows.run command for app previewing.