[
{
"path": ".gitignore",
"content": "# Logs\nlogs\n*.log\n\nwww/*\nplatforms/ios/www/*\n\n# Runtime data\npids\n*.pid\n*.seed\n\n# Directory for instrumented libs generated by jscoverage/JSCover\nlib-cov\n\n# Coverage directory used by tools like istanbul\ncoverage\n\n# Common\n.DS_Store\nbuild\n\n# Node.js\nnode_modules\n\n# Xcode\n*.mode1v3\n*.mode2v3\n*.perspectivev3\n*.pbxuser\n*.hmap\n*.ipa\n*.xcuserstate\n*.xccheckout\n*.moved-aside\n*.perspectivev3\nxcuserdata\nDerivedData\n\n# Android\nbuild.xml\nlocal.properties\ngradlew\ngradlew.bat\ngradle\nant-build\nant-gen\ngen\nout\nsrc/js/stores/secret.json\n"
},
{
"path": "LICENSE",
"content": "The MIT License (MIT)\n\nCopyright (c) 2015 Thinkmill\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n"
},
{
"path": "README.md",
"content": "# ReactEU Mobile App\n\nReactEurope Mobile App, built with [TouchstoneJS](http://touchstonejs.io)\n\nFull Instructions and documentation coming as soon as we can publish them after the conference :)\n\n### Instructions\n\nBuild/run in the browser\n\n``` bash\ngit clone git@github.com:Thinkmill/reacteu-app.git\ncd reacteu-app\nnpm install\nnpm start\n```\n\n\nor, Build/run on Android -- **requires** cordova and the Android SDK to be installed\n\n``` bash\ngit clone git@github.com:Thinkmill/reacteu-app.git\ncd reacteu-app\nnpm install\nnpm run build\ncordova platform add android\ncordova run android\n```\n\n## License\n\nCopyright (c) 2015 Thinkmill. Made available under The MIT License (MIT).\n"
},
{
"path": "config.xml",
"content": "\n\n\tReactEurope\n\n\t\n\t\tReactEurope Conference app - list the schedule, speakers, and event info.\n\t\n\n\t\n\t\tThinkmill Team\n\t\n\n\t\n\t\n\n\t\n\t\n\t\n\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\n\t\t\n\t\t\n\t\t\n\t\t\n\n\t\t\n\t\t\n\t\t\n\t\t\n\t\n\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\n\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\n"
},
{
"path": "gulpfile.js",
"content": "/**\n * Gulp tasks are added by the touchstonejs-tasks package\n * See https://github.com/JedWatson/touchstonejs-tasks\n */\n\nrequire('touchstonejs-tasks')(require('gulp'));\n"
},
{
"path": "package.json",
"content": "{\n \"name\": \"react-europe\",\n \"version\": \"1.0.2\",\n \"description\": \"ReactEurope Conference\",\n \"private\": true,\n \"main\": \"src/js/app.js\",\n \"author\": \"Joss Mackison\",\n \"dependencies\": {\n \"async\": \"^1.0.0\",\n \"blacklist\": \"^1.1.2\",\n \"capitalize\": \"^1.0.0\",\n \"classnames\": \"^2.1.1\",\n \"defaults\": \"^1.0.2\",\n \"httpify\": \"^1.0.0\",\n \"moment\": \"^2.10.3\",\n \"react\": \"^0.13.3\",\n \"react-blink\": \"^1.0.2\",\n \"react-container\": \"^0.2.2\",\n \"react-sentry\": \"^0.4.0\",\n \"react-tappable\": \"^0.5.1\",\n \"react-timers\": \"^3.1.0\",\n \"touchstonejs\": \"git+https://github.com/touchstonejs/touchstonejs.git#3a0d5dbb2a3ee987aefe9d306855a60b0577866b\",\n \"tween.js\": \"^0.14.0\"\n },\n \"devDependencies\": {\n \"gulp\": \"^3.9.0\",\n \"happiness\": \"^1.0.6\",\n \"touchstonejs-tasks\": \"^0.2.5\"\n },\n \"scripts\": {\n \"build\": \"gulp clean && gulp build\",\n \"build:production\": \"gulp clean && NODE_ENV=production gulp build\",\n \"lint\": \"happiness\",\n \"start\": \"gulp clean && gulp dev\",\n \"watch\": \"gulp clean && gulp watch\"\n }\n}\n"
},
{
"path": "plugins/android.json",
"content": "{\n \"prepare_queue\": {\n \"installed\": [],\n \"uninstalled\": []\n },\n \"config_munge\": {\n \"files\": {}\n },\n \"installed_plugins\": {\n \"cordova-plugin-appavailability\": {\n \"PACKAGE_NAME\": \"com.thinkmill.reactEurope\"\n },\n \"cordova-plugin-code-push\": {\n \"PACKAGE_NAME\": \"com.thinkmill.reactEurope\"\n },\n \"cordova-plugin-inappbrowser\": {\n \"PACKAGE_NAME\": \"com.thinkmill.reactEurope\"\n },\n \"cordova-plugin-splashscreen\": {\n \"PACKAGE_NAME\": \"com.thinkmill.reactEurope\"\n },\n \"cordova-plugin-statusbar\": {\n \"PACKAGE_NAME\": \"com.thinkmill.reactEurope\"\n },\n \"cordova-plugin-vibration\": {\n \"PACKAGE_NAME\": \"com.thinkmill.reactEurope\"\n },\n \"cordova-plugin-whitelist\": {\n \"PACKAGE_NAME\": \"com.thinkmill.reactEurope\"\n },\n \"phonegap-plugin-barcodescanner\": {\n \"PACKAGE_NAME\": \"com.thinkmill.reactEurope\"\n }\n },\n \"dependent_plugins\": {\n \"code-push\": {\n \"PACKAGE_NAME\": \"com.thinkmill.reactEurope\"\n },\n \"cordova-plugin-compat\": {\n \"PACKAGE_NAME\": \"com.thinkmill.reactEurope\"\n },\n \"cordova-plugin-file\": {\n \"PACKAGE_NAME\": \"com.thinkmill.reactEurope\"\n },\n \"cordova-plugin-file-transfer\": {\n \"PACKAGE_NAME\": \"com.thinkmill.reactEurope\"\n },\n \"cordova-plugin-zip\": {\n \"PACKAGE_NAME\": \"com.thinkmill.reactEurope\"\n },\n \"cordova-plugin-dialogs\": {\n \"PACKAGE_NAME\": \"com.thinkmill.reactEurope\"\n },\n \"cordova-plugin-device\": {\n \"PACKAGE_NAME\": \"com.thinkmill.reactEurope\"\n }\n }\n}"
},
{
"path": "plugins/code-push/README.md",
"content": "# CodePush Management SDK (Node.js)\n\nA JavaScript library for programmatically managing your CodePush account (e.g. creating apps, promoting releases), which allows authoring Node.js-based build and/or deployment scripts, without needing to shell out to the [CLI](https://github.com/Microsoft/code-push/blob/master/cli/README.md).\n\n\n## Getting Started\n\n1. Create an access key to authenticate with the CodePush server using the following CodePush CLI command:\n\n ```shell\n code-push access-key add \"DESCRIPTION_OF_THE_KEY\"\n ```\n \n If you already created a key that you want to use here, then you can retrieve it by running `code-push access-key ls` and using the value of the `Key` column for the key you wish to use.\n \n2. Install the management SDK by running `npm install code-push --save`\n\n3. Import it using the following statement (using ES6 syntax as applicable):\n\n ```javascript\n var CodePush = require(\"code-push\"); \n ```\n \n4. Create an instance of the `CodePush` class, passing it the access key you created or retrieved in step #1:\n\n ```javascript\n var codePush = new CodePush(\"YOUR_ACCESS_KEY\");\n ```\n\n5. Begin automating the management of your account! For more details on what you can do with this `codePush` object, refer to the API reference section below.\n\n## API Reference\n\nThe `code-push` module exports a single class (typically referred to as `CodePush`), which represents a proxy to the CodePush account management REST API. This class has a single constructor for authenticating with the CodePush service, and a collection of instance methods that correspond to the commands in the management [CLI](https://github.com/Microsoft/code-push/blob/master/cli/README.md), which allow you to programmatically control every aspect of your CodePush account.\n\n### Constructors\n\n- __CodePush(accessKey: string)__ - Creates a new instance of the CodePush management SDK, using the specified access key to authenticated with the server.\n\n### Methods\n\n- __addAccessKey(description: string): Promise<AccessKey>__ - Creates a new access key with the specified description (e.g. \"VSTS CI\").\n\n- __addApp(appName: string): Promise<App>__ - Creates a new CodePush app with the specified name.\n\n- __addCollaborator(appName: string, email: string): Promise<void>__ - Adds the specified CodePush user as a collaborator to the specified CodePush app.\n\n- __addDeployment(appName: string, deploymentName: string): Promise<Deployment>__ - Creates a new deployment with the specified name, and associated with the specified app.\n\n- __clearDeploymentHistory(appName: string, deploymentName: string): Promise<void>__ - Clears the release history associated with the specified app deployment.\n\n- __getAccessKey(accessKey: string): Promise<AccessKey>__ - Retrieves the metadata about the specific access key.\n\n- __getAccessKeys(): Promise<AccessKey[]>__ - Retrieves the list of access keys associated with your CodePush account.\n\n- __getApp(appName: string): Promise<App>__ - Retrieves the metadata about the specified app.\n\n- __getApps(): Promise<App[]>__ - Retrieves the list of apps associated with your CodePush account.\n\n- __getCollaborators(appName: string): Promise<CollaboratorMap>__ - Retrieves the list of collaborators associated with the specified app.\n\n- __getDeployment(appName: string, deploymentName: string): Promise<Deployment>__ - Retrieves the metadata for the specified app deployment.\n\n- __getDeploymentHistory(appName: string, deploymentName: string): Promise<Package[]>__ - Retrieves the list of releases that have been made to the specified app deployment.\n\n- __getDeploymentMetrics(appName: string, deploymentName): Promise<DeploymentMetrics>__ - Retrieves the installation metrics for the specified app deployment. \n\n- __getDeployments(appName: string): Promose<Deployment[]>__ - Retrieves the list of deployments associated with the specified app.\n\n- __patchRelease(appName: string, deploymentName: string, label: string, updateMetadata: PackageInfo): Promise<void>__ - Updates the specified release's metadata with the given information.\n\n- __promote(appName: string, sourceDeploymentName: string, destinationDeploymentName: string, updateMetadata: PackageInfo): Promise<void>__ - Promotes the latest release from one deployment to another for the specified app and updates the release with the given metadata.\n\n- __release(appName: string, deploymentName: string, updateContentsPath: string, targetBinaryVersion: string, updateMetadata: PackageInfo): Promise<void>__ - Releases a new update to the specified deployment with the given metadata.\n\n- __removeAccessKey(accessKey: string): Promise<void>__ - Removes the specified access key from your CodePush account.\n\n- __removeApp(appName: string): Promise<void>__ - Deletes the specified CodePush app from your account.\n\n- __removeCollaborator(appName: string, email: string): Promise<void>__ - Removes the specified account as a collaborator from the specified app.\n\n- __removeDeployment(appName: string, deploymentName: string): Promise<void>__ - Removes the specified deployment from the specified app.\n\n- __renameApp(oldAppName: string, newAppName: string): Promise<void>__ - Renames an existing app.\n\n- __renameDeployment(appName: string, oldDeploymentName: string, newDeploymentName: string): Promise<void>__ - Renames an existing deployment within the specified app.\n\n- __rollback(appName: string, deploymentName: string, targetRelease?: string): Promise<void>__ - Rolls back the latest release within the specified deployment. Optionally allows you to target a specific release in the deployment's history, as opposed to rolling to the previous release.\n\n- __transferApp(appName: string, email: string): Promise<void>__ - Transfers the ownership of the specified app to the specified account.\n"
},
{
"path": "plugins/code-push/package.json",
"content": "{\n \"name\": \"code-push\",\n \"version\": \"1.9.2-beta\",\n \"description\": \"Management SDK for the CodePush service\",\n \"main\": \"script/index.js\",\n \"scripts\": {\n \"test\": \"gulp\"\n },\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/Microsoft/code-push.git\"\n },\n \"author\": \"Microsoft Corporation\",\n \"license\": \"MIT\",\n \"homepage\": \"https://microsoft.github.io/code-push\",\n \"dependencies\": {\n \"base-64\": \"^0.1.0\",\n \"node-uuid\": \"^1.4.3\",\n \"q\": \"^1.4.1\",\n \"superagent\": \"^1.7.2\",\n \"superagent-proxy\": \"^1.0.0\"\n }\n}\n"
},
{
"path": "plugins/code-push/plugin.xml",
"content": "\n\n\tCodePushAcquisition\n\tCodePush Acquisition Plugin for Apache Cordova\n\tMIT\n\tcordova,code,push,acquisition\n\thttps://github.com/Microsoft/code-push.git\n\t\n\t\t\n\t\n\n"
},
{
"path": "plugins/code-push/script/acquisition-sdk.js",
"content": "/// \nvar AcquisitionStatus = (function () {\n function AcquisitionStatus() {\n }\n AcquisitionStatus.DeploymentSucceeded = \"DeploymentSucceeded\";\n AcquisitionStatus.DeploymentFailed = \"DeploymentFailed\";\n return AcquisitionStatus;\n})();\nexports.AcquisitionStatus = AcquisitionStatus;\nvar AcquisitionManager = (function () {\n function AcquisitionManager(httpRequester, configuration) {\n this._httpRequester = httpRequester;\n this._serverUrl = configuration.serverUrl;\n if (this._serverUrl.slice(-1) !== \"/\") {\n this._serverUrl += \"/\";\n }\n this._appVersion = configuration.appVersion;\n this._clientUniqueId = configuration.clientUniqueId;\n this._deploymentKey = configuration.deploymentKey;\n this._ignoreAppVersion = configuration.ignoreAppVersion;\n }\n AcquisitionManager.prototype.queryUpdateWithCurrentPackage = function (currentPackage, callback) {\n var _this = this;\n if (!currentPackage || !currentPackage.appVersion) {\n throw new Error(\"Calling common acquisition SDK with incorrect package\"); // Unexpected; indicates error in our implementation\n }\n var updateRequest = {\n deploymentKey: this._deploymentKey,\n appVersion: currentPackage.appVersion,\n packageHash: currentPackage.packageHash,\n isCompanion: this._ignoreAppVersion,\n label: currentPackage.label,\n clientUniqueId: this._clientUniqueId\n };\n var requestUrl = this._serverUrl + \"updateCheck?\" + queryStringify(updateRequest);\n this._httpRequester.request(0 /* GET */, requestUrl, function (error, response) {\n if (error) {\n callback(error, null);\n return;\n }\n if (response.statusCode !== 200) {\n callback(new Error(response.statusCode + \": \" + response.body), null);\n return;\n }\n try {\n var responseObject = JSON.parse(response.body);\n var updateInfo = responseObject.updateInfo;\n }\n catch (error) {\n callback(error, null);\n return;\n }\n if (!updateInfo) {\n callback(error, null);\n return;\n }\n else if (updateInfo.updateAppVersion) {\n callback(null, { updateAppVersion: true, appVersion: updateInfo.appVersion });\n return;\n }\n else if (!updateInfo.isAvailable) {\n callback(null, null);\n return;\n }\n var remotePackage = {\n deploymentKey: _this._deploymentKey,\n description: updateInfo.description,\n label: updateInfo.label,\n appVersion: updateInfo.appVersion,\n isMandatory: updateInfo.isMandatory,\n packageHash: updateInfo.packageHash,\n packageSize: updateInfo.packageSize,\n downloadUrl: updateInfo.downloadURL\n };\n callback(null, remotePackage);\n });\n };\n AcquisitionManager.prototype.reportStatusDeploy = function (deployedPackage, status, previousLabelOrAppVersion, previousDeploymentKey, callback) {\n var url = this._serverUrl + \"reportStatus/deploy\";\n var body = {\n appVersion: this._appVersion,\n deploymentKey: this._deploymentKey\n };\n if (this._clientUniqueId) {\n body.clientUniqueId = this._clientUniqueId;\n }\n if (deployedPackage) {\n body.label = deployedPackage.label;\n body.appVersion = deployedPackage.appVersion;\n switch (status) {\n case AcquisitionStatus.DeploymentSucceeded:\n case AcquisitionStatus.DeploymentFailed:\n body.status = status;\n break;\n default:\n if (callback) {\n if (!status) {\n callback(new Error(\"Missing status argument.\"), null);\n }\n else {\n callback(new Error(\"Unrecognized status \\\"\" + status + \"\\\".\"), null);\n }\n }\n return;\n }\n }\n if (previousLabelOrAppVersion) {\n body.previousLabelOrAppVersion = previousLabelOrAppVersion;\n }\n if (previousDeploymentKey) {\n body.previousDeploymentKey = previousDeploymentKey;\n }\n callback = typeof arguments[arguments.length - 1] === \"function\" && arguments[arguments.length - 1];\n this._httpRequester.request(2 /* POST */, url, JSON.stringify(body), function (error, response) {\n if (callback) {\n if (error) {\n callback(error, null);\n return;\n }\n if (response.statusCode !== 200) {\n callback(new Error(response.statusCode + \": \" + response.body), null);\n return;\n }\n callback(null, null);\n }\n });\n };\n AcquisitionManager.prototype.reportStatusDownload = function (downloadedPackage, callback) {\n var url = this._serverUrl + \"reportStatus/download\";\n var body = {\n clientUniqueId: this._clientUniqueId,\n deploymentKey: this._deploymentKey,\n label: downloadedPackage.label\n };\n this._httpRequester.request(2 /* POST */, url, JSON.stringify(body), function (error, response) {\n if (callback) {\n if (error) {\n callback(error, null);\n return;\n }\n if (response.statusCode !== 200) {\n callback(new Error(response.statusCode + \": \" + response.body), null);\n return;\n }\n callback(null, null);\n }\n });\n };\n return AcquisitionManager;\n})();\nexports.AcquisitionManager = AcquisitionManager;\nfunction queryStringify(object) {\n var queryString = \"\";\n var isFirst = true;\n for (var property in object) {\n if (object.hasOwnProperty(property)) {\n var value = object[property];\n if (!isFirst) {\n queryString += \"&\";\n }\n queryString += encodeURIComponent(property) + \"=\";\n if (value !== null && typeof value !== \"undefined\") {\n queryString += encodeURIComponent(value);\n }\n isFirst = false;\n }\n }\n return queryString;\n}\n"
},
{
"path": "plugins/code-push/script/index.js",
"content": "var AccountManager = require(\"./management-sdk\");\nmodule.exports = AccountManager;\n"
},
{
"path": "plugins/code-push/script/management-sdk.js",
"content": "var os = require(\"os\");\nvar Q = require(\"q\");\nvar superagent = require(\"superagent\");\nvar Promise = Q.Promise;\nvar superproxy = require(\"superagent-proxy\");\nsuperproxy(superagent);\nvar packageJson = require(\"../package.json\");\nif (typeof window === \"undefined\") {\n fs = require(\"fs\");\n}\nelse {\n fs = {\n createReadStream: function (fileOrPath) {\n throw new Error(\"Tried to call a node fs function from the browser.\");\n }\n };\n}\n// A template string tag function that URL encodes the substituted values\nfunction urlEncode(strings) {\n var values = [];\n for (var _i = 1; _i < arguments.length; _i++) {\n values[_i - 1] = arguments[_i];\n }\n var result = \"\";\n for (var i = 0; i < strings.length; i++) {\n result += strings[i];\n if (i < values.length) {\n result += encodeURIComponent(values[i]);\n }\n }\n return result;\n}\nvar AccountManager = (function () {\n function AccountManager(accessKey, customHeaders, serverUrl, proxy) {\n if (!accessKey)\n throw new Error(\"An access key must be specified.\");\n this._accessKey = accessKey;\n this._customHeaders = customHeaders;\n this._serverUrl = serverUrl || AccountManager.SERVER_URL;\n this._proxy = proxy;\n }\n Object.defineProperty(AccountManager.prototype, \"accessKey\", {\n get: function () {\n return this._accessKey;\n },\n enumerable: true,\n configurable: true\n });\n AccountManager.prototype.isAuthenticated = function () {\n var _this = this;\n return Promise(function (resolve, reject, notify) {\n var request = superagent.get(_this._serverUrl + (_a = [\"/authenticated\"], _a.raw = [\"/authenticated\"], urlEncode(_a)));\n if (_this._proxy)\n request.proxy(_this._proxy);\n _this.attachCredentials(request);\n request.end(function (err, res) {\n if (err && err.status !== 401) {\n reject({ message: _this.getErrorMessage(err, res) });\n return;\n }\n var status = res ? res.status : err.status;\n var authenticated = status === 200;\n resolve(authenticated);\n });\n var _a;\n });\n };\n AccountManager.prototype.addAccessKey = function (description) {\n if (!description) {\n throw new Error(\"A description must be specified when adding an access key.\");\n }\n var hostname = os.hostname();\n var accessKeyRequest = { createdBy: hostname, description: description };\n return this.post((_a = [\"/accessKeys/\"], _a.raw = [\"/accessKeys/\"], urlEncode(_a)), JSON.stringify(accessKeyRequest), true)\n .then(function (response) { return response.body.accessKey; });\n var _a;\n };\n AccountManager.prototype.getAccessKey = function (accessKey) {\n return this.get((_a = [\"/accessKeys/\", \"\"], _a.raw = [\"/accessKeys/\", \"\"], urlEncode(_a, accessKey)))\n .then(function (res) { return res.body.accessKey; });\n var _a;\n };\n AccountManager.prototype.getAccessKeys = function () {\n return this.get((_a = [\"/accessKeys\"], _a.raw = [\"/accessKeys\"], urlEncode(_a)))\n .then(function (res) { return res.body.accessKeys; });\n var _a;\n };\n AccountManager.prototype.removeAccessKey = function (accessKey) {\n return this.del((_a = [\"/accessKeys/\", \"\"], _a.raw = [\"/accessKeys/\", \"\"], urlEncode(_a, accessKey)))\n .then(function () { return null; });\n var _a;\n };\n // Account\n AccountManager.prototype.getAccountInfo = function () {\n return this.get((_a = [\"/account\"], _a.raw = [\"/account\"], urlEncode(_a)))\n .then(function (res) { return res.body.account; });\n var _a;\n };\n // Apps\n AccountManager.prototype.getApps = function () {\n return this.get((_a = [\"/apps\"], _a.raw = [\"/apps\"], urlEncode(_a)))\n .then(function (res) { return res.body.apps; });\n var _a;\n };\n AccountManager.prototype.getApp = function (appName) {\n return this.get((_a = [\"/apps/\", \"\"], _a.raw = [\"/apps/\", \"\"], urlEncode(_a, appName)))\n .then(function (res) { return res.body.app; });\n var _a;\n };\n AccountManager.prototype.addApp = function (appName) {\n var app = { name: appName };\n return this.post((_a = [\"/apps/\"], _a.raw = [\"/apps/\"], urlEncode(_a)), JSON.stringify(app), false)\n .then(function () { return app; });\n var _a;\n };\n AccountManager.prototype.removeApp = function (appName) {\n return this.del((_a = [\"/apps/\", \"\"], _a.raw = [\"/apps/\", \"\"], urlEncode(_a, appName)))\n .then(function () { return null; });\n var _a;\n };\n AccountManager.prototype.renameApp = function (oldAppName, newAppName) {\n return this.patch((_a = [\"/apps/\", \"\"], _a.raw = [\"/apps/\", \"\"], urlEncode(_a, oldAppName)), JSON.stringify({ name: newAppName }))\n .then(function () { return null; });\n var _a;\n };\n AccountManager.prototype.transferApp = function (appName, email) {\n return this.post((_a = [\"/apps/\", \"/transfer/\", \"\"], _a.raw = [\"/apps/\", \"/transfer/\", \"\"], urlEncode(_a, appName, email)), null, false)\n .then(function () { return null; });\n var _a;\n };\n // Collaborators\n AccountManager.prototype.getCollaborators = function (appName) {\n return this.get((_a = [\"/apps/\", \"/collaborators\"], _a.raw = [\"/apps/\", \"/collaborators\"], urlEncode(_a, appName)))\n .then(function (res) { return res.body.collaborators; });\n var _a;\n };\n AccountManager.prototype.addCollaborator = function (appName, email) {\n return this.post((_a = [\"/apps/\", \"/collaborators/\", \"\"], _a.raw = [\"/apps/\", \"/collaborators/\", \"\"], urlEncode(_a, appName, email)), null, false)\n .then(function () { return null; });\n var _a;\n };\n AccountManager.prototype.removeCollaborator = function (appName, email) {\n return this.del((_a = [\"/apps/\", \"/collaborators/\", \"\"], _a.raw = [\"/apps/\", \"/collaborators/\", \"\"], urlEncode(_a, appName, email)))\n .then(function () { return null; });\n var _a;\n };\n // Deployments\n AccountManager.prototype.addDeployment = function (appName, deploymentName) {\n var deployment = { name: deploymentName };\n return this.post((_a = [\"/apps/\", \"/deployments/\"], _a.raw = [\"/apps/\", \"/deployments/\"], urlEncode(_a, appName)), JSON.stringify(deployment), true)\n .then(function (res) { return res.body.deployment; });\n var _a;\n };\n AccountManager.prototype.clearDeploymentHistory = function (appName, deploymentName) {\n return this.del((_a = [\"/apps/\", \"/deployments/\", \"/history\"], _a.raw = [\"/apps/\", \"/deployments/\", \"/history\"], urlEncode(_a, appName, deploymentName)))\n .then(function () { return null; });\n var _a;\n };\n AccountManager.prototype.getDeployments = function (appName) {\n return this.get((_a = [\"/apps/\", \"/deployments/\"], _a.raw = [\"/apps/\", \"/deployments/\"], urlEncode(_a, appName)))\n .then(function (res) { return res.body.deployments; });\n var _a;\n };\n AccountManager.prototype.getDeployment = function (appName, deploymentName) {\n return this.get((_a = [\"/apps/\", \"/deployments/\", \"\"], _a.raw = [\"/apps/\", \"/deployments/\", \"\"], urlEncode(_a, appName, deploymentName)))\n .then(function (res) { return res.body.deployment; });\n var _a;\n };\n AccountManager.prototype.renameDeployment = function (appName, oldDeploymentName, newDeploymentName) {\n return this.patch((_a = [\"/apps/\", \"/deployments/\", \"\"], _a.raw = [\"/apps/\", \"/deployments/\", \"\"], urlEncode(_a, appName, oldDeploymentName)), JSON.stringify({ name: newDeploymentName }))\n .then(function () { return null; });\n var _a;\n };\n AccountManager.prototype.removeDeployment = function (appName, deploymentName) {\n return this.del((_a = [\"/apps/\", \"/deployments/\", \"\"], _a.raw = [\"/apps/\", \"/deployments/\", \"\"], urlEncode(_a, appName, deploymentName)))\n .then(function () { return null; });\n var _a;\n };\n AccountManager.prototype.getDeploymentMetrics = function (appName, deploymentName) {\n return this.get((_a = [\"/apps/\", \"/deployments/\", \"/metrics\"], _a.raw = [\"/apps/\", \"/deployments/\", \"/metrics\"], urlEncode(_a, appName, deploymentName)))\n .then(function (res) { return res.body.metrics; });\n var _a;\n };\n AccountManager.prototype.getDeploymentHistory = function (appName, deploymentName) {\n return this.get((_a = [\"/apps/\", \"/deployments/\", \"/history\"], _a.raw = [\"/apps/\", \"/deployments/\", \"/history\"], urlEncode(_a, appName, deploymentName)))\n .then(function (res) { return res.body.history; });\n var _a;\n };\n AccountManager.prototype.release = function (appName, deploymentName, fileOrPath, targetBinaryVersion, updateMetadata, uploadProgressCallback) {\n var _this = this;\n return Promise(function (resolve, reject, notify) {\n updateMetadata.appVersion = targetBinaryVersion;\n var request = superagent.post(_this._serverUrl + (_a = [\"/apps/\", \"/deployments/\", \"/release\"], _a.raw = [\"/apps/\", \"/deployments/\", \"/release\"], urlEncode(_a, appName, deploymentName)));\n if (_this._proxy)\n request.proxy(_this._proxy);\n _this.attachCredentials(request);\n var file;\n if (typeof fileOrPath === \"string\") {\n file = fs.createReadStream(fileOrPath);\n }\n else {\n file = fileOrPath;\n }\n request.attach(\"package\", file)\n .field(\"packageInfo\", JSON.stringify(updateMetadata))\n .on(\"progress\", function (event) {\n if (uploadProgressCallback && event && event.total > 0) {\n var currentProgress = event.loaded / event.total * 100;\n uploadProgressCallback(currentProgress);\n }\n })\n .end(function (err, res) {\n if (err) {\n reject({ message: _this.getErrorMessage(err, res) });\n return;\n }\n if (res.ok) {\n resolve(null);\n }\n else {\n try {\n var body = JSON.parse(res.text);\n }\n catch (err) {\n }\n if (body) {\n reject(body);\n }\n else {\n reject({ message: res.text, statusCode: res.status });\n }\n }\n });\n var _a;\n });\n };\n AccountManager.prototype.patchRelease = function (appName, deploymentName, label, updateMetadata) {\n updateMetadata.label = label;\n var requestBody = JSON.stringify({ packageInfo: updateMetadata });\n return this.patch((_a = [\"/apps/\", \"/deployments/\", \"/release\"], _a.raw = [\"/apps/\", \"/deployments/\", \"/release\"], urlEncode(_a, appName, deploymentName)), requestBody, false)\n .then(function () { return null; });\n var _a;\n };\n AccountManager.prototype.promote = function (appName, sourceDeploymentName, destinationDeploymentName, updateMetadata) {\n var requestBody = JSON.stringify({ packageInfo: updateMetadata });\n return this.post((_a = [\"/apps/\", \"/deployments/\", \"/promote/\", \"\"], _a.raw = [\"/apps/\", \"/deployments/\", \"/promote/\", \"\"], urlEncode(_a, appName, sourceDeploymentName, destinationDeploymentName)), requestBody, false)\n .then(function () { return null; });\n var _a;\n };\n AccountManager.prototype.rollback = function (appName, deploymentName, targetRelease) {\n return this.post((_a = [\"/apps/\", \"/deployments/\", \"/rollback/\", \"\"], _a.raw = [\"/apps/\", \"/deployments/\", \"/rollback/\", \"\"], urlEncode(_a, appName, deploymentName, targetRelease || \"\")), null, false)\n .then(function () { return null; });\n var _a;\n };\n AccountManager.prototype.get = function (endpoint, expectResponseBody) {\n if (expectResponseBody === void 0) { expectResponseBody = true; }\n return this.makeApiRequest(\"get\", endpoint, null, expectResponseBody, null);\n };\n AccountManager.prototype.post = function (endpoint, requestBody, expectResponseBody, contentType) {\n if (contentType === void 0) { contentType = \"application/json;charset=UTF-8\"; }\n return this.makeApiRequest(\"post\", endpoint, requestBody, expectResponseBody, contentType);\n };\n AccountManager.prototype.patch = function (endpoint, requestBody, expectResponseBody, contentType) {\n if (expectResponseBody === void 0) { expectResponseBody = false; }\n if (contentType === void 0) { contentType = \"application/json;charset=UTF-8\"; }\n return this.makeApiRequest(\"patch\", endpoint, requestBody, expectResponseBody, contentType);\n };\n AccountManager.prototype.del = function (endpoint, expectResponseBody) {\n if (expectResponseBody === void 0) { expectResponseBody = false; }\n return this.makeApiRequest(\"del\", endpoint, null, expectResponseBody, null);\n };\n AccountManager.prototype.makeApiRequest = function (method, endpoint, requestBody, expectResponseBody, contentType) {\n var _this = this;\n return Promise(function (resolve, reject, notify) {\n var request = superagent[method](_this._serverUrl + endpoint);\n if (_this._proxy)\n request.proxy(_this._proxy);\n _this.attachCredentials(request);\n if (requestBody) {\n if (contentType) {\n request = request.set(\"Content-Type\", contentType);\n }\n request = request.send(requestBody);\n }\n request.end(function (err, res) {\n if (err) {\n reject({ message: _this.getErrorMessage(err, res) });\n return;\n }\n try {\n var body = JSON.parse(res.text);\n }\n catch (err) {\n }\n if (res.ok) {\n if (expectResponseBody && !body) {\n reject({ message: \"Could not parse response: \" + res.text, statusCode: res.status });\n }\n else {\n resolve({\n headers: res.header,\n body: body\n });\n }\n }\n else {\n if (body) {\n reject(body);\n }\n else {\n reject({ message: res.text, statusCode: res.status });\n }\n }\n });\n });\n };\n AccountManager.prototype.getErrorMessage = function (error, response) {\n return response && response.text ? response.text : error.message;\n };\n AccountManager.prototype.attachCredentials = function (request) {\n if (this._customHeaders) {\n for (var headerName in this._customHeaders) {\n request.set(headerName, this._customHeaders[headerName]);\n }\n }\n request.set(\"Accept\", \"application/vnd.code-push.v\" + AccountManager.API_VERSION + \"+json\");\n request.set(\"Authorization\", \"Bearer \" + this._accessKey);\n request.set(\"X-CodePush-SDK-Version\", packageJson.version);\n };\n AccountManager.AppPermission = {\n OWNER: \"Owner\",\n COLLABORATOR: \"Collaborator\"\n };\n AccountManager.SERVER_URL = \"https://codepush-management.azurewebsites.net\";\n AccountManager.API_VERSION = 2;\n return AccountManager;\n})();\nmodule.exports = AccountManager;\n"
},
{
"path": "plugins/code-push/script/types.js",
"content": "\n"
},
{
"path": "plugins/code-push/test/acquisition-rest-mock.js",
"content": "/// \nvar querystring = require(\"querystring\");\nvar acquisitionSdk = require(\"../script/acquisition-sdk\");\nexports.validDeploymentKey = \"asdfasdfawerqw\";\nexports.latestPackage = {\n downloadURL: \"http://www.windowsazure.com/blobs/awperoiuqpweru\",\n description: \"Angry flappy birds\",\n appVersion: \"1.5.0\",\n label: \"2.4.0\",\n isMandatory: false,\n isAvailable: true,\n updateAppVersion: false,\n packageHash: \"hash240\",\n packageSize: 1024\n};\nexports.serverUrl = \"http://myurl.com\";\nvar reportStatusDeployUrl = exports.serverUrl + \"/reportStatus/deploy\";\nvar reportStatusDownloadUrl = exports.serverUrl + \"/reportStatus/download\";\nvar updateCheckUrl = exports.serverUrl + \"/updateCheck?\";\nvar HttpRequester = (function () {\n function HttpRequester() {\n }\n HttpRequester.prototype.request = function (verb, url, requestBodyOrCallback, callback) {\n if (!callback && typeof requestBodyOrCallback === \"function\") {\n callback = requestBodyOrCallback;\n }\n if (verb === 0 /* GET */ && url.indexOf(updateCheckUrl) === 0) {\n var params = querystring.parse(url.substring(updateCheckUrl.length));\n Server.onUpdateCheck(params, callback);\n }\n else if (verb === 2 /* POST */ && url === reportStatusDeployUrl) {\n Server.onReportStatus(callback);\n }\n else if (verb === 2 /* POST */ && url === reportStatusDownloadUrl) {\n Server.onReportStatus(callback);\n }\n else {\n throw new Error(\"Unexpected call\");\n }\n };\n return HttpRequester;\n})();\nexports.HttpRequester = HttpRequester;\nvar CustomResponseHttpRequester = (function () {\n function CustomResponseHttpRequester(response) {\n this.response = response;\n }\n CustomResponseHttpRequester.prototype.request = function (verb, url, requestBodyOrCallback, callback) {\n if (typeof requestBodyOrCallback !== \"function\") {\n throw new Error(\"Unexpected request body\");\n }\n callback = requestBodyOrCallback;\n callback(null, this.response);\n };\n return CustomResponseHttpRequester;\n})();\nexports.CustomResponseHttpRequester = CustomResponseHttpRequester;\nvar Server = (function () {\n function Server() {\n }\n Server.onAcquire = function (params, callback) {\n if (params.deploymentKey !== exports.validDeploymentKey) {\n callback(null, {\n statusCode: 200,\n body: JSON.stringify({ updateInfo: { isAvailable: false } })\n });\n }\n else {\n callback(null, {\n statusCode: 200,\n body: JSON.stringify({ updateInfo: exports.latestPackage })\n });\n }\n };\n Server.onUpdateCheck = function (params, callback) {\n var updateRequest = {\n deploymentKey: params.deploymentKey,\n appVersion: params.appVersion,\n packageHash: params.packageHash,\n isCompanion: !!(params.isCompanion),\n label: params.label\n };\n if (!updateRequest.deploymentKey || !updateRequest.appVersion) {\n callback(null, { statusCode: 400 });\n }\n else {\n var updateInfo = { isAvailable: false };\n if (updateRequest.deploymentKey === exports.validDeploymentKey) {\n if (updateRequest.isCompanion || updateRequest.appVersion === exports.latestPackage.appVersion) {\n if (updateRequest.packageHash !== exports.latestPackage.packageHash) {\n updateInfo = exports.latestPackage;\n }\n }\n else if (updateRequest.appVersion < exports.latestPackage.appVersion) {\n updateInfo = { updateAppVersion: true, appVersion: exports.latestPackage.appVersion };\n }\n }\n callback(null, {\n statusCode: 200,\n body: JSON.stringify({ updateInfo: updateInfo })\n });\n }\n };\n Server.onReportStatus = function (callback) {\n callback(null, { statusCode: 200 });\n };\n return Server;\n})();\n"
},
{
"path": "plugins/code-push/test/acquisition-sdk.js",
"content": "/// \nvar assert = require(\"assert\");\nvar acquisitionSdk = require(\"../script/acquisition-sdk\");\nvar mockApi = require(\"./acquisition-rest-mock\");\nvar latestPackage = clone(mockApi.latestPackage);\nvar configuration = {\n appVersion: \"1.5.0\",\n clientUniqueId: \"My iPhone\",\n deploymentKey: mockApi.validDeploymentKey,\n serverUrl: mockApi.serverUrl,\n};\nvar templateCurrentPackage = {\n deploymentKey: mockApi.validDeploymentKey,\n description: \"sdfsdf\",\n label: \"v1\",\n appVersion: latestPackage.appVersion,\n packageHash: \"hash001\",\n isMandatory: false,\n packageSize: 100\n};\nvar scriptUpdateResult = {\n deploymentKey: mockApi.validDeploymentKey,\n description: latestPackage.description,\n downloadUrl: latestPackage.downloadURL,\n label: latestPackage.label,\n appVersion: latestPackage.appVersion,\n isMandatory: latestPackage.isMandatory,\n packageHash: latestPackage.packageHash,\n packageSize: latestPackage.packageSize\n};\nvar nativeUpdateResult = {\n updateAppVersion: true,\n appVersion: latestPackage.appVersion\n};\ndescribe(\"Acquisition SDK\", function () {\n beforeEach(function () {\n mockApi.latestPackage = clone(latestPackage);\n });\n it(\"Package with lower label and different package hash gives update\", function (done) {\n var acquisition = new acquisitionSdk.AcquisitionManager(new mockApi.HttpRequester(), configuration);\n acquisition.queryUpdateWithCurrentPackage(templateCurrentPackage, function (error, returnPackage) {\n assert.equal(null, error);\n assert.deepEqual(scriptUpdateResult, returnPackage);\n done();\n });\n });\n it(\"Package with equal package hash gives no update\", function (done) {\n var equalVersionPackage = clone(templateCurrentPackage);\n equalVersionPackage.packageHash = latestPackage.packageHash;\n var acquisition = new acquisitionSdk.AcquisitionManager(new mockApi.HttpRequester(), configuration);\n acquisition.queryUpdateWithCurrentPackage(equalVersionPackage, function (error, returnPackage) {\n assert.equal(null, error);\n assert.equal(null, returnPackage);\n done();\n });\n });\n it(\"Package with higher different hash and higher label version gives update\", function (done) {\n var higherVersionPackage = clone(templateCurrentPackage);\n higherVersionPackage.packageHash = \"hash990\";\n var acquisition = new acquisitionSdk.AcquisitionManager(new mockApi.HttpRequester(), configuration);\n acquisition.queryUpdateWithCurrentPackage(higherVersionPackage, function (error, returnPackage) {\n assert.equal(null, error);\n assert.deepEqual(scriptUpdateResult, returnPackage);\n done();\n });\n });\n it(\"Package with lower native version gives update notification\", function (done) {\n var lowerAppVersionPackage = clone(templateCurrentPackage);\n lowerAppVersionPackage.appVersion = \"0.0.1\";\n var acquisition = new acquisitionSdk.AcquisitionManager(new mockApi.HttpRequester(), configuration);\n acquisition.queryUpdateWithCurrentPackage(lowerAppVersionPackage, function (error, returnPackage) {\n assert.equal(null, error);\n assert.deepEqual(nativeUpdateResult, returnPackage);\n done();\n });\n });\n it(\"Package with higher native version gives no update\", function (done) {\n var higherAppVersionPackage = clone(templateCurrentPackage);\n higherAppVersionPackage.appVersion = \"9.9.0\";\n var acquisition = new acquisitionSdk.AcquisitionManager(new mockApi.HttpRequester(), configuration);\n acquisition.queryUpdateWithCurrentPackage(higherAppVersionPackage, function (error, returnPackage) {\n assert.equal(null, error);\n assert.deepEqual(null, returnPackage);\n done();\n });\n });\n it(\"An empty response gives no update\", function (done) {\n var lowerAppVersionPackage = clone(templateCurrentPackage);\n lowerAppVersionPackage.appVersion = \"0.0.1\";\n var emptyReponse = {\n statusCode: 200,\n body: JSON.stringify({})\n };\n var acquisition = new acquisitionSdk.AcquisitionManager(new mockApi.CustomResponseHttpRequester(emptyReponse), configuration);\n acquisition.queryUpdateWithCurrentPackage(lowerAppVersionPackage, function (error, returnPackage) {\n assert.equal(null, error);\n done();\n });\n });\n it(\"An unexpected (but valid) JSON response gives no update\", function (done) {\n var lowerAppVersionPackage = clone(templateCurrentPackage);\n lowerAppVersionPackage.appVersion = \"0.0.1\";\n var unexpectedResponse = {\n statusCode: 200,\n body: JSON.stringify({ unexpected: \"response\" })\n };\n var acquisition = new acquisitionSdk.AcquisitionManager(new mockApi.CustomResponseHttpRequester(unexpectedResponse), configuration);\n acquisition.queryUpdateWithCurrentPackage(lowerAppVersionPackage, function (error, returnPackage) {\n assert.equal(null, error);\n done();\n });\n });\n it(\"Package for companion app ignores high native version and gives update\", function (done) {\n var higherAppVersionCompanionPackage = clone(templateCurrentPackage);\n higherAppVersionCompanionPackage.appVersion = \"9.9.0\";\n var companionAppConfiguration = clone(configuration);\n configuration.ignoreAppVersion = true;\n var acquisition = new acquisitionSdk.AcquisitionManager(new mockApi.HttpRequester(), configuration);\n acquisition.queryUpdateWithCurrentPackage(higherAppVersionCompanionPackage, function (error, returnPackage) {\n assert.equal(null, error);\n assert.deepEqual(scriptUpdateResult, returnPackage);\n done();\n });\n });\n it(\"If latest package is mandatory, returned package is mandatory\", function (done) {\n mockApi.latestPackage.isMandatory = true;\n var acquisition = new acquisitionSdk.AcquisitionManager(new mockApi.HttpRequester(), configuration);\n acquisition.queryUpdateWithCurrentPackage(templateCurrentPackage, function (error, returnPackage) {\n assert.equal(null, error);\n assert.equal(true, returnPackage.isMandatory);\n done();\n });\n });\n it(\"If invalid arguments are provided, an error is raised\", function (done) {\n var invalidPackage = clone(templateCurrentPackage);\n invalidPackage.appVersion = null;\n var acquisition = new acquisitionSdk.AcquisitionManager(new mockApi.HttpRequester(), configuration);\n try {\n acquisition.queryUpdateWithCurrentPackage(invalidPackage, function (error, returnPackage) {\n assert.fail(\"Should throw an error if the native implementation gave an incorrect package\");\n done();\n });\n }\n catch (error) {\n done();\n }\n });\n it(\"If an invalid JSON response is returned by the server, an error is raised\", function (done) {\n var lowerAppVersionPackage = clone(templateCurrentPackage);\n lowerAppVersionPackage.appVersion = \"0.0.1\";\n var invalidJsonReponse = {\n statusCode: 200,\n body: \"invalid {{ json\"\n };\n var acquisition = new acquisitionSdk.AcquisitionManager(new mockApi.CustomResponseHttpRequester(invalidJsonReponse), configuration);\n acquisition.queryUpdateWithCurrentPackage(lowerAppVersionPackage, function (error, returnPackage) {\n assert.notEqual(null, error);\n done();\n });\n });\n it(\"If deploymentKey is not valid...\", function (done) {\n // TODO: behaviour is not defined\n done();\n });\n it(\"reportStatusDeploy(...) signals completion\", function (done) {\n var acquisition = new acquisitionSdk.AcquisitionManager(new mockApi.HttpRequester(), configuration);\n acquisition.reportStatusDeploy(templateCurrentPackage, acquisitionSdk.AcquisitionStatus.DeploymentFailed, \"1.5.0\", mockApi.validDeploymentKey, (function (error, parameter) {\n if (error) {\n throw error;\n }\n assert.equal(parameter, null);\n done();\n }));\n });\n it(\"reportStatusDownload(...) signals completion\", function (done) {\n var acquisition = new acquisitionSdk.AcquisitionManager(new mockApi.HttpRequester(), configuration);\n acquisition.reportStatusDownload(templateCurrentPackage, (function (error, parameter) {\n if (error) {\n throw error;\n }\n assert.equal(parameter, null);\n done();\n }));\n });\n});\nfunction clone(initialObject) {\n return JSON.parse(JSON.stringify(initialObject));\n}\n"
},
{
"path": "plugins/code-push/test/management-sdk.js",
"content": "/// \nvar assert = require(\"assert\");\nvar Q = require(\"q\");\nvar AccountManager = require(\"../script/management-sdk\");\nvar request = require(\"superagent\");\nvar manager;\ndescribe(\"Management SDK\", function () {\n beforeEach(function () {\n manager = new AccountManager(\"dummyAccessKey\", null, \"http://localhost\");\n });\n after(function () {\n // Prevent an exception that occurs due to how superagent-mock overwrites methods\n request.Request.prototype._callback = function () { };\n });\n it(\"methods reject the promise with status code info when an error occurs\", function (done) {\n mockReturn(\"Text\", 404);\n var methodsWithErrorHandling = [\n manager.addApp.bind(manager, \"appName\"),\n manager.getApp.bind(manager, \"appName\"),\n manager.renameApp.bind(manager, \"appName\", {}),\n manager.removeApp.bind(manager, \"appName\"),\n manager.transferApp.bind(manager, \"appName\", \"email1\"),\n manager.addDeployment.bind(manager, \"appName\", \"deploymentName\"),\n manager.getDeployment.bind(manager, \"appName\", \"deploymentName\"),\n manager.getDeployments.bind(manager, \"appName\"),\n manager.renameDeployment.bind(manager, \"appName\", \"deploymentName\", { name: \"newDeploymentName\" }),\n manager.removeDeployment.bind(manager, \"appName\", \"deploymentName\"),\n manager.addCollaborator.bind(manager, \"appName\", \"email1\"),\n manager.getCollaborators.bind(manager, \"appName\"),\n manager.removeCollaborator.bind(manager, \"appName\", \"email1\"),\n manager.patchRelease.bind(manager, \"appName\", \"deploymentName\", \"label\", { description: \"newDescription\" }),\n manager.promote.bind(manager, \"appName\", \"deploymentName\", \"newDeploymentName\", { description: \"newDescription\" }),\n manager.rollback.bind(manager, \"appName\", \"deploymentName\", \"targetReleaseLabel\")\n ];\n var result = Q(null);\n methodsWithErrorHandling.forEach(function (f) {\n result = result.then(function () {\n return testErrors(f);\n });\n });\n result.done(function () {\n done();\n });\n // Test that the proper error code and text is passed through on a server error\n function testErrors(method) {\n return Q.Promise(function (resolve, reject, notify) {\n method().done(function () {\n assert.fail(\"Should have thrown an error\");\n reject();\n }, function (error) {\n assert.equal(error.message, \"Text\");\n resolve();\n });\n });\n }\n });\n it(\"isAuthenticated handles successful auth\", function (done) {\n mockReturn(JSON.stringify({ authenticated: true }), 200, {});\n manager.isAuthenticated()\n .done(function (authenticated) {\n assert(authenticated, \"Should be authenticated\");\n done();\n });\n });\n it(\"isAuthenticated handles unsuccessful auth\", function (done) {\n mockReturn(\"Unauthorized\", 401, {});\n manager.isAuthenticated()\n .done(function (authenticated) {\n assert(!authenticated, \"Should not be authenticated\");\n done();\n });\n });\n it(\"isAuthenticated handles unexpected status codes\", function (done) {\n mockReturn(\"Not Found\", 404, {});\n manager.isAuthenticated()\n .done(function (authenticated) {\n assert.fail(\"isAuthenticated should have rejected the promise\");\n done();\n }, function (err) {\n assert.equal(err.message, \"Not Found\", \"Error message should be 'Not Found'\");\n done();\n });\n });\n it(\"addApp handles successful response\", function (done) {\n mockReturn(JSON.stringify({ success: true }), 201, { location: \"/appName\" });\n manager.addApp(\"appName\")\n .done(function (obj) {\n assert.ok(obj);\n done();\n }, rejectHandler);\n });\n it(\"addApp handles error response\", function (done) {\n mockReturn(JSON.stringify({ success: false }), 404, {});\n manager.addApp(\"appName\")\n .done(function (obj) {\n throw new Error(\"Call should not complete successfully\");\n }, function (error) { return done(); });\n });\n it(\"getApp handles JSON response\", function (done) {\n mockReturn(JSON.stringify({ app: {} }), 200, {});\n manager.getApp(\"appName\")\n .done(function (obj) {\n assert.ok(obj);\n done();\n }, rejectHandler);\n });\n it(\"updateApp handles success response\", function (done) {\n mockReturn(JSON.stringify({ apps: [] }), 200, {});\n manager.renameApp(\"appName\", \"newAppName\")\n .done(function (obj) {\n assert.ok(!obj);\n done();\n }, rejectHandler);\n });\n it(\"removeApp handles success response\", function (done) {\n mockReturn(\"\", 200, {});\n manager.removeApp(\"appName\")\n .done(function (obj) {\n assert.ok(!obj);\n done();\n }, rejectHandler);\n });\n it(\"transferApp handles successful response\", function (done) {\n mockReturn(\"\", 201);\n manager.transferApp(\"appName\", \"email1\")\n .done(function (obj) {\n assert.ok(!obj);\n done();\n }, rejectHandler);\n });\n it(\"addDeployment handles success response\", function (done) {\n mockReturn(JSON.stringify({ deployment: { name: \"name\", key: \"key\" } }), 201, { location: \"/deploymentName\" });\n manager.addDeployment(\"appName\", \"deploymentName\")\n .done(function (obj) {\n assert.ok(obj);\n done();\n }, rejectHandler);\n });\n it(\"getDeployment handles JSON response\", function (done) {\n mockReturn(JSON.stringify({ deployment: {} }), 200, {});\n manager.getDeployment(\"appName\", \"deploymentName\")\n .done(function (obj) {\n assert.ok(obj);\n done();\n }, rejectHandler);\n });\n it(\"getDeployments handles JSON response\", function (done) {\n mockReturn(JSON.stringify({ deployments: [] }), 200, {});\n manager.getDeployments(\"appName\")\n .done(function (obj) {\n assert.ok(obj);\n done();\n }, rejectHandler);\n });\n it(\"renameDeployment handles success response\", function (done) {\n mockReturn(JSON.stringify({ apps: [] }), 200, {});\n manager.renameDeployment(\"appName\", \"deploymentName\", \"newDeploymentName\")\n .done(function (obj) {\n assert.ok(!obj);\n done();\n }, rejectHandler);\n });\n it(\"removeDeployment handles success response\", function (done) {\n mockReturn(\"\", 200, {});\n manager.removeDeployment(\"appName\", \"deploymentName\")\n .done(function (obj) {\n assert.ok(!obj);\n done();\n }, rejectHandler);\n });\n it(\"getDeploymentHistory handles success response with no packages\", function (done) {\n mockReturn(JSON.stringify({ history: [] }), 200);\n manager.getDeploymentHistory(\"appName\", \"deploymentName\")\n .done(function (obj) {\n assert.ok(obj);\n assert.equal(obj.length, 0);\n done();\n }, rejectHandler);\n });\n it(\"getDeploymentHistory handles success response with two packages\", function (done) {\n mockReturn(JSON.stringify({ history: [{ label: \"v1\" }, { label: \"v2\" }] }), 200);\n manager.getDeploymentHistory(\"appName\", \"deploymentName\")\n .done(function (obj) {\n assert.ok(obj);\n assert.equal(obj.length, 2);\n assert.equal(obj[0].label, \"v1\");\n assert.equal(obj[1].label, \"v2\");\n done();\n }, rejectHandler);\n });\n it(\"getDeploymentHistory handles error response\", function (done) {\n mockReturn(\"\", 404);\n manager.getDeploymentHistory(\"appName\", \"deploymentName\")\n .done(function (obj) {\n throw new Error(\"Call should not complete successfully\");\n }, function (error) { return done(); });\n });\n it(\"clearDeploymentHistory handles success response\", function (done) {\n mockReturn(\"\", 204);\n manager.clearDeploymentHistory(\"appName\", \"deploymentName\")\n .done(function (obj) {\n assert.ok(!obj);\n done();\n }, rejectHandler);\n });\n it(\"clearDeploymentHistory handles error response\", function (done) {\n mockReturn(\"\", 404);\n manager.clearDeploymentHistory(\"appName\", \"deploymentName\")\n .done(function (obj) {\n throw new Error(\"Call should not complete successfully\");\n }, function (error) { return done(); });\n });\n it(\"addCollaborator handles successful response\", function (done) {\n mockReturn(\"\", 201, { location: \"/collaborators\" });\n manager.addCollaborator(\"appName\", \"email1\")\n .done(function (obj) {\n assert.ok(!obj);\n done();\n }, rejectHandler);\n });\n it(\"addCollaborator handles error response\", function (done) {\n mockReturn(\"\", 404, {});\n manager.addCollaborator(\"appName\", \"email1\")\n .done(function (obj) {\n throw new Error(\"Call should not complete successfully\");\n }, function (error) { return done(); });\n });\n it(\"getCollaborators handles success response with no collaborators\", function (done) {\n mockReturn(JSON.stringify({ collaborators: {} }), 200);\n manager.getCollaborators(\"appName\")\n .done(function (obj) {\n assert.ok(obj);\n assert.equal(Object.keys(obj).length, 0);\n done();\n }, rejectHandler);\n });\n it(\"getCollaborators handles success response with multiple collaborators\", function (done) {\n mockReturn(JSON.stringify({\n collaborators: {\n \"email1\": { permission: \"Owner\", isCurrentAccount: true },\n \"email2\": { permission: \"Collaborator\", isCurrentAccount: false }\n }\n }), 200);\n manager.getCollaborators(\"appName\")\n .done(function (obj) {\n assert.ok(obj);\n assert.equal(obj[\"email1\"].permission, \"Owner\");\n assert.equal(obj[\"email2\"].permission, \"Collaborator\");\n done();\n }, rejectHandler);\n });\n it(\"removeCollaborator handles success response\", function (done) {\n mockReturn(\"\", 200, {});\n manager.removeCollaborator(\"appName\", \"email1\")\n .done(function (obj) {\n assert.ok(!obj);\n done();\n }, rejectHandler);\n });\n it(\"patchRelease handles success response\", function (done) {\n mockReturn(JSON.stringify({ package: { description: \"newDescription\" } }), 200);\n manager.patchRelease(\"appName\", \"deploymentName\", \"label\", { description: \"newDescription\" })\n .done(function (obj) {\n assert.ok(!obj);\n done();\n }, rejectHandler);\n });\n it(\"patchRelease handles error response\", function (done) {\n mockReturn(\"\", 400);\n manager.patchRelease(\"appName\", \"deploymentName\", \"label\", {})\n .done(function (obj) {\n throw new Error(\"Call should not complete successfully\");\n }, function (error) { return done(); });\n });\n it(\"promote handles success response\", function (done) {\n mockReturn(JSON.stringify({ package: { description: \"newDescription\" } }), 200);\n manager.promote(\"appName\", \"deploymentName\", \"newDeploymentName\", { description: \"newDescription\" })\n .done(function (obj) {\n assert.ok(!obj);\n done();\n }, rejectHandler);\n });\n it(\"promote handles error response\", function (done) {\n mockReturn(\"\", 400);\n manager.promote(\"appName\", \"deploymentName\", \"newDeploymentName\", { rollout: 123 })\n .done(function (obj) {\n throw new Error(\"Call should not complete successfully\");\n }, function (error) { return done(); });\n });\n it(\"rollback handles success response\", function (done) {\n mockReturn(JSON.stringify({ package: { label: \"v1\" } }), 200);\n manager.rollback(\"appName\", \"deploymentName\", \"v1\")\n .done(function (obj) {\n assert.ok(!obj);\n done();\n }, rejectHandler);\n });\n it(\"rollback handles error response\", function (done) {\n mockReturn(\"\", 400);\n manager.rollback(\"appName\", \"deploymentName\", \"v1\")\n .done(function (obj) {\n throw new Error(\"Call should not complete successfully\");\n }, function (error) { return done(); });\n });\n});\n// Helper method that is used everywhere that an assert.fail() is needed in a promise handler\nfunction rejectHandler(val) {\n assert.fail();\n}\n// Wrapper for superagent-mock that abstracts away information not needed for SDK tests\nfunction mockReturn(bodyText, statusCode, header) {\n if (header === void 0) { header = {}; }\n require(\"superagent-mock\")(request, [{\n pattern: \"http://localhost/(\\\\w+)/?\",\n fixtures: function (match, params) {\n var isOk = statusCode >= 200 && statusCode < 300;\n if (!isOk) {\n var err = new Error(bodyText);\n err.status = statusCode;\n throw err;\n }\n return { text: bodyText, status: statusCode, ok: isOk, header: header, headers: {} };\n },\n callback: function (match, data) { return data; }\n }]);\n}\n"
},
{
"path": "plugins/code-push/test/superagent-mock-config.js",
"content": "// ./superagent-mock-config.js file\nmodule.exports = [\n {\n pattern: 'http://localhost/(\\\\w+)/',\n\n /**\n * returns the data\n *\n * @param match array Result of the resolution of the regular expression\n * @param params object sent by 'send' function\n */\n fixtures: function (match, params) {\n return {text: \"Error\", status: 403, ok: false};\n\n /**\n * example: \n * request.get('https://error.example/404').end(function(err, res){\n * console.log(err); // 404\n * }) \n */ \n if (match[1] === '404') {\n throw new Error(404);\n }\n\n /**\n * example: \n * request.get('https://error.example/200').end(function(err, res){\n * console.log(res.body); // \"Data fixtures\"\n * })\n */\n\n /**\n * example: \n * request.get('https://domain.send.example/').send({superhero: \"me\"}).end(function(err, res){\n * console.log(res.body); // \"Data fixtures - superhero:me\"\n * }) \n */\n if(params[\"superhero\"]) {\n return 'Data fixtures - superhero:' + params[\"superhero\"];\n } else {\n return 'Data fixtures';\n }\n },\n\n /**\n * returns the result of the request\n *\n * @param match array Result of the resolution of the regular expression\n * @param data mixed Data returns by `fixtures` attribute\n */\n callback: function (match, data) {\n return data;\n }\n },\n];"
},
{
"path": "plugins/cordova-plugin-appavailability/README.md",
"content": "# AppAvailability for iOS and Android\n\n`Version 0.4.2`\n\nA Plugin for Apache Cordova and Adobe PhoneGap by [ohh2ahh](http://ohh2ahh.com).\n\n1. [Description](https://github.com/ohh2ahh/AppAvailability#1-description)\n2. [Installation](https://github.com/ohh2ahh/AppAvailability#2-installation)\n\t2. [Automatically (Command-line Interface)](https://github.com/ohh2ahh/AppAvailability#automatically-command-line-interface)\n\t2. [PhoneGap Build](https://github.com/ohh2ahh/AppAvailability#phonegap-build)\n3. [Usage](https://github.com/ohh2ahh/AppAvailability#3-usage)\n\t3. [iOS](https://github.com/ohh2ahh/AppAvailability#ios)\n\t3. [Android](https://github.com/ohh2ahh/AppAvailability#android)\n\t3. [Full Example](https://github.com/ohh2ahh/AppAvailability#full-example)\n\t3. [Old Approach (AppAvailability < 0.3.0)](https://github.com/ohh2ahh/AppAvailability#old-approach-appavailability--030)\n4. [Some URI Schemes / Package Names](https://github.com/ohh2ahh/AppAvailability#4-some-uri-schemes--package-names)\n5. [License](https://github.com/ohh2ahh/AppAvailability#5-license)\n\n## Important: iOS 9 URL Scheme Whitelist\nApple changed the `canOpenURL` method on iOS 9. Apps which are checking for URL Schemes have to declare these Schemes as it is submitted to Apple. The article [Quick Take on iOS 9 URL Scheme Changes](http://awkwardhare.com/post/121196006730/quick-take-on-ios-9-url-scheme-changes) expains the changes in detail.\n\n### Add URL Schemes to the Whitelist\nSimply open your app's .plist (usually `platforms/ios//-Info.plist)` with an editor and add the following code with your needed Schemes.\n\n```xml\nLSApplicationQueriesSchemes\n\n twitter\n whatsapp\n\n```\n\n## 1. Description\n\nThis plugin allows you to check if an app is installed on the user's device.\nIt requires an URI Scheme (e.g. twitter://) on iOS or a Package Name (e.g com.twitter.android) on Android.\n\n* Ready for the Command-line Interface of Cordova / PhoneGap 3.0 and later\n* Works with PhoneGap Build ([more information](https://build.phonegap.com/plugins/17))\n\n### Supported Platforms\n\n* iOS\n* Android\n\n## 2. Installation\n\nThe Cordova CLI is the recommended way to install AppAvailability, see [The Command-line Interface](http://cordova.apache.org/docs/en/4.0.0/guide_cli_index.md.html#The%20Command-Line%20Interface). You can find the plugin on these registries:\n* [GitHub](https://github.com/ohh2ahh/AppAvailability)\n* [npm](https://www.npmjs.com/package/cordova-plugin-appavailability)\n* [Cordova Plugin Registry](http://plugins.cordova.io/#/package/com.ohh2ahh.plugins.appavailability) (deprecated [in favor of npm](http://cordova.apache.org/announcements/2015/04/21/plugins-release-and-move-to-npm.html))\n* [PhoneGap Plugin Registry](https://build.phonegap.com/plugins/1054) (deprecated because updating a plugin on PhoneGap Build requires a paid plan now)\n\n### Automatically (Command-line Interface)\n\nSimply run this command to add the latest version of AppAvailability from [npm](https://www.npmjs.com/package/cordova-plugin-appavailability) to your project:\n```\n$ cordova plugin add cordova-plugin-appavailability\n```\n\nDon't forget to prepare and compile your project:\n```\n$ cordova build\n```\n\nYou don't have to reference the JavaScript in your `index.html`.\n\nAlternatively you can install AppAvailability from [GitHub](https://github.com/ohh2ahh/AppAvailability):\n```\n$ cordova plugin add https://github.com/ohh2ahh/AppAvailability.git\n```\n\n### PhoneGap Build\n\nAppAvailability works with PhoneGap build too. **Unfortunately PhoneGap Build requires now a paid plan to update a plugin. Therefore the version on PhoneGap Build is deprecated.**\n\nYou can implement version `0.3.1` of the plugin by adding the following xml to your `config.xml`:\n```xml\n\n```\nOr if you want to use the exact version of AppAvailability:\n```xml\n\n```\n\nThere is no need to reference the JavaScript in your `index.html`.\n\nYou can find a PhoneGap Build project which demonstrates AppAvailability in the repository [ohh2ahh/AppAvailability-Demo-PhoneGap-Build](https://github.com/ohh2ahh/AppAvailability-Demo-PhoneGap-Build).\n\n## 3. Usage\n\n:exclamation: The code changed in version 0.3.0 and supports now success and error callbacks! But you can still use the old approach, which is [described below](https://github.com/ohh2ahh/AppAvailability#old-approach-appavailability--030).\n\n### iOS\n\n```javascript\nappAvailability.check(\n 'twitter://', // URI Scheme\n function() { // Success callback\n console.log('Twitter is available');\n },\n function() { // Error callback\n console.log('Twitter is not available');\n }\n);\n```\n\n### Android\n\n```javascript\nappAvailability.check(\n 'com.twitter.android', // Package Name\n function() { // Success callback\n console.log('Twitter is available');\n },\n function() { // Error callback\n console.log('Twitter is not available');\n }\n);\n```\n\n### Full Example\n\n```javascript\nvar scheme;\n\n// Don't forget to add the org.apache.cordova.device plugin!\nif(device.platform === 'iOS') {\n scheme = 'twitter://';\n}\nelse if(device.platform === 'Android') {\n scheme = 'com.twitter.android';\n}\n\nappAvailability.check(\n scheme, // URI Scheme or Package Name\n function() { // Success callback\n console.log(scheme + ' is available :)');\n },\n function() { // Error callback\n console.log(scheme + ' is not available :(');\n }\n);\n```\n\n### Old Approach (AppAvailability < 0.3.0)\n\nThe only thing you have to do is replacing `appAvailability.check` with `appAvailability.checkBool`:\n\n```javascript\nappAvailability.checkBool('twitter://', function(availability) {\n // availability is either true or false\n if(availability) { console.log('Twitter is available'); }\n});\n```\n\n## 4. Some URI Schemes / Package Names\n\n[How do I get the URI Scheme / Package Name?](https://github.com/ohh2ahh/AppAvailability/issues/2#issuecomment-22203591)\n\nTwitter:\n* iOS: `twitter://` ([more Schemes](http://wiki.akosma.com/IPhone_URL_Schemes#Twitter))\n* Android: `com.twitter.android`\n\nFacebook:\n* iOS: `fb://` (and [many more](http://wiki.akosma.com/IPhone_URL_Schemes#Facebook) as `fb://profile`)\n* Android: `com.facebook.katana`\n\nWhatsApp:\n* iOS: `whatsapp://` (only since v. 2.10.1, [more information](http://www.whatsapp.com/faq/en/iphone/23559013))\n* Android: `com.whatsapp`\n\n## 5. License\n\n[The MIT License (MIT)](http://www.opensource.org/licenses/mit-license.html)\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE."
},
{
"path": "plugins/cordova-plugin-appavailability/package.json",
"content": "{\n \"name\": \"cordova-plugin-appavailability\",\n \"version\": \"0.4.2\",\n \"description\": \"This plugin for Cordova and PhoneGap allows you to check if an app is installed. It requires an URI Scheme (iOS) or a Package Name (Android).\",\n \"cordova\": {\n \"id\": \"cordova-plugin-appavailability\",\n \"platforms\": [\n \"ios\",\n \"android\"\n ]\n },\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"git+https://github.com/ohh2ahh/AppAvailability.git\"\n },\n \"keywords\": [\n \"Cordova\",\n \"PhoneGap\",\n \"plugin\",\n \"app\",\n \"availability\",\n \"installed\",\n \"URIScheme\",\n \"URI\",\n \"Scheme\",\n \"PackageName\",\n \"Package\",\n \"Name\",\n \"iOS\",\n \"Android\",\n \"ecosystem:cordova\",\n \"cordova-ios\",\n \"cordova-android\"\n ],\n \"engines\": [\n {\n \"name\": \"cordova\",\n \"version\": \">=3.0.0\"\n }\n ],\n \"author\": \"ohh2ahh\",\n \"license\": \"MIT\",\n \"bugs\": {\n \"url\": \"https://github.com/ohh2ahh/AppAvailability/issues\"\n },\n \"homepage\": \"https://github.com/ohh2ahh/AppAvailability#readme\"\n}\n"
},
{
"path": "plugins/cordova-plugin-appavailability/plugin.xml",
"content": "\n\n\n \n AppAvailability\n \n This plugin for Cordova and PhoneGap allows you to check if an app is installed. It requires an URI Scheme (iOS) or a Package Name (Android).\n \n Cordova,PhoneGap,plugin,app,availability,installed, URIScheme,URI,Scheme,PackageName,Package,Name,iOS,Android\n \n https://github.com/ohh2ahh/AppAvailability.git\n https://github.com/ohh2ahh/AppAvailability/issues\n \n MIT\n \n \n =3.0.0\" />\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "plugins/cordova-plugin-appavailability/src/android/AppAvailability.java",
"content": "package com.ohh2ahh.appavailability;\n\nimport org.apache.cordova.CallbackContext;\nimport org.apache.cordova.CordovaPlugin;\nimport org.json.JSONArray;\nimport org.json.JSONException;\n\nimport android.content.Context;\nimport android.content.pm.PackageManager;\n\npublic class AppAvailability extends CordovaPlugin {\n @Override\n public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException {\n if(action.equals(\"checkAvailability\")) {\n String uri = args.getString(0);\n this.checkAvailability(uri, callbackContext);\n return true;\n }\n return false;\n }\n \n // Thanks to http://floresosvaldo.com/android-cordova-plugin-checking-if-an-app-exists\n public boolean appInstalled(String uri) {\n Context ctx = this.cordova.getActivity().getApplicationContext();\n final PackageManager pm = ctx.getPackageManager();\n boolean app_installed = false;\n try {\n pm.getPackageInfo(uri, PackageManager.GET_ACTIVITIES);\n app_installed = true;\n }\n catch(PackageManager.NameNotFoundException e) {\n app_installed = false;\n }\n return app_installed;\n }\n \n private void checkAvailability(String uri, CallbackContext callbackContext) {\n if(appInstalled(uri)) {\n callbackContext.success();\n }\n else {\n callbackContext.error(\"\");\n }\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-appavailability/src/ios/AppAvailability.h",
"content": "#import \n\n@interface AppAvailability : CDVPlugin\n\n- (void)checkAvailability:(CDVInvokedUrlCommand*)command;\n\n@end"
},
{
"path": "plugins/cordova-plugin-appavailability/src/ios/AppAvailability.m",
"content": "#import \"AppAvailability.h\"\n#import \n\n@implementation AppAvailability\n\n- (void)checkAvailability:(CDVInvokedUrlCommand*)command {\n \n CDVPluginResult* pluginResult = nil;\n \n NSString* scheme = [command.arguments objectAtIndex:0];\n \n if ([[UIApplication sharedApplication] canOpenURL:[NSURL URLWithString:scheme]]) {\n pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsBool:(true)];\n }\n else {\n pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsBool:(false)];\n }\n \n [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];\n \n}\n\n@end"
},
{
"path": "plugins/cordova-plugin-appavailability/www/AppAvailability.js",
"content": "var appAvailability = {\n \n check: function(urlScheme, successCallback, errorCallback) {\n cordova.exec(\n successCallback,\n errorCallback,\n \"AppAvailability\",\n \"checkAvailability\",\n [urlScheme]\n );\n },\n \n checkBool: function(urlScheme, callback) {\n cordova.exec(\n function(success) { callback(success); },\n function(error) { callback(error); },\n \"AppAvailability\",\n \"checkAvailability\",\n [urlScheme]\n );\n }\n \n};\n\nmodule.exports = appAvailability;"
},
{
"path": "plugins/cordova-plugin-code-push/CONTRIBUTING.md",
"content": "# Contributing\n\n## TypeScript\n\nAll the JS code in this plugin is compiled from TypeScript sources. Please do not submit pull requests with direct changes to the JS files in ```bin``` directory.\nInstead, modify the sources in the ```www``` folder and compile a new version of the plugin. Read on for more details.\n\n## Building the plugin\n\n### Environment setup\n\n```node.js``` and ```npm``` are needed for building this project. ```npm``` comes bundled with the ```node.js``` installer. You can download the ```node.js``` installer here: https://nodejs.org/download/. \n\n### Compile\n\nFollow these steps to build a new version of the plugin:\n- clone this repository\n- install the dependencies\n\n\tNavigate to the root folder from your command line console and run:\n\t```\n\tnpm install\n\t```\n- compile\n\n\tFrom the same root folder location, run:\n\t```\n\tgulp\n\t```\n\tThis will compile the sources and place them in the ```bin``` folder. Any compilation errors will be displayed in the console.\n\n## Test\n\n### Environment setup\n\nMake sure you can build the plugin by following the steps above.\n\nTo run Android tests, make sure you have ```sdk\\tools``` and ```sdk\\platform-tools``` in your PATH.\n\n### Supported platforms\n\nThe plugin has end to end tests for Android and iOS. Depending on your development machine OS, you can run some or all the tests.\n\nOS | Supported tests\n------------- | -------------\nOS X | Android, iOS\nWindows | Android\n\n### Test descriptions\n\nThe tests first build the app.\n\nThey then check if the required emulators are currently running.\n\nIf an Android emulator is not running, it attempts to boot an Android emulator named ```emulator```. You can specify an emulator by adding ```--androidemu yourEmulatorNameHere``` as a command line option to the gulp task.\n\nIf an iOS simulator is not running, it attempts to boot the latest iOS iPhone simulator. You can specify a simulator by adding ```--iosemu yourSimulatorNameHere``` as a command line option to the gulp task.\n\nIf all the required emulators are not running and the tests fail to boot them, the tests will fail.\n\nIf you would like the tests to always restart the necessary emulators (killing them if they are currently running), add a ```--clean``` flag to the command.\n\nThe desired unit tests are then run.\n\nIf you would like to skip building, add a ```-fast``` to the end of the command you'd like to run. For example, ```gulp test-ios``` becomes ```gulp test-ios-fast```.\n\nThere is a both a full unit test suite and a \"core\" set of unit tests that you may run. If you would like to run only the core tests, add a ```--core``` flag to the command.\n\nIf you would like to pull the plugin from NPM rather than running the tests on the local version, add a ```--npm``` flag to the command.\n\n#### Default\n\nTo run all of the unit tests on Android and iOS with both UIWebView and WkWebView:\n```\ngulp test\n```\n\n#### iOS\n\nTo run all of the unit tests on iOS with both the UIWebView and WkWebView:\n```\ngulp test-ios\n```\n\nTo run all of the unit tests on iOS with the UIWebView:\n```\ngulp test-ios-ui\n```\n\nTo run all of the unit tests on iOS with the WkWebView:\n```\ngulp test-ios-wk\n```\n\n#### Android\n\nTo run all of the unit tests on Android:\n```\ngulp test-android\n```\n\n#### More examples\n\nAll possible testing configurations have tasks!\n\nThe platforms are ordered as follows, and ran in that order:\nandroid, ios-ui, ios-wk\n\nTo run the core unit tests on Android:\n```\ngulp test-android --core\n```\n\nTo run all of the unit tests on iOS with the UIWebView and pull the plugin from NPM:\n```\ngulp test-ios-ui --npm\n```\n\nTo run all of the unit tests on Android and iOS with the UIWebView without building first:\n```\ngulp test-android-ios-ui-fast\n```\n\nTo run all of the unit tests on iOS with the WkWebView and restart the emulators:\n```\ngulp test-ios-wk --clean\n```\n\nTo run the core unit tests on Android and pull the plugin from NPM:\n```\ngulp test-android --core --npm\n```\n\n...and so on!"
},
{
"path": "plugins/cordova-plugin-code-push/LICENSE.md",
"content": "Microsoft CodePush Plugin for Apache Cordova \n\nCopyright (c) Microsoft Corporation\n\nAll rights reserved. \n\nMIT License\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"\", to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n"
},
{
"path": "plugins/cordova-plugin-code-push/bin/www/codePush.js",
"content": "\n /******************************************************************************************** \n \t THIS FILE HAS BEEN COMPILED FROM TYPESCRIPT SOURCES. \n \t PLEASE DO NOT MODIFY THIS FILE AS YOU WILL LOSE YOUR CHANGES WHEN RECOMPILING. \n \t ALSO, PLEASE DO NOT SUBMIT PULL REQUESTS WITH CHANGES TO THIS FILE. \n \t INSTEAD, EDIT THE TYPESCRIPT SOURCES UNDER THE WWW FOLDER. \n \t FOR MORE INFORMATION, PLEASE SEE CONTRIBUTING.md. \n *********************************************************************************************/ \n\n\n\"use strict\";\nvar LocalPackage = require(\"./localPackage\");\nvar RemotePackage = require(\"./remotePackage\");\nvar CodePushUtil = require(\"./codePushUtil\");\nvar NativeAppInfo = require(\"./nativeAppInfo\");\nvar Sdk = require(\"./sdk\");\nvar SyncStatus = require(\"./syncStatus\");\nvar CodePush = (function () {\n function CodePush() {\n }\n CodePush.prototype.notifyApplicationReady = function (notifySucceeded, notifyFailed) {\n cordova.exec(notifySucceeded, notifyFailed, \"CodePush\", \"updateSuccess\", []);\n };\n CodePush.prototype.restartApplication = function (installSuccess, errorCallback) {\n cordova.exec(installSuccess, errorCallback, \"CodePush\", \"restartApplication\", []);\n };\n CodePush.prototype.reportStatus = function (status, label, appVersion, currentDeploymentKey, previousLabelOrAppVersion, previousDeploymentKey) {\n try {\n var createPackageForReporting = function (label, appVersion) {\n return {\n label: label, appVersion: appVersion,\n deploymentKey: currentDeploymentKey, description: null,\n isMandatory: false, packageHash: null,\n packageSize: null, failedInstall: false\n };\n };\n switch (status) {\n case ReportStatus.STORE_VERSION:\n Sdk.reportStatusDeploy(null, AcquisitionStatus.DeploymentSucceeded, currentDeploymentKey, previousLabelOrAppVersion, previousDeploymentKey);\n break;\n case ReportStatus.UPDATE_CONFIRMED:\n Sdk.reportStatusDeploy(createPackageForReporting(label, appVersion), AcquisitionStatus.DeploymentSucceeded, currentDeploymentKey, previousLabelOrAppVersion, previousDeploymentKey);\n break;\n case ReportStatus.UPDATE_ROLLED_BACK:\n Sdk.reportStatusDeploy(createPackageForReporting(label, appVersion), AcquisitionStatus.DeploymentFailed, currentDeploymentKey, previousLabelOrAppVersion, previousDeploymentKey);\n break;\n }\n }\n catch (e) {\n CodePushUtil.logError(\"An error occurred while reporting.\" + CodePushUtil.getErrorMessage(e));\n }\n };\n CodePush.prototype.getCurrentPackage = function (packageSuccess, packageError) {\n NativeAppInfo.isPendingUpdate(function (pendingUpdate) {\n var packageInfoFile = pendingUpdate ? LocalPackage.OldPackageInfoFile : LocalPackage.PackageInfoFile;\n LocalPackage.getPackageInfoOrNull(packageInfoFile, packageSuccess, packageError);\n });\n };\n CodePush.prototype.getPendingPackage = function (packageSuccess, packageError) {\n NativeAppInfo.isPendingUpdate(function (pendingUpdate) {\n if (pendingUpdate) {\n LocalPackage.getPackageInfoOrNull(LocalPackage.PackageInfoFile, packageSuccess, packageError);\n }\n else {\n packageSuccess(null);\n }\n });\n };\n CodePush.prototype.checkForUpdate = function (querySuccess, queryError, deploymentKey) {\n try {\n var callback = function (error, remotePackageOrUpdateNotification) {\n if (error) {\n CodePushUtil.invokeErrorCallback(error, queryError);\n }\n else {\n var appUpToDate = function () {\n CodePushUtil.logMessage(\"App is up to date.\");\n querySuccess && querySuccess(null);\n };\n if (remotePackageOrUpdateNotification) {\n if (remotePackageOrUpdateNotification.updateAppVersion) {\n CodePushUtil.logMessage(\"An update is available, but it is targeting a newer binary version than you are currently running.\");\n appUpToDate();\n }\n else {\n var remotePackage = remotePackageOrUpdateNotification;\n NativeAppInfo.isFailedUpdate(remotePackage.packageHash, function (installFailed) {\n var result = new RemotePackage();\n result.appVersion = remotePackage.appVersion;\n result.deploymentKey = deploymentKey;\n result.description = remotePackage.description;\n result.downloadUrl = remotePackage.downloadUrl;\n result.isMandatory = remotePackage.isMandatory;\n result.label = remotePackage.label;\n result.packageHash = remotePackage.packageHash;\n result.packageSize = remotePackage.packageSize;\n result.failedInstall = installFailed;\n CodePushUtil.logMessage(\"An update is available. \" + JSON.stringify(result));\n querySuccess && querySuccess(result);\n });\n }\n }\n else {\n appUpToDate();\n }\n }\n };\n var queryUpdate = function () {\n Sdk.getAcquisitionManager(function (initError, acquisitionManager) {\n if (initError) {\n CodePushUtil.invokeErrorCallback(initError, queryError);\n }\n else {\n LocalPackage.getCurrentOrDefaultPackage(function (localPackage) {\n CodePushUtil.logMessage(\"Checking for update.\");\n acquisitionManager.queryUpdateWithCurrentPackage(localPackage, callback);\n }, function (error) {\n CodePushUtil.invokeErrorCallback(error, queryError);\n });\n }\n }, deploymentKey);\n };\n if (deploymentKey) {\n queryUpdate();\n }\n else {\n NativeAppInfo.getDeploymentKey(function (deploymentKeyError, defaultDeploymentKey) {\n if (deploymentKeyError) {\n CodePushUtil.invokeErrorCallback(deploymentKeyError, queryError);\n }\n else {\n deploymentKey = defaultDeploymentKey;\n queryUpdate();\n }\n });\n }\n }\n catch (e) {\n CodePushUtil.invokeErrorCallback(new Error(\"An error occurred while querying for updates.\" + CodePushUtil.getErrorMessage(e)), queryError);\n }\n };\n CodePush.prototype.sync = function (syncCallback, syncOptions, downloadProgress) {\n if (CodePush.SyncInProgress) {\n CodePushUtil.logMessage(\"Sync already in progress.\");\n syncCallback && syncCallback(SyncStatus.IN_PROGRESS);\n }\n else {\n var syncCallbackAndUpdateSyncInProgress = function (result) {\n switch (result) {\n case SyncStatus.ERROR:\n case SyncStatus.IN_PROGRESS:\n case SyncStatus.UP_TO_DATE:\n case SyncStatus.UPDATE_IGNORED:\n case SyncStatus.UPDATE_INSTALLED:\n CodePush.SyncInProgress = false;\n default:\n break;\n }\n syncCallback && syncCallback(result);\n };\n CodePush.SyncInProgress = true;\n this.syncInternal(syncCallbackAndUpdateSyncInProgress, syncOptions, downloadProgress);\n }\n };\n CodePush.prototype.syncInternal = function (syncCallback, syncOptions, downloadProgress) {\n if (!syncOptions) {\n syncOptions = this.getDefaultSyncOptions();\n }\n else {\n var defaultDialogOptions = this.getDefaultUpdateDialogOptions();\n if (syncOptions.updateDialog) {\n if (typeof syncOptions.updateDialog !== typeof ({})) {\n syncOptions.updateDialog = defaultDialogOptions;\n }\n else {\n CodePushUtil.copyUnassignedMembers(defaultDialogOptions, syncOptions.updateDialog);\n }\n }\n var defaultOptions = this.getDefaultSyncOptions();\n CodePushUtil.copyUnassignedMembers(defaultOptions, syncOptions);\n }\n window.codePush.notifyApplicationReady();\n var onError = function (error) {\n CodePushUtil.logError(\"An error occurred during sync.\", error);\n syncCallback && syncCallback(SyncStatus.ERROR);\n };\n var onInstallSuccess = function (appliedWhen) {\n switch (appliedWhen) {\n case InstallMode.ON_NEXT_RESTART:\n CodePushUtil.logMessage(\"Update is installed and will be run on the next app restart.\");\n break;\n case InstallMode.ON_NEXT_RESUME:\n if (syncOptions.minimumBackgroundDuration > 0) {\n CodePushUtil.logMessage(\"Update is installed and will be run after the app has been in the background for at least \" + syncOptions.minimumBackgroundDuration + \" seconds.\");\n }\n else {\n CodePushUtil.logMessage(\"Update is installed and will be run when the app next resumes.\");\n }\n break;\n }\n syncCallback && syncCallback(SyncStatus.UPDATE_INSTALLED);\n };\n var onDownloadSuccess = function (localPackage) {\n syncCallback && syncCallback(SyncStatus.INSTALLING_UPDATE);\n localPackage.install(onInstallSuccess, onError, syncOptions);\n };\n var downloadAndInstallUpdate = function (remotePackage) {\n syncCallback && syncCallback(SyncStatus.DOWNLOADING_PACKAGE);\n remotePackage.download(onDownloadSuccess, onError, downloadProgress);\n };\n var onUpdate = function (remotePackage) {\n var updateShouldBeIgnored = remotePackage && (remotePackage.failedInstall && syncOptions.ignoreFailedUpdates);\n if (!remotePackage || updateShouldBeIgnored) {\n if (updateShouldBeIgnored) {\n CodePushUtil.logMessage(\"An update is available, but it is being ignored due to have been previously rolled back.\");\n }\n syncCallback && syncCallback(SyncStatus.UP_TO_DATE);\n }\n else {\n var dlgOpts = syncOptions.updateDialog;\n if (dlgOpts) {\n CodePushUtil.logMessage(\"Awaiting user action.\");\n syncCallback && syncCallback(SyncStatus.AWAITING_USER_ACTION);\n }\n if (remotePackage.isMandatory && syncOptions.updateDialog) {\n var message = dlgOpts.appendReleaseDescription ?\n dlgOpts.mandatoryUpdateMessage + dlgOpts.descriptionPrefix + remotePackage.description\n : dlgOpts.mandatoryUpdateMessage;\n navigator.notification.alert(message, function () { downloadAndInstallUpdate(remotePackage); }, dlgOpts.updateTitle, dlgOpts.mandatoryContinueButtonLabel);\n }\n else if (!remotePackage.isMandatory && syncOptions.updateDialog) {\n var optionalUpdateCallback = function (buttonIndex) {\n switch (buttonIndex) {\n case 1:\n downloadAndInstallUpdate(remotePackage);\n break;\n case 2:\n default:\n CodePushUtil.logMessage(\"User cancelled the update.\");\n syncCallback && syncCallback(SyncStatus.UPDATE_IGNORED);\n break;\n }\n };\n var message = dlgOpts.appendReleaseDescription ?\n dlgOpts.optionalUpdateMessage + dlgOpts.descriptionPrefix + remotePackage.description\n : dlgOpts.optionalUpdateMessage;\n navigator.notification.confirm(message, optionalUpdateCallback, dlgOpts.updateTitle, [dlgOpts.optionalInstallButtonLabel, dlgOpts.optionalIgnoreButtonLabel]);\n }\n else {\n downloadAndInstallUpdate(remotePackage);\n }\n }\n };\n syncCallback && syncCallback(SyncStatus.CHECKING_FOR_UPDATE);\n window.codePush.checkForUpdate(onUpdate, onError, syncOptions.deploymentKey);\n };\n CodePush.prototype.getDefaultSyncOptions = function () {\n if (!CodePush.DefaultSyncOptions) {\n CodePush.DefaultSyncOptions = {\n ignoreFailedUpdates: true,\n installMode: InstallMode.ON_NEXT_RESTART,\n minimumBackgroundDuration: 0,\n mandatoryInstallMode: InstallMode.IMMEDIATE,\n updateDialog: false,\n deploymentKey: undefined\n };\n }\n return CodePush.DefaultSyncOptions;\n };\n CodePush.prototype.getDefaultUpdateDialogOptions = function () {\n if (!CodePush.DefaultUpdateDialogOptions) {\n CodePush.DefaultUpdateDialogOptions = {\n updateTitle: \"Update available\",\n mandatoryUpdateMessage: \"An update is available that must be installed.\",\n mandatoryContinueButtonLabel: \"Continue\",\n optionalUpdateMessage: \"An update is available. Would you like to install it?\",\n optionalInstallButtonLabel: \"Install\",\n optionalIgnoreButtonLabel: \"Ignore\",\n appendReleaseDescription: false,\n descriptionPrefix: \" Description: \"\n };\n }\n return CodePush.DefaultUpdateDialogOptions;\n };\n return CodePush;\n}());\nvar ReportStatus;\n(function (ReportStatus) {\n ReportStatus[ReportStatus[\"STORE_VERSION\"] = 0] = \"STORE_VERSION\";\n ReportStatus[ReportStatus[\"UPDATE_CONFIRMED\"] = 1] = \"UPDATE_CONFIRMED\";\n ReportStatus[ReportStatus[\"UPDATE_ROLLED_BACK\"] = 2] = \"UPDATE_ROLLED_BACK\";\n})(ReportStatus || (ReportStatus = {}));\nvar instance = new CodePush();\nmodule.exports = instance;\n"
},
{
"path": "plugins/cordova-plugin-code-push/bin/www/codePushUtil.js",
"content": "\n /******************************************************************************************** \n \t THIS FILE HAS BEEN COMPILED FROM TYPESCRIPT SOURCES. \n \t PLEASE DO NOT MODIFY THIS FILE AS YOU WILL LOSE YOUR CHANGES WHEN RECOMPILING. \n \t ALSO, PLEASE DO NOT SUBMIT PULL REQUESTS WITH CHANGES TO THIS FILE. \n \t INSTEAD, EDIT THE TYPESCRIPT SOURCES UNDER THE WWW FOLDER. \n \t FOR MORE INFORMATION, PLEASE SEE CONTRIBUTING.md. \n *********************************************************************************************/ \n\n\n\"use strict\";\nvar CodePushUtil = (function () {\n function CodePushUtil() {\n }\n CodePushUtil.copyUnassignedMembers = function (fromParameter, toParameter) {\n for (var key in fromParameter) {\n if (toParameter[key] === undefined || toParameter[key] === null) {\n toParameter[key] = fromParameter[key];\n }\n }\n };\n CodePushUtil.getNodeStyleCallbackFor = function (successCallback, errorCallback) {\n return function (error, result) {\n if (error) {\n errorCallback && errorCallback(error);\n }\n else {\n successCallback && successCallback(result);\n }\n };\n };\n CodePushUtil.getErrorMessage = function (e) {\n return e && e.message || e && e.toString() || \"\";\n };\n CodePushUtil.logMessage = function (msg) {\n console.log(CodePushUtil.TAG + \" \" + msg);\n };\n CodePushUtil.logError = function (message, error) {\n var errorMessage = message || \"\" + \" \" + CodePushUtil.getErrorMessage(error);\n console.error(CodePushUtil.TAG + \" \" + errorMessage);\n };\n CodePushUtil.TAG = \"[CodePush]\";\n CodePushUtil.invokeErrorCallback = function (error, errorCallback) {\n CodePushUtil.logError(null, error);\n errorCallback && errorCallback(error);\n };\n return CodePushUtil;\n}());\nmodule.exports = CodePushUtil;\n"
},
{
"path": "plugins/cordova-plugin-code-push/bin/www/fileUtil.js",
"content": "\n /******************************************************************************************** \n \t THIS FILE HAS BEEN COMPILED FROM TYPESCRIPT SOURCES. \n \t PLEASE DO NOT MODIFY THIS FILE AS YOU WILL LOSE YOUR CHANGES WHEN RECOMPILING. \n \t ALSO, PLEASE DO NOT SUBMIT PULL REQUESTS WITH CHANGES TO THIS FILE. \n \t INSTEAD, EDIT THE TYPESCRIPT SOURCES UNDER THE WWW FOLDER. \n \t FOR MORE INFORMATION, PLEASE SEE CONTRIBUTING.md. \n *********************************************************************************************/ \n\n\n\"use strict\";\nvar FileUtil = (function () {\n function FileUtil() {\n }\n FileUtil.directoryExists = function (rootUri, path, callback) {\n FileUtil.getDirectory(rootUri, path, false, function (error, dirEntry) {\n var dirExists = !error && !!dirEntry;\n callback(null, dirExists);\n });\n };\n FileUtil.fileErrorToError = function (fileError, message) {\n return new Error((message ? message : \"An error has occurred while performing the operation. \") + \" Error code: \" + fileError.code);\n };\n FileUtil.getDataDirectory = function (path, createIfNotExists, callback) {\n FileUtil.getDirectory(cordova.file.dataDirectory, path, createIfNotExists, callback);\n };\n FileUtil.writeStringToDataFile = function (content, path, fileName, createIfNotExists, callback) {\n FileUtil.writeStringToFile(content, cordova.file.dataDirectory, path, fileName, createIfNotExists, callback);\n };\n FileUtil.getApplicationDirectory = function (path, callback) {\n FileUtil.getApplicationEntry(path, callback);\n };\n FileUtil.getApplicationFile = function (path, callback) {\n FileUtil.getApplicationEntry(path, callback);\n };\n FileUtil.getOrCreateFile = function (parent, path, createIfNotExists, success, fail) {\n var failFirst = function (error) {\n if (!createIfNotExists) {\n fail(error);\n }\n else {\n parent.getFile(path, { create: true, exclusive: false }, success, fail);\n }\n };\n parent.getFile(path, { create: false, exclusive: false }, success, failFirst);\n };\n FileUtil.getFile = function (rootUri, path, fileName, createIfNotExists, callback) {\n FileUtil.getDirectory(rootUri, path, createIfNotExists, function (error, directoryEntry) {\n if (error) {\n callback(error, null);\n }\n else {\n FileUtil.getOrCreateFile(directoryEntry, fileName, createIfNotExists, function (entry) { callback(null, entry); }, function (error) { callback(FileUtil.fileErrorToError(error), null); });\n }\n });\n };\n FileUtil.getDataFile = function (path, fileName, createIfNotExists, callback) {\n FileUtil.getFile(cordova.file.dataDirectory, path, fileName, createIfNotExists, callback);\n };\n FileUtil.fileExists = function (rootUri, path, fileName, callback) {\n FileUtil.getFile(rootUri, path, fileName, false, function (error, fileEntry) {\n var exists = !error && !!fileEntry;\n callback(null, exists);\n });\n };\n FileUtil.getDirectory = function (rootUri, path, createIfNotExists, callback) {\n var pathArray = path.split(\"/\");\n var currentDir;\n var currentIndex = 0;\n var appDirError = function (error) {\n callback(new Error(\"Could not get application subdirectory. Error code: \" + error.code), null);\n };\n var rootDirSuccess = function (appDir) {\n if (!createIfNotExists) {\n appDir.getDirectory(path, { create: false, exclusive: false }, function (directoryEntry) { callback(null, directoryEntry); }, appDirError);\n }\n else {\n currentDir = appDir;\n if (currentIndex >= pathArray.length) {\n callback(null, appDir);\n }\n else {\n var currentPath = pathArray[currentIndex];\n currentIndex++;\n if (currentPath) {\n FileUtil.getOrCreateSubDirectory(appDir, currentPath, createIfNotExists, rootDirSuccess, appDirError);\n }\n else {\n rootDirSuccess(appDir);\n }\n }\n }\n };\n window.resolveLocalFileSystemURL(rootUri, rootDirSuccess, appDirError);\n };\n FileUtil.dataDirectoryExists = function (path, callback) {\n FileUtil.directoryExists(cordova.file.dataDirectory, path, callback);\n };\n FileUtil.copyDirectoryEntriesTo = function (sourceDir, destinationDir, callback) {\n var fail = function (error) {\n callback(FileUtil.fileErrorToError(error), null);\n };\n var success = function (entries) {\n var i = 0;\n var copyOne = function () {\n if (i < entries.length) {\n var nextEntry = entries[i++];\n var entryAlreadyInDestination = function (destinationEntry) {\n var replaceError = function (fileError) {\n callback(new Error(\"Error during entry replacement. Error code: \" + fileError.code), null);\n };\n if (destinationEntry.isDirectory) {\n FileUtil.copyDirectoryEntriesTo(nextEntry, destinationEntry, function (error) {\n if (error) {\n callback(error, null);\n }\n else {\n copyOne();\n }\n });\n }\n else {\n var fileEntry = destinationEntry;\n fileEntry.remove(function () {\n nextEntry.copyTo(destinationDir, nextEntry.name, copyOne, fail);\n }, replaceError);\n }\n };\n var entryNotInDestination = function (error) {\n nextEntry.copyTo(destinationDir, nextEntry.name, copyOne, fail);\n };\n FileUtil.entryExistsInDirectory(nextEntry, destinationDir, entryAlreadyInDestination, entryNotInDestination);\n }\n else {\n callback(null, null);\n }\n };\n copyOne();\n };\n var directoryReader = sourceDir.createReader();\n directoryReader.readEntries(success, fail);\n };\n FileUtil.entryExistsInDirectory = function (entry, destinationDir, exists, doesNotExist) {\n var options = { create: false, exclusive: false };\n if (entry.isDirectory) {\n destinationDir.getDirectory(entry.name, options, exists, doesNotExist);\n }\n else {\n destinationDir.getFile(entry.name, options, exists, doesNotExist);\n }\n };\n FileUtil.deleteDirectory = function (dirLocation, deleteDirCallback) {\n FileUtil.getDataDirectory(dirLocation, false, function (oldDirError, dirToDelete) {\n if (oldDirError) {\n deleteDirCallback(oldDirError, null);\n }\n else {\n var win = function () { deleteDirCallback(null, null); };\n var fail = function (e) { deleteDirCallback(FileUtil.fileErrorToError(e), null); };\n dirToDelete.removeRecursively(win, fail);\n }\n });\n };\n FileUtil.deleteEntriesFromDataDirectory = function (dirPath, filesToDelete, callback) {\n FileUtil.getDataDirectory(dirPath, false, function (error, rootDir) {\n if (error) {\n callback(error, null);\n }\n else {\n var i = 0;\n var deleteOne = function () {\n if (i < filesToDelete.length) {\n var continueDeleting = function () {\n i++;\n deleteOne();\n };\n var fail = function (error) {\n console.log(\"Could not delete file: \" + filesToDelete[i]);\n continueDeleting();\n };\n var success = function (entry) {\n entry.remove(continueDeleting, fail);\n };\n rootDir.getFile(filesToDelete[i], { create: false, exclusive: false }, success, fail);\n }\n else {\n callback(null, null);\n }\n };\n deleteOne();\n }\n });\n };\n FileUtil.writeStringToFile = function (content, rootUri, path, fileName, createIfNotExists, callback) {\n var gotFile = function (fileEntry) {\n fileEntry.createWriter(function (writer) {\n writer.onwriteend = function (ev) {\n callback(null, null);\n };\n writer.onerror = function (ev) {\n callback(writer.error, null);\n };\n writer.write(content);\n }, function (error) {\n callback(new Error(\"Could write the current package information file. Error code: \" + error.code), null);\n });\n };\n FileUtil.getFile(rootUri, path, fileName, createIfNotExists, function (error, fileEntry) {\n if (error) {\n callback(error, null);\n }\n else {\n gotFile(fileEntry);\n }\n });\n };\n FileUtil.readFileEntry = function (fileEntry, callback) {\n fileEntry.file(function (file) {\n var fileReader = new FileReader();\n fileReader.onloadend = function (ev) {\n callback(null, ev.target.result);\n };\n fileReader.onerror = function (ev) {\n callback(new Error(\"Could not get file. Error: \" + ev.error), null);\n };\n fileReader.readAsText(file);\n }, function (error) {\n callback(new Error(\"Could not get file. Error code: \" + error.code), null);\n });\n };\n FileUtil.readFile = function (rootUri, path, fileName, callback) {\n FileUtil.getFile(rootUri, path, fileName, false, function (error, fileEntry) {\n if (error) {\n callback(error, null);\n }\n else {\n FileUtil.readFileEntry(fileEntry, callback);\n }\n });\n };\n FileUtil.readDataFile = function (path, fileName, callback) {\n FileUtil.readFile(cordova.file.dataDirectory, path, fileName, callback);\n };\n FileUtil.getApplicationEntry = function (path, callback) {\n var success = function (entry) {\n callback(null, entry);\n };\n var fail = function (error) {\n callback(FileUtil.fileErrorToError(error), null);\n };\n window.resolveLocalFileSystemURL(cordova.file.applicationDirectory + path, success, fail);\n };\n FileUtil.getOrCreateSubDirectory = function (parent, path, createIfNotExists, success, fail) {\n var failFirst = function (error) {\n if (!createIfNotExists) {\n fail(error);\n }\n else {\n parent.getDirectory(path, { create: true, exclusive: false }, success, fail);\n }\n };\n parent.getDirectory(path, { create: false, exclusive: false }, success, failFirst);\n };\n return FileUtil;\n}());\nmodule.exports = FileUtil;\n"
},
{
"path": "plugins/cordova-plugin-code-push/bin/www/httpRequester.js",
"content": "\n /******************************************************************************************** \n \t THIS FILE HAS BEEN COMPILED FROM TYPESCRIPT SOURCES. \n \t PLEASE DO NOT MODIFY THIS FILE AS YOU WILL LOSE YOUR CHANGES WHEN RECOMPILING. \n \t ALSO, PLEASE DO NOT SUBMIT PULL REQUESTS WITH CHANGES TO THIS FILE. \n \t INSTEAD, EDIT THE TYPESCRIPT SOURCES UNDER THE WWW FOLDER. \n \t FOR MORE INFORMATION, PLEASE SEE CONTRIBUTING.md. \n *********************************************************************************************/ \n\n\n\"use strict\";\nvar HttpRequester = (function () {\n function HttpRequester(contentType) {\n this.contentType = contentType;\n }\n HttpRequester.prototype.request = function (verb, url, callbackOrRequestBody, callback) {\n var requestBody;\n var requestCallback = callback;\n if (!requestCallback && typeof callbackOrRequestBody === \"function\") {\n requestCallback = callbackOrRequestBody;\n }\n if (typeof callbackOrRequestBody === \"string\") {\n requestBody = callbackOrRequestBody;\n }\n var xhr = new XMLHttpRequest();\n var methodName = this.getHttpMethodName(verb);\n xhr.onreadystatechange = function () {\n if (xhr.readyState === 4) {\n var response = { statusCode: xhr.status, body: xhr.responseText };\n requestCallback && requestCallback(null, response);\n }\n };\n xhr.open(methodName, url, true);\n if (this.contentType) {\n xhr.setRequestHeader(\"Content-Type\", this.contentType);\n }\n xhr.setRequestHeader(\"X-CodePush-SDK-Version\", cordova.require(\"cordova/plugin_list\").metadata[\"code-push\"]);\n xhr.send(requestBody);\n };\n HttpRequester.prototype.getHttpMethodName = function (verb) {\n switch (verb) {\n case 0:\n return \"GET\";\n case 7:\n return \"CONNECT\";\n case 4:\n return \"DELETE\";\n case 1:\n return \"HEAD\";\n case 6:\n return \"OPTIONS\";\n case 8:\n return \"PATCH\";\n case 2:\n return \"POST\";\n case 3:\n return \"PUT\";\n case 5:\n return \"TRACE\";\n default:\n return null;\n }\n };\n return HttpRequester;\n}());\nmodule.exports = HttpRequester;\n"
},
{
"path": "plugins/cordova-plugin-code-push/bin/www/installMode.js",
"content": "\n /******************************************************************************************** \n \t THIS FILE HAS BEEN COMPILED FROM TYPESCRIPT SOURCES. \n \t PLEASE DO NOT MODIFY THIS FILE AS YOU WILL LOSE YOUR CHANGES WHEN RECOMPILING. \n \t ALSO, PLEASE DO NOT SUBMIT PULL REQUESTS WITH CHANGES TO THIS FILE. \n \t INSTEAD, EDIT THE TYPESCRIPT SOURCES UNDER THE WWW FOLDER. \n \t FOR MORE INFORMATION, PLEASE SEE CONTRIBUTING.md. \n *********************************************************************************************/ \n\n\n\"use strict\";\nvar InstallMode;\n(function (InstallMode) {\n InstallMode[InstallMode[\"IMMEDIATE\"] = 0] = \"IMMEDIATE\";\n InstallMode[InstallMode[\"ON_NEXT_RESTART\"] = 1] = \"ON_NEXT_RESTART\";\n InstallMode[InstallMode[\"ON_NEXT_RESUME\"] = 2] = \"ON_NEXT_RESUME\";\n})(InstallMode || (InstallMode = {}));\nmodule.exports = InstallMode;\n"
},
{
"path": "plugins/cordova-plugin-code-push/bin/www/localPackage.js",
"content": "\n /******************************************************************************************** \n \t THIS FILE HAS BEEN COMPILED FROM TYPESCRIPT SOURCES. \n \t PLEASE DO NOT MODIFY THIS FILE AS YOU WILL LOSE YOUR CHANGES WHEN RECOMPILING. \n \t ALSO, PLEASE DO NOT SUBMIT PULL REQUESTS WITH CHANGES TO THIS FILE. \n \t INSTEAD, EDIT THE TYPESCRIPT SOURCES UNDER THE WWW FOLDER. \n \t FOR MORE INFORMATION, PLEASE SEE CONTRIBUTING.md. \n *********************************************************************************************/ \n\n\n\"use strict\";\nvar __extends = (this && this.__extends) || function (d, b) {\n for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p];\n function __() { this.constructor = d; }\n d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());\n};\nvar Package = require(\"./package\");\nvar NativeAppInfo = require(\"./nativeAppInfo\");\nvar FileUtil = require(\"./fileUtil\");\nvar CodePushUtil = require(\"./codePushUtil\");\nvar Sdk = require(\"./sdk\");\nvar LocalPackage = (function (_super) {\n __extends(LocalPackage, _super);\n function LocalPackage() {\n _super.apply(this, arguments);\n }\n LocalPackage.prototype.install = function (installSuccess, errorCallback, installOptions) {\n var _this = this;\n try {\n CodePushUtil.logMessage(\"Installing update\");\n if (!installOptions) {\n installOptions = LocalPackage.getDefaultInstallOptions();\n }\n else {\n CodePushUtil.copyUnassignedMembers(LocalPackage.getDefaultInstallOptions(), installOptions);\n }\n var installError = function (error) {\n CodePushUtil.invokeErrorCallback(error, errorCallback);\n Sdk.reportStatusDeploy(_this, AcquisitionStatus.DeploymentFailed, _this.deploymentKey);\n };\n var newPackageLocation = LocalPackage.VersionsDir + \"/\" + this.packageHash;\n var donePackageFileCopy = function (deployDir) {\n _this.localPath = deployDir.fullPath;\n _this.finishInstall(deployDir, installOptions, installSuccess, installError);\n };\n var newPackageUnzipped = function (unzipError) {\n if (unzipError) {\n installError && installError(new Error(\"Could not unzip package. \" + CodePushUtil.getErrorMessage(unzipError)));\n }\n else {\n LocalPackage.handleDeployment(newPackageLocation, CodePushUtil.getNodeStyleCallbackFor(donePackageFileCopy, installError));\n }\n };\n FileUtil.getDataDirectory(LocalPackage.DownloadUnzipDir, false, function (error, directoryEntry) {\n var unzipPackage = function () {\n FileUtil.getDataDirectory(LocalPackage.DownloadUnzipDir, true, function (innerError, unzipDir) {\n if (innerError) {\n installError && installError(innerError);\n }\n else {\n zip.unzip(_this.localPath, unzipDir.toInternalURL(), newPackageUnzipped);\n }\n });\n };\n if (!error && !!directoryEntry) {\n directoryEntry.removeRecursively(function () {\n unzipPackage();\n }, function (cleanupError) {\n installError && installError(FileUtil.fileErrorToError(cleanupError));\n });\n }\n else {\n unzipPackage();\n }\n });\n }\n catch (e) {\n installError && installError(new Error(\"An error occured while installing the package. \" + CodePushUtil.getErrorMessage(e)));\n }\n };\n LocalPackage.prototype.finishInstall = function (deployDir, installOptions, installSuccess, installError) {\n var _this = this;\n LocalPackage.getCurrentOrDefaultPackage(function (oldPackage) {\n LocalPackage.backupPackageInformationFile(function (backupError) {\n _this.writeNewPackageMetadata(deployDir, function (writeMetadataError) {\n if (writeMetadataError) {\n installError && installError(writeMetadataError);\n }\n else {\n var invokeSuccessAndInstall = function () {\n CodePushUtil.logMessage(\"Install succeeded.\");\n var installModeToUse = _this.isMandatory ? installOptions.mandatoryInstallMode : installOptions.installMode;\n if (installModeToUse === InstallMode.IMMEDIATE) {\n installSuccess && installSuccess(installModeToUse);\n cordova.exec(function () { }, function () { }, \"CodePush\", \"install\", [deployDir.fullPath,\n installModeToUse.toString(), installOptions.minimumBackgroundDuration.toString()]);\n }\n else {\n cordova.exec(function () { installSuccess && installSuccess(installModeToUse); }, function () { installError && installError(); }, \"CodePush\", \"install\", [deployDir.fullPath,\n installModeToUse.toString(), installOptions.minimumBackgroundDuration.toString()]);\n }\n };\n var preInstallSuccess = function () {\n invokeSuccessAndInstall();\n };\n var preInstallFailure = function (preInstallError) {\n CodePushUtil.logError(\"Preinstall failure.\", preInstallError);\n var error = new Error(\"An error has occured while installing the package. \" + CodePushUtil.getErrorMessage(preInstallError));\n installError && installError(error);\n };\n cordova.exec(preInstallSuccess, preInstallFailure, \"CodePush\", \"preInstall\", [deployDir.fullPath]);\n }\n });\n });\n }, installError);\n };\n LocalPackage.handleDeployment = function (newPackageLocation, deployCallback) {\n FileUtil.getDataDirectory(newPackageLocation, true, function (deployDirError, deployDir) {\n FileUtil.getDataFile(LocalPackage.DownloadUnzipDir, LocalPackage.DiffManifestFile, false, function (manifestError, diffManifest) {\n if (!manifestError && !!diffManifest) {\n LocalPackage.handleDiffDeployment(newPackageLocation, diffManifest, deployCallback);\n }\n else {\n LocalPackage.handleCleanDeployment(newPackageLocation, function (error) {\n deployCallback(error, deployDir);\n });\n }\n });\n });\n };\n LocalPackage.prototype.writeNewPackageMetadata = function (deployDir, writeMetadataCallback) {\n var _this = this;\n NativeAppInfo.getApplicationBuildTime(function (buildTimeError, timestamp) {\n NativeAppInfo.getApplicationVersion(function (appVersionError, appVersion) {\n buildTimeError && CodePushUtil.logError(\"Could not get application build time. \" + buildTimeError);\n appVersionError && CodePushUtil.logError(\"Could not get application version.\" + appVersionError);\n var currentPackageMetadata = {\n nativeBuildTime: timestamp,\n localPath: _this.localPath,\n appVersion: appVersion,\n deploymentKey: _this.deploymentKey,\n description: _this.description,\n isMandatory: _this.isMandatory,\n packageSize: _this.packageSize,\n label: _this.label,\n packageHash: _this.packageHash,\n isFirstRun: false,\n failedInstall: false,\n install: undefined\n };\n LocalPackage.writeCurrentPackageInformation(currentPackageMetadata, writeMetadataCallback);\n });\n });\n };\n LocalPackage.handleCleanDeployment = function (newPackageLocation, cleanDeployCallback) {\n FileUtil.getDataDirectory(newPackageLocation, true, function (deployDirError, deployDir) {\n FileUtil.getDataDirectory(LocalPackage.DownloadUnzipDir, false, function (unzipDirErr, unzipDir) {\n if (unzipDirErr || deployDirError) {\n cleanDeployCallback(new Error(\"Could not copy new package.\"), null);\n }\n else {\n FileUtil.copyDirectoryEntriesTo(unzipDir, deployDir, function (copyError) {\n if (copyError) {\n cleanDeployCallback(copyError, null);\n }\n else {\n cleanDeployCallback(null, deployDir);\n }\n });\n }\n });\n });\n };\n LocalPackage.copyCurrentPackage = function (newPackageLocation, copyCallback) {\n var handleError = function (e) {\n copyCallback && copyCallback(e, null);\n };\n var doCopy = function (currentPackagePath) {\n var getCurrentPackageDirectory;\n if (currentPackagePath) {\n getCurrentPackageDirectory = function (getCurrentPackageDirectoryCallback) {\n FileUtil.getDataDirectory(currentPackagePath, false, getCurrentPackageDirectoryCallback);\n };\n }\n else {\n newPackageLocation = newPackageLocation + \"/www\";\n getCurrentPackageDirectory = function (getCurrentPackageDirectoryCallback) {\n FileUtil.getApplicationDirectory(\"www\", getCurrentPackageDirectoryCallback);\n };\n }\n FileUtil.getDataDirectory(newPackageLocation, true, function (deployDirError, deployDir) {\n if (deployDirError) {\n handleError(new Error(\"Could not acquire the source/destination folders. \"));\n }\n else {\n var success = function (currentPackageDirectory) {\n FileUtil.copyDirectoryEntriesTo(currentPackageDirectory, deployDir, copyCallback);\n };\n var fail = function (fileSystemError) {\n copyCallback && copyCallback(FileUtil.fileErrorToError(fileSystemError), null);\n };\n getCurrentPackageDirectory(CodePushUtil.getNodeStyleCallbackFor(success, fail));\n }\n });\n };\n var packageFailure = function (error) {\n doCopy();\n };\n var packageSuccess = function (currentPackage) {\n doCopy(currentPackage.localPath);\n };\n LocalPackage.getPackage(LocalPackage.PackageInfoFile, packageSuccess, packageFailure);\n };\n LocalPackage.handleDiffDeployment = function (newPackageLocation, diffManifest, diffCallback) {\n var handleError = function (e) {\n diffCallback(e, null);\n };\n LocalPackage.copyCurrentPackage(newPackageLocation, function (currentPackageError) {\n LocalPackage.handleCleanDeployment(newPackageLocation, function (cleanDeployError) {\n FileUtil.readFileEntry(diffManifest, function (error, content) {\n if (error || currentPackageError || cleanDeployError) {\n handleError(new Error(\"Cannot perform diff-update.\"));\n }\n else {\n var manifest = JSON.parse(content);\n FileUtil.deleteEntriesFromDataDirectory(newPackageLocation, manifest.deletedFiles, function (deleteError) {\n FileUtil.getDataDirectory(newPackageLocation, true, function (deployDirError, deployDir) {\n if (deleteError || deployDirError) {\n handleError(new Error(\"Cannot clean up deleted manifest files.\"));\n }\n else {\n diffCallback(null, deployDir);\n }\n });\n });\n }\n });\n });\n });\n };\n LocalPackage.writeCurrentPackageInformation = function (packageInfoMetadata, callback) {\n var content = JSON.stringify(packageInfoMetadata);\n FileUtil.writeStringToDataFile(content, LocalPackage.RootDir, LocalPackage.PackageInfoFile, true, callback);\n };\n LocalPackage.backupPackageInformationFile = function (callback) {\n var reportFileError = function (error) {\n callback(FileUtil.fileErrorToError(error), null);\n };\n var copyFile = function (fileToCopy) {\n fileToCopy.getParent(function (parent) {\n fileToCopy.copyTo(parent, LocalPackage.OldPackageInfoFile, function () {\n callback(null, null);\n }, reportFileError);\n }, reportFileError);\n };\n var gotFile = function (error, currentPackageFile) {\n if (error) {\n callback(error, null);\n }\n else {\n FileUtil.getDataFile(LocalPackage.RootDir, LocalPackage.OldPackageInfoFile, false, function (error, oldPackageFile) {\n if (!error && !!oldPackageFile) {\n oldPackageFile.remove(function () {\n copyFile(currentPackageFile);\n }, reportFileError);\n }\n else {\n copyFile(currentPackageFile);\n }\n });\n }\n };\n FileUtil.getDataFile(LocalPackage.RootDir, LocalPackage.PackageInfoFile, false, gotFile);\n };\n LocalPackage.getOldPackage = function (packageSuccess, packageError) {\n return LocalPackage.getPackage(LocalPackage.OldPackageInfoFile, packageSuccess, packageError);\n };\n LocalPackage.getPackage = function (packageFile, packageSuccess, packageError) {\n var handleError = function (e) {\n packageError && packageError(new Error(\"Cannot read package information. \" + CodePushUtil.getErrorMessage(e)));\n };\n try {\n FileUtil.readDataFile(LocalPackage.RootDir, packageFile, function (error, content) {\n if (error) {\n handleError(error);\n }\n else {\n try {\n var packageInfo = JSON.parse(content);\n LocalPackage.getLocalPackageFromMetadata(packageInfo, packageSuccess, packageError);\n }\n catch (e) {\n handleError(e);\n }\n }\n });\n }\n catch (e) {\n handleError(e);\n }\n };\n LocalPackage.getLocalPackageFromMetadata = function (metadata, packageSuccess, packageError) {\n if (!metadata) {\n packageError && packageError(new Error(\"Invalid package metadata.\"));\n }\n else {\n NativeAppInfo.isFailedUpdate(metadata.packageHash, function (installFailed) {\n NativeAppInfo.isFirstRun(metadata.packageHash, function (isFirstRun) {\n var localPackage = new LocalPackage();\n localPackage.appVersion = metadata.appVersion;\n localPackage.deploymentKey = metadata.deploymentKey;\n localPackage.description = metadata.description;\n localPackage.failedInstall = installFailed;\n localPackage.isFirstRun = isFirstRun;\n localPackage.label = metadata.label;\n localPackage.localPath = metadata.localPath;\n localPackage.packageHash = metadata.packageHash;\n localPackage.packageSize = metadata.packageSize;\n packageSuccess && packageSuccess(localPackage);\n });\n });\n }\n };\n LocalPackage.getCurrentOrDefaultPackage = function (packageSuccess, packageError) {\n LocalPackage.getPackageInfoOrDefault(LocalPackage.PackageInfoFile, packageSuccess, packageError);\n };\n LocalPackage.getOldOrDefaultPackage = function (packageSuccess, packageError) {\n LocalPackage.getPackageInfoOrDefault(LocalPackage.OldPackageInfoFile, packageSuccess, packageError);\n };\n LocalPackage.getPackageInfoOrDefault = function (packageFile, packageSuccess, packageError) {\n var packageFailure = function (error) {\n NativeAppInfo.getApplicationVersion(function (appVersionError, appVersion) {\n if (appVersionError) {\n CodePushUtil.logError(\"Could not get application version.\" + appVersionError);\n packageError(appVersionError);\n return;\n }\n NativeAppInfo.getBinaryHash(function (binaryHashError, binaryHash) {\n var defaultPackage = new LocalPackage();\n defaultPackage.appVersion = appVersion;\n if (binaryHashError) {\n CodePushUtil.logError(\"Could not get binary hash.\" + binaryHashError);\n }\n else {\n defaultPackage.packageHash = binaryHash;\n }\n packageSuccess(defaultPackage);\n });\n });\n };\n LocalPackage.getPackage(packageFile, packageSuccess, packageFailure);\n };\n LocalPackage.getPackageInfoOrNull = function (packageFile, packageSuccess, packageError) {\n LocalPackage.getPackage(packageFile, packageSuccess, packageSuccess.bind(null, null));\n };\n LocalPackage.getDefaultInstallOptions = function () {\n if (!LocalPackage.DefaultInstallOptions) {\n LocalPackage.DefaultInstallOptions = {\n installMode: InstallMode.ON_NEXT_RESTART,\n minimumBackgroundDuration: 0,\n mandatoryInstallMode: InstallMode.IMMEDIATE\n };\n }\n return LocalPackage.DefaultInstallOptions;\n };\n LocalPackage.RootDir = \"codepush\";\n LocalPackage.DownloadDir = LocalPackage.RootDir + \"/download\";\n LocalPackage.DownloadUnzipDir = LocalPackage.DownloadDir + \"/unzipped\";\n LocalPackage.DeployDir = LocalPackage.RootDir + \"/deploy\";\n LocalPackage.VersionsDir = LocalPackage.DeployDir + \"/versions\";\n LocalPackage.PackageUpdateFileName = \"update.zip\";\n LocalPackage.PackageInfoFile = \"currentPackage.json\";\n LocalPackage.OldPackageInfoFile = \"oldPackage.json\";\n LocalPackage.DiffManifestFile = \"hotcodepush.json\";\n return LocalPackage;\n}(Package));\nmodule.exports = LocalPackage;\n"
},
{
"path": "plugins/cordova-plugin-code-push/bin/www/nativeAppInfo.js",
"content": "\n /******************************************************************************************** \n \t THIS FILE HAS BEEN COMPILED FROM TYPESCRIPT SOURCES. \n \t PLEASE DO NOT MODIFY THIS FILE AS YOU WILL LOSE YOUR CHANGES WHEN RECOMPILING. \n \t ALSO, PLEASE DO NOT SUBMIT PULL REQUESTS WITH CHANGES TO THIS FILE. \n \t INSTEAD, EDIT THE TYPESCRIPT SOURCES UNDER THE WWW FOLDER. \n \t FOR MORE INFORMATION, PLEASE SEE CONTRIBUTING.md. \n *********************************************************************************************/ \n\n\n\"use strict\";\nvar DefaultServerUrl = \"https://codepush.azurewebsites.net/\";\nvar NativeAppInfo = (function () {\n function NativeAppInfo() {\n }\n NativeAppInfo.getApplicationBuildTime = function (callback) {\n var timestampSuccess = function (timestamp) { callback(null, timestamp); };\n var timestampError = function () { callback(new Error(\"Could not get application timestamp.\"), null); };\n cordova.exec(timestampSuccess, timestampError, \"CodePush\", \"getNativeBuildTime\", []);\n };\n NativeAppInfo.getApplicationVersion = function (callback) {\n var versionSuccess = function (version) { callback(null, version); };\n var versionError = function () { callback(new Error(\"Could not get application version.\"), null); };\n cordova.exec(versionSuccess, versionError, \"CodePush\", \"getAppVersion\", []);\n };\n NativeAppInfo.getBinaryHash = function (callback) {\n var binaryHashSuccess = function (binaryHash) { callback(null, binaryHash); };\n var binaryHashError = function () { callback(new Error(\"Could not get binary hash.\"), null); };\n cordova.exec(binaryHashSuccess, binaryHashError, \"CodePush\", \"getBinaryHash\", []);\n };\n NativeAppInfo.getServerURL = function (serverCallback) {\n var serverSuccess = function (serverURL) { serverCallback(null, serverURL); };\n var serverError = function () { serverCallback(null, DefaultServerUrl); };\n cordova.exec(serverSuccess, serverError, \"CodePush\", \"getServerURL\", []);\n };\n NativeAppInfo.getDeploymentKey = function (deploymentKeyCallback) {\n var deploymentSuccess = function (deploymentKey) { deploymentKeyCallback(null, deploymentKey); };\n var deploymentError = function () { deploymentKeyCallback(new Error(\"Deployment key not found.\"), null); };\n cordova.exec(deploymentSuccess, deploymentError, \"CodePush\", \"getDeploymentKey\", []);\n };\n NativeAppInfo.isFailedUpdate = function (packageHash, checkCallback) {\n var win = function (failed) {\n checkCallback && checkCallback(!!failed);\n };\n var fail = function (e) {\n win(0);\n };\n cordova.exec(win, fail, \"CodePush\", \"isFailedUpdate\", [packageHash]);\n };\n NativeAppInfo.isFirstRun = function (packageHash, firstRunCallback) {\n var win = function (firstRun) {\n firstRunCallback(!!firstRun);\n };\n var fail = function () {\n firstRunCallback(false);\n };\n cordova.exec(win, fail, \"CodePush\", \"isFirstRun\", [packageHash]);\n };\n NativeAppInfo.isPendingUpdate = function (callback) {\n var win = function (firstRun) {\n callback(!!firstRun);\n };\n var fail = function () {\n callback(false);\n };\n cordova.exec(win, fail, \"CodePush\", \"isPendingUpdate\", []);\n };\n return NativeAppInfo;\n}());\nmodule.exports = NativeAppInfo;\n"
},
{
"path": "plugins/cordova-plugin-code-push/bin/www/package.js",
"content": "\n /******************************************************************************************** \n \t THIS FILE HAS BEEN COMPILED FROM TYPESCRIPT SOURCES. \n \t PLEASE DO NOT MODIFY THIS FILE AS YOU WILL LOSE YOUR CHANGES WHEN RECOMPILING. \n \t ALSO, PLEASE DO NOT SUBMIT PULL REQUESTS WITH CHANGES TO THIS FILE. \n \t INSTEAD, EDIT THE TYPESCRIPT SOURCES UNDER THE WWW FOLDER. \n \t FOR MORE INFORMATION, PLEASE SEE CONTRIBUTING.md. \n *********************************************************************************************/ \n\n\n\"use strict\";\nvar Package = (function () {\n function Package() {\n }\n return Package;\n}());\nmodule.exports = Package;\n"
},
{
"path": "plugins/cordova-plugin-code-push/bin/www/remotePackage.js",
"content": "\n /******************************************************************************************** \n \t THIS FILE HAS BEEN COMPILED FROM TYPESCRIPT SOURCES. \n \t PLEASE DO NOT MODIFY THIS FILE AS YOU WILL LOSE YOUR CHANGES WHEN RECOMPILING. \n \t ALSO, PLEASE DO NOT SUBMIT PULL REQUESTS WITH CHANGES TO THIS FILE. \n \t INSTEAD, EDIT THE TYPESCRIPT SOURCES UNDER THE WWW FOLDER. \n \t FOR MORE INFORMATION, PLEASE SEE CONTRIBUTING.md. \n *********************************************************************************************/ \n\n\n\"use strict\";\nvar __extends = (this && this.__extends) || function (d, b) {\n for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p];\n function __() { this.constructor = d; }\n d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());\n};\nvar LocalPackage = require(\"./localPackage\");\nvar Package = require(\"./package\");\nvar NativeAppInfo = require(\"./nativeAppInfo\");\nvar CodePushUtil = require(\"./codePushUtil\");\nvar Sdk = require(\"./sdk\");\nvar RemotePackage = (function (_super) {\n __extends(RemotePackage, _super);\n function RemotePackage() {\n _super.apply(this, arguments);\n }\n RemotePackage.prototype.download = function (successCallback, errorCallback, downloadProgress) {\n var _this = this;\n try {\n CodePushUtil.logMessage(\"Downloading update\");\n if (!this.downloadUrl) {\n CodePushUtil.invokeErrorCallback(new Error(\"The remote package does not contain a download URL.\"), errorCallback);\n }\n else {\n this.currentFileTransfer = new FileTransfer();\n var downloadSuccess = function (fileEntry) {\n _this.currentFileTransfer = null;\n fileEntry.file(function (file) {\n NativeAppInfo.isFailedUpdate(_this.packageHash, function (installFailed) {\n var localPackage = new LocalPackage();\n localPackage.deploymentKey = _this.deploymentKey;\n localPackage.description = _this.description;\n localPackage.label = _this.label;\n localPackage.appVersion = _this.appVersion;\n localPackage.isMandatory = _this.isMandatory;\n localPackage.packageHash = _this.packageHash;\n localPackage.isFirstRun = false;\n localPackage.failedInstall = installFailed;\n localPackage.localPath = fileEntry.toInternalURL();\n CodePushUtil.logMessage(\"Package download success: \" + JSON.stringify(localPackage));\n successCallback && successCallback(localPackage);\n Sdk.reportStatusDownload(localPackage, localPackage.deploymentKey);\n });\n }, function (fileError) {\n CodePushUtil.invokeErrorCallback(new Error(\"Could not access local package. Error code: \" + fileError.code), errorCallback);\n });\n };\n var downloadError = function (error) {\n _this.currentFileTransfer = null;\n CodePushUtil.invokeErrorCallback(new Error(error.body), errorCallback);\n };\n this.currentFileTransfer.onprogress = function (progressEvent) {\n if (downloadProgress) {\n var dp = { receivedBytes: progressEvent.loaded, totalBytes: progressEvent.total };\n downloadProgress(dp);\n }\n };\n this.currentFileTransfer.download(this.downloadUrl, cordova.file.dataDirectory + LocalPackage.DownloadDir + \"/\" + LocalPackage.PackageUpdateFileName, downloadSuccess, downloadError, true);\n }\n }\n catch (e) {\n CodePushUtil.invokeErrorCallback(new Error(\"An error occured while downloading the package. \" + (e && e.message) ? e.message : \"\"), errorCallback);\n }\n };\n RemotePackage.prototype.abortDownload = function (abortSuccess, abortError) {\n try {\n if (this.currentFileTransfer) {\n this.currentFileTransfer.abort();\n abortSuccess && abortSuccess();\n }\n }\n catch (e) {\n abortError && abortError(e);\n }\n };\n return RemotePackage;\n}(Package));\nmodule.exports = RemotePackage;\n"
},
{
"path": "plugins/cordova-plugin-code-push/bin/www/sdk.js",
"content": "\n /******************************************************************************************** \n \t THIS FILE HAS BEEN COMPILED FROM TYPESCRIPT SOURCES. \n \t PLEASE DO NOT MODIFY THIS FILE AS YOU WILL LOSE YOUR CHANGES WHEN RECOMPILING. \n \t ALSO, PLEASE DO NOT SUBMIT PULL REQUESTS WITH CHANGES TO THIS FILE. \n \t INSTEAD, EDIT THE TYPESCRIPT SOURCES UNDER THE WWW FOLDER. \n \t FOR MORE INFORMATION, PLEASE SEE CONTRIBUTING.md. \n *********************************************************************************************/ \n\n\n\"use strict\";\nvar NativeAppInfo = require(\"./nativeAppInfo\");\nvar HttpRequester = require(\"./httpRequester\");\nvar Sdk = (function () {\n function Sdk() {\n }\n Sdk.getAcquisitionManager = function (callback, userDeploymentKey, contentType) {\n var resolveManager = function () {\n if (userDeploymentKey !== Sdk.DefaultConfiguration.deploymentKey || contentType) {\n var customConfiguration = {\n deploymentKey: userDeploymentKey || Sdk.DefaultConfiguration.deploymentKey,\n serverUrl: Sdk.DefaultConfiguration.serverUrl,\n ignoreAppVersion: Sdk.DefaultConfiguration.ignoreAppVersion,\n appVersion: Sdk.DefaultConfiguration.appVersion,\n clientUniqueId: Sdk.DefaultConfiguration.clientUniqueId\n };\n var requester = new HttpRequester(contentType);\n var customAcquisitionManager = new AcquisitionManager(requester, customConfiguration);\n callback(null, customAcquisitionManager);\n }\n else if (Sdk.DefaultConfiguration.deploymentKey) {\n callback(null, Sdk.DefaultAcquisitionManager);\n }\n else {\n callback(new Error(\"No deployment key provided, please provide a default one in your config.xml or specify one in the call to checkForUpdate() or sync().\"), null);\n }\n };\n if (Sdk.DefaultAcquisitionManager) {\n resolveManager();\n }\n else {\n NativeAppInfo.getServerURL(function (serverError, serverURL) {\n NativeAppInfo.getDeploymentKey(function (depolymentKeyError, deploymentKey) {\n NativeAppInfo.getApplicationVersion(function (appVersionError, appVersion) {\n if (!serverURL || !appVersion) {\n callback(new Error(\"Could not get the CodePush configuration. Please check your config.xml file.\"), null);\n }\n else {\n Sdk.DefaultConfiguration = {\n deploymentKey: deploymentKey,\n serverUrl: serverURL,\n ignoreAppVersion: false,\n appVersion: appVersion,\n clientUniqueId: device.uuid\n };\n if (deploymentKey) {\n Sdk.DefaultAcquisitionManager = new AcquisitionManager(new HttpRequester(), Sdk.DefaultConfiguration);\n }\n resolveManager();\n }\n });\n });\n });\n }\n };\n Sdk.reportStatusDeploy = function (pkg, status, currentDeploymentKey, previousLabelOrAppVersion, previousDeploymentKey, callback) {\n try {\n Sdk.getAcquisitionManager(function (error, acquisitionManager) {\n if (error) {\n callback && callback(error, null);\n }\n else {\n console.log(\"Reporting status: \" + status + \" label: \" + (pkg && pkg.label) + \" appVersion: \" + Sdk.DefaultConfiguration.appVersion + \" previousLabelOrAppVersion: \" + previousLabelOrAppVersion + \" previousDeploymentKey:\" + previousDeploymentKey);\n acquisitionManager.reportStatusDeploy(pkg, status, previousLabelOrAppVersion, previousDeploymentKey, callback);\n }\n }, currentDeploymentKey, \"application/json\");\n }\n catch (e) {\n callback && callback(new Error(\"An error occured while reporting the deployment status. \" + e), null);\n }\n };\n Sdk.reportStatusDownload = function (pkg, deploymentKey, callback) {\n try {\n Sdk.getAcquisitionManager(function (error, acquisitionManager) {\n if (error) {\n callback && callback(error, null);\n }\n else {\n acquisitionManager.reportStatusDownload(pkg, callback);\n }\n }, deploymentKey, \"application/json\");\n }\n catch (e) {\n callback && callback(new Error(\"An error occured while reporting the download status. \" + e), null);\n }\n };\n return Sdk;\n}());\nmodule.exports = Sdk;\n"
},
{
"path": "plugins/cordova-plugin-code-push/bin/www/syncStatus.js",
"content": "\n /******************************************************************************************** \n \t THIS FILE HAS BEEN COMPILED FROM TYPESCRIPT SOURCES. \n \t PLEASE DO NOT MODIFY THIS FILE AS YOU WILL LOSE YOUR CHANGES WHEN RECOMPILING. \n \t ALSO, PLEASE DO NOT SUBMIT PULL REQUESTS WITH CHANGES TO THIS FILE. \n \t INSTEAD, EDIT THE TYPESCRIPT SOURCES UNDER THE WWW FOLDER. \n \t FOR MORE INFORMATION, PLEASE SEE CONTRIBUTING.md. \n *********************************************************************************************/ \n\n\n\"use strict\";\nvar SyncStatus;\n(function (SyncStatus) {\n SyncStatus[SyncStatus[\"UP_TO_DATE\"] = 0] = \"UP_TO_DATE\";\n SyncStatus[SyncStatus[\"UPDATE_INSTALLED\"] = 1] = \"UPDATE_INSTALLED\";\n SyncStatus[SyncStatus[\"UPDATE_IGNORED\"] = 2] = \"UPDATE_IGNORED\";\n SyncStatus[SyncStatus[\"ERROR\"] = 3] = \"ERROR\";\n SyncStatus[SyncStatus[\"IN_PROGRESS\"] = 4] = \"IN_PROGRESS\";\n SyncStatus[SyncStatus[\"CHECKING_FOR_UPDATE\"] = 5] = \"CHECKING_FOR_UPDATE\";\n SyncStatus[SyncStatus[\"AWAITING_USER_ACTION\"] = 6] = \"AWAITING_USER_ACTION\";\n SyncStatus[SyncStatus[\"DOWNLOADING_PACKAGE\"] = 7] = \"DOWNLOADING_PACKAGE\";\n SyncStatus[SyncStatus[\"INSTALLING_UPDATE\"] = 8] = \"INSTALLING_UPDATE\";\n})(SyncStatus || (SyncStatus = {}));\nmodule.exports = SyncStatus;\n"
},
{
"path": "plugins/cordova-plugin-code-push/package.json",
"content": "{\n \"name\": \"cordova-plugin-code-push\",\n \"version\": \"1.7.1-beta\",\n \"description\": \"CodePush Plugin for Apache Cordova\",\n \"cordova\": {\n \"id\": \"cordova-plugin-code-push\",\n \"platforms\": [\n \"android\",\n \"ios\"\n ]\n },\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/Microsoft/cordova-plugin-code-push\"\n },\n \"keywords\": [\n \"cordova\",\n \"code\",\n \"push\",\n \"ecosystem:cordova\",\n \"cordova-android\",\n \"cordova-ios\"\n ],\n \"peerDependencies\": {\n \"code-push\": \">=1.8.0-beta\",\n \"cordova-plugin-file-transfer\": \">=1.3.0\",\n \"cordova-plugin-file\": \">=3.0.0\",\n \"cordova-plugin-zip\": \">=3.0.0\",\n \"cordova-plugin-dialogs\": \">=1.1.1\",\n \"cordova-plugin-device\": \">=1.1.0\"\n },\n \"author\": \"Microsoft Corporation\",\n \"license\": \"MIT\",\n \"devDependencies\": {\n \"gulp\": \"latest\",\n \"gulp-typescript\": \"latest\",\n \"gulp-insert\": \"latest\",\n \"gulp-tslint\": \"latest\",\n \"tslint\": \"latest\",\n \"del\": \"latest\",\n \"run-sequence\": \"latest\",\n \"q\": \"latest\",\n \"replace\": \"latest\",\n \"mkdirp\": \"latest\",\n \"express\": \"latest\",\n \"body-parser\": \"latest\",\n \"archiver\": \"latest\"\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-code-push/plugin.xml",
"content": "\n \n CodePush\n This plugin allows you to push code updates to your apps instantly using the CodePush service\n MIT\n cordova,code,push\n https://github.com/Microsoft/cordova-plugin-code-push.git\n\n =1.8.0-beta\" />\n =3.0.0\" /> \n =1.3.0\" /> \n =3.0.0\" />\n =1.1.1\" />\n =1.1.0\" />\n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "plugins/cordova-plugin-code-push/samples/advanced/README.md",
"content": "# Cordova CodePush Sample App - Advanced\n\nThis is a sample application demonstrating a more advanced way you could integrate CodePush in your Cordova application. All the CodePush specific code is found in [index.js](/samples/advanced/www/js/index.js). The CodePush configuration is found in [config.xml](/samples/advanced/config.xml).\n\nWhen the application loads, on the `deviceready` event, we poll the CodePush server for an update. If an update is available, we prompt the user to install it. If the user approves it, the update is installed and the application is reloaded.\n\nFor more information on how to get started see our [Getting Started](/README.md#getting-started) section.\n"
},
{
"path": "plugins/cordova-plugin-code-push/samples/advanced/config.xml",
"content": "\n \n CodePushAdvanced\n \n A sample Apache Cordova application that uses the CodePush service.\n \n\n \n \n\n \n \n\n \n \n\n \n \n \n \n \n \n\n \n \n \n \n \n\n \n \n \n \n \n \n "
},
{
"path": "plugins/cordova-plugin-code-push/samples/advanced/www/css/index.css",
"content": "/*\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n */\n* {\n -webkit-tap-highlight-color: rgba(0,0,0,0); /* make transparent link selection, adjust last value opacity 0 to 1.0 */\n}\n\nbody {\n -webkit-touch-callout: none; /* prevent callout to copy image, etc when tap to hold */\n -webkit-text-size-adjust: none; /* prevent webkit from resizing text to fit */\n -webkit-user-select: none; /* prevent copy paste, to allow, change 'none' to 'text' */\n background-color:#E4E4E4;\n background-image:linear-gradient(top, #A7A7A7 0%, #E4E4E4 51%);\n background-image:-webkit-linear-gradient(top, #A7A7A7 0%, #E4E4E4 51%);\n background-image:-ms-linear-gradient(top, #A7A7A7 0%, #E4E4E4 51%);\n background-image:-webkit-gradient(\n linear,\n left top,\n left bottom,\n color-stop(0, #A7A7A7),\n color-stop(0.51, #E4E4E4)\n );\n background-attachment:fixed;\n font-family:'HelveticaNeue-Light', 'HelveticaNeue', Helvetica, Arial, sans-serif;\n font-size:12px;\n height:100%;\n margin:0px;\n padding:0px;\n text-transform:uppercase;\n width:100%;\n}\n\n/* Portrait layout (default) */\n.app {\n background:url(../img/logo.png) no-repeat center top; /* 170px x 200px */\n position:absolute; /* position in the center of the screen */\n left:50%;\n top:50%;\n height:50px; /* text area height */\n width:225px; /* text area width */\n text-align:center;\n padding:180px 0px 0px 0px; /* image height is 200px (bottom 20px are overlapped with text) */\n margin:-115px 0px 0px -112px; /* offset vertical: half of image height and text area height */\n /* offset horizontal: half of text area width */\n}\n\n/* Landscape layout (with min-width) */\n@media screen and (min-aspect-ratio: 1/1) and (min-width:400px) {\n .app {\n background-position:left center;\n padding:75px 0px 75px 170px; /* padding-top + padding-bottom + text area = image height */\n margin:-90px 0px 0px -198px; /* offset vertical: half of image height */\n /* offset horizontal: half of image width and text area width */\n }\n}\n\nh1 {\n font-size:24px;\n font-weight:normal;\n margin:0px;\n overflow:visible;\n padding:0px;\n text-align:center;\n}\n\n.event {\n border-radius:4px;\n -webkit-border-radius:4px;\n color:#FFFFFF;\n font-size:12px;\n margin:0px 30px;\n padding:2px 0px;\n}\n\n.event.listening {\n background-color:#333333;\n display:block;\n}\n\n.event.received {\n background-color:#4B946A;\n display:none;\n}\n\n@keyframes fade {\n from { opacity: 1.0; }\n 50% { opacity: 0.4; }\n to { opacity: 1.0; }\n}\n \n@-webkit-keyframes fade {\n from { opacity: 1.0; }\n 50% { opacity: 0.4; }\n to { opacity: 1.0; }\n}\n \n.blink {\n animation:fade 3000ms infinite;\n -webkit-animation:fade 3000ms infinite;\n}\n"
},
{
"path": "plugins/cordova-plugin-code-push/samples/advanced/www/index.html",
"content": "\n\n\n \n \n \n \n \n \n \n Hello World\n \n \n
\n
Hello, CodePush (Version 1)
\n
\n
Connecting to Device
\n
Device is Ready
\n
\n
\n \n \n \n\n"
},
{
"path": "plugins/cordova-plugin-code-push/samples/advanced/www/js/index.js",
"content": "/*\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n */\nvar app = {\n // Application Constructor\n initialize: function () {\n this.bindEvents();\n },\n // Bind Event Listeners\n //\n // Bind any events that are required on startup. Common events are:\n // 'load', 'deviceready', 'offline', and 'online'.\n bindEvents: function () {\n document.addEventListener('deviceready', this.onDeviceReady, false);\n },\n // deviceready Event Handler\n //\n // The scope of 'this' is the event. In order to call the 'receivedEvent'\n // function, we must explicitly call 'app.receivedEvent(...);'\n onDeviceReady: function () {\n // Migrate data from older versions\n window.codePush.getCurrentPackage(function (currentPackage) {\n // getCurrentPackage returns null if no update was installed (app store version)\n if (currentPackage && currentPackage.isFirstRun) {\n // First run after an update, migrate data\n if (currentPackage.appVersion === \"1.0.0\") {\n // migrate data from store version to version 1.0.0\n } else if (currentPackage.appVersion === \"2.0.0\") {\n // migrate data to version 2.0.0\n }\n }\n \n // continue application initialization\n app.receivedEvent('deviceready');\n \n // Wait for 5s after the application started and check for updates.\n setTimeout(app.checkAndInstallUpdates, 5000);\n \n // Notify the plugin that update succeeded.\n window.codePush.notifyApplicationReady();\n\n }, app.getErrorHandler(\"Error while retrieving the current package.\"));\n },\n // Update DOM on a Received Event\n receivedEvent: function (id) {\n var parentElement = document.getElementById(id);\n var listeningElement = parentElement.querySelector('.listening');\n var receivedElement = parentElement.querySelector('.received');\n\n listeningElement.setAttribute('style', 'display:none;');\n receivedElement.setAttribute('style', 'display:block;');\n\n console.log('Received Event: ' + id);\n },\n // Uses the CodePush service configured in config.xml to check for updates, prompt the user and install them.\n checkAndInstallUpdates: function () {\n \n // Check the CodePush server for updates.\n console.log(\"Checking for updates...\");\n window.codePush.checkForUpdate(app.checkSuccess, app.getErrorHandler(\"Checking for update failed.\"));\n },\n // Called after the CodePush server responded the checkForUpdate call\n checkSuccess: function (remotePackage) {\n if (!remotePackage) {\n // A null remotePackage means that the server successfully responded, but there is no update available.\n console.log(\"The application is up to date.\");\n }\n else {\n console.log(\"There is an update available. Remote package:\" + JSON.stringify(remotePackage));\n \n // Called after the user confirmed or canceled the update \n function onConfirm(buttonIndex) {\n switch (buttonIndex) {\n case 1:\n /* Install */\n console.log(\"Downloading package...\");\n remotePackage.download(app.onDownloadSuccess, app.getErrorHandler(\"Downloading the update package failed.\"));\n break;\n case 2:\n /* Cancel */\n /* nothing to do */\n break;\n }\n }\n\n // Ask the user if they want to download and install the update\n navigator.notification.confirm(\n 'An update is available. Would you like to download and install it?',\n onConfirm,\n 'Update'\n ['Install', 'Cancel']);\n }\n },\n // Called after an update package was downloaded sucessfully.\n onDownloadSuccess: function (localPackage) {\n console.log(\"Local package downloaded. Local package: \" + localPackage.localPath);\n\n var installCallback = function () {\n console.log(\"Install succeeded\");\n };\n\n console.log(\"Installing package...\");\n localPackage.install(installCallback, app.getErrorHandler(\"Installation failed.\"), { installMode: InstallMode.IMMEDIATE });\n },\n // Returns an error handler that logs the error to the console and displays a notification containing the error message.\n getErrorHandler: function (message) {\n // Displays a dialog containing a message.\n var displayErrorMessage = function (message) {\n navigator.notification.alert(\n message,\n null,\n 'CodePush',\n 'OK');\n };\n\n return function (error) {\n console.log(message + \":\" + error.message);\n displayErrorMessage(message + \":\" + error.message);\n }\n }\n};\n\napp.initialize();"
},
{
"path": "plugins/cordova-plugin-code-push/samples/basic/README.md",
"content": "# Cordova CodePush Sample App - Basic\n\nThis is a sample application demonstrating the CodePush sync operation. This operation offers a very easy way of integrating CodePush in your application, by invoking only one function. All the CodePush specific code is found in [index.js](/samples/basic/www/js/index.js). The CodePush configuration is found in [config.xml](/samples/basic/config.xml).\n\nWhen the application loads, on the `deviceready` event, we invoke sync. This checks for an update, and if one is available, the user will be prompted to install it. Once the user accepts it, the update is installed and the application reloaded. See [SyncOptions](/README.md#syncoptions) in our documentation for customizing the sync behavior. \n\nFor more information on how to get started see our [Getting Started](/README.md#getting-started) section.\n"
},
{
"path": "plugins/cordova-plugin-code-push/samples/basic/config.xml",
"content": "\n \n CodePushBasic\n \n A sample Apache Cordova application that uses the CodePush service.\n \n\n \n \n\n \n \n\n \n \n\n \n \n \n \n \n \n\n \n \n \n \n \n\n \n \n \n \n \n \n "
},
{
"path": "plugins/cordova-plugin-code-push/samples/basic/www/css/index.css",
"content": "/*\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n */\n* {\n -webkit-tap-highlight-color: rgba(0,0,0,0); /* make transparent link selection, adjust last value opacity 0 to 1.0 */\n}\n\nbody {\n -webkit-touch-callout: none; /* prevent callout to copy image, etc when tap to hold */\n -webkit-text-size-adjust: none; /* prevent webkit from resizing text to fit */\n -webkit-user-select: none; /* prevent copy paste, to allow, change 'none' to 'text' */\n background-color:#E4E4E4;\n background-image:linear-gradient(top, #A7A7A7 0%, #E4E4E4 51%);\n background-image:-webkit-linear-gradient(top, #A7A7A7 0%, #E4E4E4 51%);\n background-image:-ms-linear-gradient(top, #A7A7A7 0%, #E4E4E4 51%);\n background-image:-webkit-gradient(\n linear,\n left top,\n left bottom,\n color-stop(0, #A7A7A7),\n color-stop(0.51, #E4E4E4)\n );\n background-attachment:fixed;\n font-family:'HelveticaNeue-Light', 'HelveticaNeue', Helvetica, Arial, sans-serif;\n font-size:12px;\n height:100%;\n margin:0px;\n padding:0px;\n text-transform:uppercase;\n width:100%;\n}\n\n/* Portrait layout (default) */\n.app {\n background:url(../img/logo.png) no-repeat center top; /* 170px x 200px */\n position:absolute; /* position in the center of the screen */\n left:50%;\n top:50%;\n height:50px; /* text area height */\n width:225px; /* text area width */\n text-align:center;\n padding:180px 0px 0px 0px; /* image height is 200px (bottom 20px are overlapped with text) */\n margin:-115px 0px 0px -112px; /* offset vertical: half of image height and text area height */\n /* offset horizontal: half of text area width */\n}\n\n/* Landscape layout (with min-width) */\n@media screen and (min-aspect-ratio: 1/1) and (min-width:400px) {\n .app {\n background-position:left center;\n padding:75px 0px 75px 170px; /* padding-top + padding-bottom + text area = image height */\n margin:-90px 0px 0px -198px; /* offset vertical: half of image height */\n /* offset horizontal: half of image width and text area width */\n }\n}\n\nh1 {\n font-size:24px;\n font-weight:normal;\n margin:0px;\n overflow:visible;\n padding:0px;\n text-align:center;\n}\n\n.event {\n border-radius:4px;\n -webkit-border-radius:4px;\n color:#FFFFFF;\n font-size:12px;\n margin:0px 30px;\n padding:2px 0px;\n}\n\n.event.listening {\n background-color:#333333;\n display:block;\n}\n\n.event.received {\n background-color:#4B946A;\n display:none;\n}\n\n@keyframes fade {\n from { opacity: 1.0; }\n 50% { opacity: 0.4; }\n to { opacity: 1.0; }\n}\n \n@-webkit-keyframes fade {\n from { opacity: 1.0; }\n 50% { opacity: 0.4; }\n to { opacity: 1.0; }\n}\n \n.blink {\n animation:fade 3000ms infinite;\n -webkit-animation:fade 3000ms infinite;\n}\n"
},
{
"path": "plugins/cordova-plugin-code-push/samples/basic/www/index.html",
"content": "\n\n\n \n \n \n \n \n \n \n Hello World\n \n \n
\n
Hello, CodePush (Version 1)
\n
\n
Connecting to Device
\n
Device is Ready
\n
\n
\n \n \n \n\n"
},
{
"path": "plugins/cordova-plugin-code-push/samples/basic/www/js/index.js",
"content": "/*\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n */\nvar app = {\n // Application Constructor\n initialize: function () {\n this.bindEvents();\n },\n // Bind Event Listeners\n //\n // Bind any events that are required on startup. Common events are:\n // 'load', 'deviceready', 'offline', and 'online'.\n bindEvents: function () {\n document.addEventListener('deviceready', this.onDeviceReady, false);\n },\n // deviceready Event Handler\n //\n // The scope of 'this' is the event. In order to call the 'receivedEvent'\n // function, we must explicitly call 'app.receivedEvent(...);'\n onDeviceReady: function () {\n \n /* Invoke sync with the custom options, which enables user interaction.\n For customizing the sync behavior, see SyncOptions in the CodePush documentation. */\n window.codePush.sync(\n function (syncStatus) {\n switch (syncStatus) {\n // Result (final) statuses\n case SyncStatus.UPDATE_INSTALLED:\n app.displayMessage(\"The update was installed successfully. For InstallMode.ON_NEXT_RESTART, the changes will be visible after application restart. \");\n break;\n case SyncStatus.UP_TO_DATE:\n app.displayMessage(\"The application is up to date.\");\n break;\n case SyncStatus.UPDATE_IGNORED:\n app.displayMessage(\"The user decided not to install the optional update.\");\n break;\n case SyncStatus.ERROR:\n app.displayMessage(\"An error occured while checking for updates\");\n break;\n \n // Intermediate (non final) statuses\n case SyncStatus.CHECKING_FOR_UPDATE:\n console.log(\"Checking for update.\");\n break;\n case SyncStatus.AWAITING_USER_ACTION:\n console.log(\"Alerting user.\");\n break;\n case SyncStatus.DOWNLOADING_PACKAGE:\n console.log(\"Downloading package.\");\n break;\n case SyncStatus.INSTALLING_UPDATE:\n console.log(\"Installing update\");\n break;\n }\n },\n {\n installMode: InstallMode.ON_NEXT_RESTART, updateDialog: true\n },\n function (downloadProgress) {\n console.log(\"Downloading \" + downloadProgress.receivedBytes + \" of \" + downloadProgress.totalBytes + \" bytes.\");\n });\n \n // continue application initialization\n app.receivedEvent('deviceready');\n },\n // Update DOM on a Received Event\n receivedEvent: function (id) {\n var parentElement = document.getElementById(id);\n var listeningElement = parentElement.querySelector('.listening');\n var receivedElement = parentElement.querySelector('.received');\n\n listeningElement.setAttribute('style', 'display:none;');\n receivedElement.setAttribute('style', 'display:block;');\n\n console.log('Received Event: ' + id);\n },\n // Displays an alert dialog containing a message.\n displayMessage: function (message) {\n navigator.notification.alert(\n message,\n null,\n 'CodePush',\n 'OK');\n }\n};\n\napp.initialize();"
},
{
"path": "plugins/cordova-plugin-code-push/src/android/CodePush.java",
"content": "package com.microsoft.cordova;\n\nimport android.content.pm.PackageManager;\nimport android.os.AsyncTask;\n\nimport org.apache.cordova.CallbackContext;\nimport org.apache.cordova.ConfigXmlParser;\nimport org.apache.cordova.CordovaArgs;\nimport org.apache.cordova.CordovaInterface;\nimport org.apache.cordova.CordovaPlugin;\nimport org.apache.cordova.CordovaWebView;\nimport org.json.JSONException;\n\nimport java.io.File;\nimport java.io.IOException;\nimport java.net.MalformedURLException;\nimport java.security.NoSuchAlgorithmException;\n\nimport java.util.Date;\n\n/**\n * Native Android CodePush Cordova Plugin.\n */\npublic class CodePush extends CordovaPlugin {\n\n public static final String RESOURCES_BUNDLE = \"resources.arsc\";\n private static final String DEPLOYMENT_KEY_PREFERENCE = \"codepushdeploymentkey\";\n private static final String WWW_ASSET_PATH_PREFIX = \"file:///android_asset/www/\";\n private static boolean ShouldClearHistoryOnLoad = false;\n private CordovaWebView mainWebView;\n private CodePushPackageManager codePushPackageManager;\n private CodePushReportingManager codePushReportingManager;\n private boolean pluginDestroyed = false;\n private boolean didUpdate = false;\n private boolean didStartApp = false;\n private long lastPausedTimeMs = 0;\n\n @Override\n public void initialize(CordovaInterface cordova, CordovaWebView webView) {\n super.initialize(cordova, webView);\n CodePushPreferences codePushPreferences = new CodePushPreferences(cordova.getActivity());\n codePushPackageManager = new CodePushPackageManager(cordova.getActivity(), codePushPreferences);\n codePushReportingManager = new CodePushReportingManager(cordova.getActivity(), codePushPreferences);\n mainWebView = webView;\n }\n\n @Override\n public boolean execute(String action, CordovaArgs args, final CallbackContext callbackContext) {\n if (\"getServerURL\".equals(action)) {\n this.returnStringPreference(\"codepushserverurl\", callbackContext);\n return true;\n } else if (\"getDeploymentKey\".equals(action)) {\n this.returnStringPreference(DEPLOYMENT_KEY_PREFERENCE, callbackContext);\n return true;\n } else if (\"getNativeBuildTime\".equals(action)) {\n return execGetNativeBuildTime(callbackContext);\n } else if (\"getAppVersion\".equals(action)) {\n return execGetAppVersion(callbackContext);\n } else if (\"getBinaryHash\".equals(action)) {\n return execGetBinaryHash(callbackContext);\n } else if (\"preInstall\".equals(action)) {\n return execPreInstall(args, callbackContext);\n } else if (\"install\".equals(action)) {\n return execInstall(args, callbackContext);\n } else if (\"updateSuccess\".equals(action)) {\n return execUpdateSuccess(callbackContext);\n } else if (\"restartApplication\".equals(action)) {\n return execRestartApplication(args, callbackContext);\n } else if (\"isPendingUpdate\".equals(action)) {\n return execIsPendingUpdate(args, callbackContext);\n } else if (\"isFailedUpdate\".equals(action)) {\n return execIsFailedUpdate(args, callbackContext);\n } else if (\"isFirstRun\".equals(action)) {\n return execIsFirstRun(args, callbackContext);\n } else {\n return false;\n }\n }\n\n private boolean execGetBinaryHash(final CallbackContext callbackContext) {\n String cachedBinaryHash = codePushPackageManager.getCachedBinaryHash();\n if (cachedBinaryHash == null) {\n new AsyncTask() {\n @Override\n protected Void doInBackground(Void... params) {\n try {\n String binaryHash = UpdateHashUtils.getBinaryHash(cordova.getActivity());\n codePushPackageManager.saveBinaryHash(binaryHash);\n callbackContext.success(binaryHash);\n } catch (IOException e) {\n callbackContext.error(\"An error occurred when trying to get the hash of the binary contents. \" + e.getMessage());\n } catch (NoSuchAlgorithmException e) {\n callbackContext.error(\"An error occurred when trying to get the hash of the binary contents. \" + e.getMessage());\n }\n\n return null;\n }\n }.execute();\n } else {\n callbackContext.success(cachedBinaryHash);\n }\n\n return true;\n }\n\n private boolean execUpdateSuccess(CallbackContext callbackContext) {\n if (this.codePushPackageManager.isFirstRun()) {\n this.codePushPackageManager.saveFirstRunFlag();\n /* save reporting status for first install */\n try {\n String appVersion = Utilities.getAppVersionName(cordova.getActivity());\n codePushReportingManager.reportStatus(CodePushReportingManager.Status.STORE_VERSION, null, appVersion, mainWebView.getPreferences().getString(DEPLOYMENT_KEY_PREFERENCE, null), this.mainWebView);\n } catch (PackageManager.NameNotFoundException e) {\n // Should not happen unless the appVersion is not specified, in which case we can't report anything anyway.\n e.printStackTrace();\n }\n }\n\n if (this.codePushPackageManager.installNeedsConfirmation()) {\n /* save reporting status */\n CodePushPackageMetadata currentMetadata = this.codePushPackageManager.getCurrentPackageMetadata();\n codePushReportingManager.reportStatus(CodePushReportingManager.Status.UPDATE_CONFIRMED, currentMetadata.label, currentMetadata.appVersion, currentMetadata.deploymentKey, this.mainWebView);\n }\n\n this.codePushPackageManager.clearInstallNeedsConfirmation();\n this.cleanOldPackageSilently();\n callbackContext.success();\n\n return true;\n }\n\n private boolean execIsFirstRun(CordovaArgs args, CallbackContext callbackContext) {\n try {\n boolean isFirstRun = false;\n String packageHash = args.getString(0);\n CodePushPackageMetadata currentPackageMetadata = codePushPackageManager.getCurrentPackageMetadata();\n if (null != currentPackageMetadata) {\n /* This is the first run for a package if we just updated, and the current package hash matches the one provided. */\n isFirstRun = (null != packageHash\n && !packageHash.isEmpty()\n && packageHash.equals(currentPackageMetadata.packageHash)\n && didUpdate);\n }\n callbackContext.success(isFirstRun ? 1 : 0);\n } catch (JSONException e) {\n callbackContext.error(\"Invalid package hash. \" + e.getMessage());\n }\n return true;\n }\n\n private boolean execIsPendingUpdate(CordovaArgs args, CallbackContext callbackContext) {\n try {\n InstallOptions pendingInstall = this.codePushPackageManager.getPendingInstall();\n callbackContext.success((pendingInstall != null) ? 1 : 0);\n } catch (Exception e) {\n callbackContext.error(\"An error occurred. \" + e.getMessage());\n }\n return true;\n }\n\n private boolean execIsFailedUpdate(CordovaArgs args, CallbackContext callbackContext) {\n try {\n final String packageHash = args.getString(0);\n boolean isFailedUpdate = this.codePushPackageManager.isFailedUpdate(packageHash);\n callbackContext.success(isFailedUpdate ? 1 : 0);\n } catch (JSONException e) {\n callbackContext.error(\"Could not read the package hash: \" + e.getMessage());\n }\n return true;\n }\n\n private boolean execInstall(CordovaArgs args, CallbackContext callbackContext) {\n try {\n final String startLocation = args.getString(0);\n final InstallMode installMode = InstallMode.fromValue(args.optInt(1));\n final int minimumBackgroundDuration = args.optInt(2);\n\n File startPage = this.getStartPageForPackage(startLocation);\n if (startPage != null) {\n /* start page file exists */\n /* navigate to the start page */\n if (InstallMode.IMMEDIATE.equals(installMode)) {\n this.navigateToFile(startPage);\n markUpdate();\n } else {\n InstallOptions pendingInstall = new InstallOptions(installMode, minimumBackgroundDuration);\n this.codePushPackageManager.savePendingInstall(pendingInstall);\n }\n\n callbackContext.success();\n } else {\n callbackContext.error(\"Could not find the package start page.\");\n }\n } catch (Exception e) {\n callbackContext.error(\"Cound not read webview URL: \" + e.getMessage());\n }\n return true;\n }\n\n private boolean execRestartApplication(CordovaArgs args, CallbackContext callbackContext) {\n try {\n /* check if we have a deployed package already */\n CodePushPackageMetadata deployedPackageMetadata = this.codePushPackageManager.getCurrentPackageMetadata();\n if (deployedPackageMetadata != null) {\n callbackContext.success();\n didStartApp = false;\n onStart();\n } else {\n final String configLaunchUrl = this.getConfigLaunchUrl();\n if (!this.pluginDestroyed) {\n callbackContext.success();\n this.cordova.getActivity().runOnUiThread(new Runnable() {\n @Override\n public void run() {\n navigateToURL(configLaunchUrl);\n }\n });\n }\n }\n } catch (Exception e) {\n callbackContext.error(\"An error occurred while restarting the application.\" + e.getMessage());\n }\n return true;\n }\n\n private void markUpdate() {\n /* this flag will clear when reloading the plugin */\n this.didUpdate = true;\n this.codePushPackageManager.markInstallNeedsConfirmation();\n }\n\n private void cleanOldPackageSilently() {\n try {\n this.codePushPackageManager.cleanOldPackage();\n } catch (Exception e) {\n /* silently fail if there was an error during cleanup */\n Utilities.logException(e);\n }\n }\n\n private boolean execPreInstall(CordovaArgs args, CallbackContext callbackContext) {\n /* check if package is valid */\n try {\n final String startLocation = args.getString(0);\n File startPage = this.getStartPageForPackage(startLocation);\n if (startPage != null) {\n /* start page exists */\n callbackContext.success();\n } else {\n callbackContext.error(\"Could not get the package start page\");\n }\n } catch (Exception e) {\n callbackContext.error(\"Could not get the package start page\");\n }\n return true;\n }\n\n private boolean execGetAppVersion(CallbackContext callbackContext) {\n try {\n String appVersionName = Utilities.getAppVersionName(this.cordova.getActivity());\n callbackContext.success(appVersionName);\n } catch (PackageManager.NameNotFoundException e) {\n callbackContext.error(\"Cannot get application version.\");\n }\n return true;\n }\n\n private boolean execGetNativeBuildTime(CallbackContext callbackContext) {\n long millis = Utilities.getApkEntryBuildTime(RESOURCES_BUNDLE, this.cordova.getActivity());\n if (millis == -1) {\n callbackContext.error(\"Could not get the application buildstamp.\");\n } else {\n String result = String.valueOf(millis);\n callbackContext.success(result);\n }\n return true;\n }\n\n private void returnStringPreference(String preferenceName, CallbackContext callbackContext) {\n String result = mainWebView.getPreferences().getString(preferenceName, null);\n if (result != null) {\n callbackContext.success(result);\n } else {\n callbackContext.error(\"Could not get preference: \" + preferenceName);\n }\n }\n\n private void handleAppStart() {\n try {\n /* check if we have a deployed package already */\n CodePushPackageMetadata deployedPackageMetadata = this.codePushPackageManager.getCurrentPackageMetadata();\n if (deployedPackageMetadata != null) {\n String deployedPackageTimeStamp = deployedPackageMetadata.nativeBuildTime;\n long nativeBuildTime = Utilities.getApkEntryBuildTime(RESOURCES_BUNDLE, this.cordova.getActivity());\n if (nativeBuildTime != -1) {\n String currentAppTimeStamp = String.valueOf(nativeBuildTime);\n if ((deployedPackageTimeStamp != null) && (currentAppTimeStamp != null)) {\n if (deployedPackageTimeStamp.equals(currentAppTimeStamp)) {\n /* same native version, safe to launch from local storage */\n if (deployedPackageMetadata.localPath != null) {\n File startPage = this.getStartPageForPackage(deployedPackageMetadata.localPath);\n if (startPage != null) {\n /* file exists */\n navigateToFile(startPage);\n }\n }\n } else {\n /* application updated in the store or via local deployment */\n this.codePushPackageManager.cleanDeployments();\n this.codePushPackageManager.clearFailedUpdates();\n this.codePushPackageManager.clearPendingInstall();\n this.codePushPackageManager.clearInstallNeedsConfirmation();\n try {\n String appVersion = Utilities.getAppVersionName(cordova.getActivity());\n codePushReportingManager.reportStatus(CodePushReportingManager.Status.STORE_VERSION, null, appVersion, mainWebView.getPreferences().getString(DEPLOYMENT_KEY_PREFERENCE, null), this.mainWebView);\n } catch (PackageManager.NameNotFoundException e) {\n // Should not happen unless the appVersion is not specified, in which case we can't report anything anyway.\n e.printStackTrace();\n }\n }\n }\n }\n }\n } catch (Exception e) {\n /* empty - if there is an exception, the app will launch with the bundled content */\n }\n }\n\n private void handleUnconfirmedInstall(boolean navigate) {\n if (this.codePushPackageManager.installNeedsConfirmation()) {\n /* save status for later reporting */\n CodePushPackageMetadata currentMetadata = this.codePushPackageManager.getCurrentPackageMetadata();\n codePushReportingManager.reportStatus(CodePushReportingManager.Status.UPDATE_ROLLED_BACK, currentMetadata.label, currentMetadata.appVersion, currentMetadata.deploymentKey, this.mainWebView);\n\n /* revert application to the previous version */\n this.codePushPackageManager.clearInstallNeedsConfirmation();\n this.codePushPackageManager.revertToPreviousVersion();\n\n /* reload the previous version */\n if (navigate) {\n String url;\n try {\n CodePushPackageMetadata currentPackageMetadata = this.codePushPackageManager.getCurrentPackageMetadata();\n url = this.getStartPageURLForPackage(currentPackageMetadata.localPath);\n } catch (Exception e) {\n url = this.getConfigLaunchUrl();\n }\n\n final String finalURL = url;\n\n if (!this.pluginDestroyed) {\n this.cordova.getActivity().runOnUiThread(new Runnable() {\n @Override\n public void run() {\n navigateToURL(finalURL);\n }\n });\n }\n }\n }\n }\n\n private void navigateToFile(File startPageFile) throws MalformedURLException {\n if (startPageFile != null) {\n String url = startPageFile.toURI().toURL().toString();\n this.navigateToURL(url);\n }\n }\n\n private void navigateToURL(String url) {\n if (url != null) {\n CodePush.ShouldClearHistoryOnLoad = true;\n this.mainWebView.loadUrlIntoView(url, false);\n }\n }\n\n private File getStartPageForPackage(String packageLocation) {\n if (packageLocation != null) {\n File startPage = new File(this.cordova.getActivity().getFilesDir() + packageLocation, \"www/\" + getConfigStartPageName());\n if (startPage.exists()) {\n return startPage;\n }\n }\n\n return null;\n }\n\n private String getStartPageURLForPackage(String packageLocation) throws MalformedURLException {\n String result = null;\n File startPageFile = getStartPageForPackage(packageLocation);\n if (startPageFile != null) {\n result = startPageFile.toURI().toURL().toString();\n }\n\n return result;\n }\n\n private String getConfigStartPageName() {\n String launchUrl = this.getConfigLaunchUrl();\n int launchUrlLength = launchUrl.length();\n if (launchUrl.startsWith(CodePush.WWW_ASSET_PATH_PREFIX)) {\n launchUrl = launchUrl.substring(CodePush.WWW_ASSET_PATH_PREFIX.length(), launchUrlLength);\n }\n\n return launchUrl;\n }\n\n private String getConfigLaunchUrl() {\n ConfigXmlParser parser = new ConfigXmlParser();\n parser.parse(this.cordova.getActivity());\n return parser.getLaunchUrl();\n }\n\n /**\n * Called when the system is about to start resuming a previous activity.\n *\n * @param multitasking Flag indicating if multitasking is turned on for app\n */\n @Override\n public void onPause(boolean multitasking) {\n lastPausedTimeMs = new Date().getTime();\n }\n\n /**\n * Called when the activity will start interacting with the user.\n *\n * @param multitasking Flag indicating if multitasking is turned on for app\n */\n @Override\n public void onResume(boolean multitasking) {\n this.pluginDestroyed = false;\n }\n\n /**\n * Called when the activity is becoming visible to the user.\n */\n @Override\n public void onStart() {\n if (!didStartApp) {\n /* The application was just started. */\n didStartApp = true;\n InstallOptions pendingInstall = this.codePushPackageManager.getPendingInstall();\n\n /* Revert to the previous version if the install is not confirmed and no update is pending. */\n if (pendingInstall == null) {\n handleUnconfirmedInstall(false);\n }\n\n handleAppStart();\n /* Handle ON_NEXT_RESUME and ON_NEXT_RESTART pending installations */\n if (pendingInstall != null && (InstallMode.ON_NEXT_RESUME.equals(pendingInstall.installMode) || InstallMode.ON_NEXT_RESTART.equals(pendingInstall.installMode))) {\n this.markUpdate();\n this.codePushPackageManager.clearPendingInstall();\n }\n } else {\n /* The application was resumed from the background. */\n /* Handle ON_NEXT_RESUME pending installations. */\n InstallOptions pendingInstall = this.codePushPackageManager.getPendingInstall();\n long durationInBackground = (new Date().getTime() - lastPausedTimeMs) / 1000;\n if (pendingInstall != null && InstallMode.ON_NEXT_RESUME.equals(pendingInstall.installMode) && durationInBackground >= pendingInstall.minimumBackgroundDuration) {\n handleAppStart();\n this.markUpdate();\n this.codePushPackageManager.clearPendingInstall();\n }\n }\n }\n\n /**\n * The final call you receive before your activity is destroyed.\n */\n @Override\n public void onDestroy() {\n this.pluginDestroyed = true;\n }\n\n @Override\n public Object onMessage(String id, Object data) {\n if (\"onPageFinished\".equals(id)) {\n if (CodePush.ShouldClearHistoryOnLoad) {\n CodePush.ShouldClearHistoryOnLoad = false;\n if (this.mainWebView != null) {\n this.mainWebView.clearHistory();\n }\n }\n }\n\n return null;\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-code-push/src/android/CodePushPackageManager.java",
"content": "package com.microsoft.cordova;\n\nimport android.content.Context;\n\nimport org.json.JSONException;\n\nimport java.io.File;\nimport java.io.IOException;\n\n/**\n * Handles update package management.\n */\npublic class CodePushPackageManager {\n\n public static final String CODEPUSH_OLD_PACKAGE_PATH = \"/codepush/oldPackage.json\";\n public static final String CODEPUSH_CURRENT_PACKAGE_PATH = \"/codepush/currentPackage.json\";\n\n private Context context;\n private CodePushPreferences codePushPreferences;\n\n public CodePushPackageManager(Context context, CodePushPreferences codePushPreferences) {\n this.context = context;\n this.codePushPreferences = codePushPreferences;\n }\n\n public void revertToPreviousVersion() {\n /* delete the failed update package */\n CodePushPackageMetadata failedUpdateMetadata = this.getCurrentPackageMetadata();\n if (failedUpdateMetadata != null) {\n if (failedUpdateMetadata.packageHash != null) {\n this.codePushPreferences.saveFailedUpdate(failedUpdateMetadata.packageHash);\n }\n File failedUpdateDir = new File(this.context.getFilesDir() + failedUpdateMetadata.localPath);\n if (failedUpdateDir.exists()) {\n Utilities.deleteEntryRecursively(failedUpdateDir);\n }\n }\n\n /* replace the current file with the old one */\n File currentFile = new File(this.context.getFilesDir() + CodePushPackageManager.CODEPUSH_CURRENT_PACKAGE_PATH);\n File oldFile = new File(this.context.getFilesDir() + CodePushPackageManager.CODEPUSH_OLD_PACKAGE_PATH);\n\n if (currentFile.exists()) {\n currentFile.delete();\n }\n\n if (oldFile.exists()) {\n oldFile.renameTo(currentFile);\n }\n }\n\n public void cleanDeployments() {\n File file = new File(this.context.getFilesDir() + \"/codepush\");\n if (file.exists()) {\n Utilities.deleteEntryRecursively(file);\n }\n }\n\n public void cleanOldPackage() throws IOException, JSONException {\n CodePushPackageMetadata oldPackageMetadata = this.getOldPackageMetadata();\n if (oldPackageMetadata != null) {\n File file = new File(this.context.getFilesDir() + oldPackageMetadata.localPath);\n if (file.exists()) {\n Utilities.deleteEntryRecursively(file);\n }\n }\n }\n\n public CodePushPackageMetadata getOldPackageMetadata() {\n String currentPackageFilePath = this.context.getFilesDir() + CODEPUSH_OLD_PACKAGE_PATH;\n return CodePushPackageMetadata.getPackageMetadata(currentPackageFilePath);\n }\n\n public CodePushPackageMetadata getCurrentPackageMetadata() {\n String currentPackageFilePath = this.context.getFilesDir() + CODEPUSH_CURRENT_PACKAGE_PATH;\n return CodePushPackageMetadata.getPackageMetadata(currentPackageFilePath);\n }\n\n public String getCachedBinaryHash() {\n return this.codePushPreferences.getCachedBinaryHash();\n }\n\n public void saveBinaryHash(String binaryHash) {\n this.codePushPreferences.saveBinaryHash(binaryHash);\n }\n\n public boolean isFailedUpdate(String packageHash) {\n return this.codePushPreferences.isFailedUpdate(packageHash);\n }\n\n public void clearFailedUpdates() {\n this.codePushPreferences.clearFailedUpdates();\n }\n\n public void savePendingInstall(InstallOptions options) {\n this.codePushPreferences.savePendingInstall(options);\n }\n\n public InstallOptions getPendingInstall() {\n return this.codePushPreferences.getPendingInstall();\n }\n\n public void clearPendingInstall() {\n this.codePushPreferences.clearPendingInstall();\n }\n\n public void markInstallNeedsConfirmation() {\n this.codePushPreferences.markInstallNeedsConfirmation();\n }\n\n public void clearInstallNeedsConfirmation() {\n this.codePushPreferences.clearInstallNeedsConfirmation();\n }\n\n public boolean installNeedsConfirmation() {\n return this.codePushPreferences.installNeedsConfirmation();\n }\n\n public boolean isFirstRun() {\n return this.codePushPreferences.isFirstRun();\n }\n\n public void saveFirstRunFlag() {\n this.codePushPreferences.saveFirstRunFlag();\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-code-push/src/android/CodePushPackageMetadata.java",
"content": "package com.microsoft.cordova;\n\nimport org.json.JSONObject;\n\nimport java.io.File;\n\n/**\n * Model class for the CodePush metadata stored alongside a package deployment.\n */\npublic class CodePushPackageMetadata {\n public String deploymentKey;\n public String packageDescription;\n public String label;\n public String appVersion;\n public boolean isMandatory;\n public String packageHash;\n public long packageSize;\n public String nativeBuildTime;\n public String localPath;\n\n final static class JsonField {\n public static final String DeploymentKey = \"deploymentKey\";\n public static final String Description = \"description\";\n public static final String Label = \"label\";\n public static final String AppVersion = \"appVersion\";\n public static final String IsMandatory = \"isMandatory\";\n public static final String PackageHash = \"packageHash\";\n public static final String PackageSize = \"packageSize\";\n public static final String NativeBuildTime = \"nativeBuildTime\";\n public static final String LocalPath = \"localPath\";\n }\n\n public static CodePushPackageMetadata getPackageMetadata(String filePath) {\n CodePushPackageMetadata result = null;\n\n try {\n File file = new File(filePath);\n if (file.exists()) {\n String content = Utilities.readFileContents(file);\n result = new CodePushPackageMetadata();\n JSONObject jsonObject = new JSONObject(content);\n\n if (jsonObject.has(CodePushPackageMetadata.JsonField.DeploymentKey)) {\n result.deploymentKey = jsonObject.getString(CodePushPackageMetadata.JsonField.DeploymentKey);\n }\n\n if (jsonObject.has(CodePushPackageMetadata.JsonField.Description)) {\n result.packageDescription = jsonObject.getString(CodePushPackageMetadata.JsonField.Description);\n }\n\n if (jsonObject.has(CodePushPackageMetadata.JsonField.Label)) {\n result.label = jsonObject.getString(CodePushPackageMetadata.JsonField.Label);\n }\n\n if (jsonObject.has(CodePushPackageMetadata.JsonField.AppVersion)) {\n result.appVersion = jsonObject.getString(CodePushPackageMetadata.JsonField.AppVersion);\n }\n\n if (jsonObject.has(CodePushPackageMetadata.JsonField.IsMandatory)) {\n result.isMandatory = jsonObject.getBoolean(CodePushPackageMetadata.JsonField.IsMandatory);\n }\n\n if (jsonObject.has(CodePushPackageMetadata.JsonField.PackageHash)) {\n result.packageHash = jsonObject.getString(CodePushPackageMetadata.JsonField.PackageHash);\n }\n\n if (jsonObject.has(CodePushPackageMetadata.JsonField.PackageSize)) {\n result.packageSize = jsonObject.getLong(CodePushPackageMetadata.JsonField.PackageSize);\n }\n\n if (jsonObject.has(CodePushPackageMetadata.JsonField.NativeBuildTime)) {\n result.nativeBuildTime = jsonObject.getString(CodePushPackageMetadata.JsonField.NativeBuildTime);\n }\n\n if (jsonObject.has(CodePushPackageMetadata.JsonField.LocalPath)) {\n result.localPath = jsonObject.getString(CodePushPackageMetadata.JsonField.LocalPath);\n }\n }\n } catch (Exception e) {\n Utilities.logException(e);\n }\n\n return result;\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-code-push/src/android/CodePushPreferences.java",
"content": "package com.microsoft.cordova;\n\nimport android.content.Context;\nimport android.content.SharedPreferences;\n\nimport java.util.HashSet;\nimport java.util.Set;\n\n/**\n * Manages interaction with the Android preferences system.\n */\npublic class CodePushPreferences {\n\n private static final String BINARY_HASH_PREFERENCE = \"BINARY_HASH\";\n private static final String BINARY_HASH_PREFERENCE_KEY = \"BINARY_HASH_KEY\";\n private static final String FAILED_UPDATES_PREFERENCE = \"FAILED_UPDATES\";\n private static final String FAILED_UPDATES_KEY = \"FAILED_UPDATES_KEY\";\n private static final String PENDING_INSTALL_PREFERENCE = \"PENDING_INSTALL\";\n private static final String INSTALL_MODE_KEY = \"INSTALL_MODE_KEY\";\n private static final String INSTALL_MIN_BACKGROUND_DURATION = \"INSTALL_MINIMUM_BACKGROUND_DURATION\";\n private static final String INSTALL_NEEDS_CONFIRMATION = \"INSTALL_NEEDS_CONFIRMATION\";\n private static final String INSTALL_NEEDS_CONFIRMATION_KEY = \"INSTALL_NEEDS_CONFIRMATION_KEY\";\n private static final String FIRST_RUN_PREFERENCE = \"CODE_PUSH_FIRST_RUN\";\n private static final String FIRST_RUN_PREFERENCE_KEY = \"CODE_PUSH_FIRST_RUN_KEY\";\n private static final String LAST_VERSION_PREFERENCE = \"CODE_PUSH_LAST_VERSION\";\n private static final String LAST_VERSION_DEPLOYMENT_KEY_KEY = \"LAST_VERSION_DEPLOYMENT_KEY_KEY\";\n private static final String LAST_VERSION_LABEL_OR_APP_VERSION_KEY = \"LAST_VERSION_LABEL_OR_APP_VERSION_KEY\";\n\n private Context context;\n\n public CodePushPreferences(Context context) {\n this.context = context;\n }\n\n public String getCachedBinaryHash() {\n SharedPreferences preferences = context.getSharedPreferences(CodePushPreferences.BINARY_HASH_PREFERENCE, Context.MODE_PRIVATE);\n return preferences.getString(CodePushPreferences.BINARY_HASH_PREFERENCE_KEY, null);\n }\n\n public void saveBinaryHash(String binaryHash) {\n SharedPreferences preferences = context.getSharedPreferences(CodePushPreferences.BINARY_HASH_PREFERENCE, Context.MODE_PRIVATE);\n SharedPreferences.Editor editor = preferences.edit();\n editor.putString(CodePushPreferences.BINARY_HASH_PREFERENCE_KEY, binaryHash);\n editor.commit();\n }\n\n public void saveFailedUpdate(String hashCode) {\n SharedPreferences preferences = context.getSharedPreferences(CodePushPreferences.FAILED_UPDATES_PREFERENCE, Context.MODE_PRIVATE);\n Set failedUpdatesSet = preferences.getStringSet(CodePushPreferences.FAILED_UPDATES_KEY, null);\n if (failedUpdatesSet == null) {\n failedUpdatesSet = new HashSet();\n }\n\n failedUpdatesSet.add(hashCode);\n SharedPreferences.Editor editor = preferences.edit();\n editor.putStringSet(CodePushPreferences.FAILED_UPDATES_KEY, failedUpdatesSet);\n editor.commit();\n }\n\n public boolean isFailedUpdate(String hashCode) {\n if (hashCode == null) {\n return false;\n }\n\n SharedPreferences preferences = context.getSharedPreferences(CodePushPreferences.FAILED_UPDATES_PREFERENCE, Context.MODE_PRIVATE);\n Set failedUpdatesSet = preferences.getStringSet(CodePushPreferences.FAILED_UPDATES_KEY, null);\n return (failedUpdatesSet != null && failedUpdatesSet.contains(hashCode));\n }\n\n public void clearFailedUpdates() {\n this.clearPreferences(CodePushPreferences.FAILED_UPDATES_PREFERENCE);\n }\n\n public void savePendingInstall(InstallOptions installOptions) {\n SharedPreferences preferences = context.getSharedPreferences(CodePushPreferences.PENDING_INSTALL_PREFERENCE, Context.MODE_PRIVATE);\n SharedPreferences.Editor editor = preferences.edit();\n editor.putInt(CodePushPreferences.INSTALL_MODE_KEY, installOptions.installMode.getValue());\n editor.putInt(CodePushPreferences.INSTALL_MIN_BACKGROUND_DURATION, installOptions.minimumBackgroundDuration);\n editor.commit();\n }\n\n public void clearPendingInstall() {\n this.clearPreferences(CodePushPreferences.PENDING_INSTALL_PREFERENCE);\n }\n\n public InstallOptions getPendingInstall() {\n InstallOptions pendingInstall = null;\n\n SharedPreferences preferences = context.getSharedPreferences(CodePushPreferences.PENDING_INSTALL_PREFERENCE, Context.MODE_PRIVATE);\n int installMode = preferences.getInt(CodePushPreferences.INSTALL_MODE_KEY, -1);\n int minimumBackgroundDuration = preferences.getInt(CodePushPreferences.INSTALL_MIN_BACKGROUND_DURATION, -1);\n\n if (installMode != -1 && minimumBackgroundDuration != -1) {\n pendingInstall = new InstallOptions(InstallMode.fromValue(installMode), minimumBackgroundDuration);\n }\n\n return pendingInstall;\n }\n\n public void markInstallNeedsConfirmation() {\n SharedPreferences preferences = context.getSharedPreferences(CodePushPreferences.INSTALL_NEEDS_CONFIRMATION, Context.MODE_PRIVATE);\n SharedPreferences.Editor editor = preferences.edit();\n editor.putBoolean(CodePushPreferences.INSTALL_NEEDS_CONFIRMATION_KEY, true);\n editor.commit();\n }\n\n public void clearInstallNeedsConfirmation() {\n this.clearPreferences(CodePushPreferences.INSTALL_NEEDS_CONFIRMATION);\n }\n\n public boolean installNeedsConfirmation() {\n SharedPreferences preferences = context.getSharedPreferences(CodePushPreferences.INSTALL_NEEDS_CONFIRMATION, Context.MODE_PRIVATE);\n boolean notConfirmedInstall = preferences.getBoolean(CodePushPreferences.INSTALL_NEEDS_CONFIRMATION_KEY, false);\n return notConfirmedInstall;\n }\n\n public void saveFirstRunFlag() {\n SharedPreferences preferences = context.getSharedPreferences(CodePushPreferences.FIRST_RUN_PREFERENCE, Context.MODE_PRIVATE);\n SharedPreferences.Editor editor = preferences.edit();\n editor.putBoolean(CodePushPreferences.FIRST_RUN_PREFERENCE_KEY, false);\n editor.commit();\n }\n\n public boolean isFirstRun() {\n SharedPreferences preferences = context.getSharedPreferences(CodePushPreferences.FIRST_RUN_PREFERENCE, Context.MODE_PRIVATE);\n boolean isFirstRun = preferences.getBoolean(CodePushPreferences.FIRST_RUN_PREFERENCE_KEY, true);\n return isFirstRun;\n }\n\n public void clearPreferences(String preferencesId) {\n SharedPreferences preferences = context.getSharedPreferences(preferencesId, Context.MODE_PRIVATE);\n SharedPreferences.Editor editor = preferences.edit();\n editor.clear();\n editor.commit();\n }\n\n public void saveLastVersion(String labelOrAppVersion, String deploymentKey) {\n SharedPreferences preferences = context.getSharedPreferences(CodePushPreferences.LAST_VERSION_PREFERENCE, Context.MODE_PRIVATE);\n SharedPreferences.Editor editor = preferences.edit();\n editor.putString(CodePushPreferences.LAST_VERSION_LABEL_OR_APP_VERSION_KEY, labelOrAppVersion);\n editor.putString(CodePushPreferences.LAST_VERSION_DEPLOYMENT_KEY_KEY, deploymentKey);\n editor.commit();\n }\n\n public String getLastVersionDeploymentKey() {\n SharedPreferences preferences = context.getSharedPreferences(CodePushPreferences.LAST_VERSION_PREFERENCE, Context.MODE_PRIVATE);\n return preferences.getString(CodePushPreferences.LAST_VERSION_DEPLOYMENT_KEY_KEY, null);\n }\n\n public String getLastVersionLabelOrAppVersion() {\n SharedPreferences preferences = context.getSharedPreferences(CodePushPreferences.LAST_VERSION_PREFERENCE, Context.MODE_PRIVATE);\n return preferences.getString(CodePushPreferences.LAST_VERSION_LABEL_OR_APP_VERSION_KEY, null);\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-code-push/src/android/CodePushReportingManager.java",
"content": "package com.microsoft.cordova;\n\nimport org.apache.cordova.CordovaWebView;\n\nimport java.util.ArrayList;\nimport java.util.Locale;\nimport android.app.Activity;\n\n/**\n * Handles the native -> JS reporting mechanism.\n */\npublic class CodePushReportingManager {\n\n private Activity cordovaActivity;\n private CodePushPreferences codePushPreferences;\n\n /**\n * Defines application statuses we use in reporting events from the native to the JS layer.\n */\n public static enum Status {\n STORE_VERSION(0),\n UPDATE_CONFIRMED(1),\n UPDATE_ROLLED_BACK(2);\n\n private int value;\n\n Status(int i) {\n this.value = i;\n }\n\n /**\n * Returns the value associated with this enum.\n */\n public int getValue() {\n return this.value;\n }\n }\n\n public CodePushReportingManager(Activity cordovaActivity, CodePushPreferences codePushPreferences) {\n this.cordovaActivity = cordovaActivity;\n this.codePushPreferences = codePushPreferences;\n }\n\n /**\n * Invokes the window.codePush.reportStatus JS function for the given webView.\n */\n public void reportStatus(Status status, String label, String appVersion, String deploymentKey, final CordovaWebView webView) {\n /* JS function to call: window.codePush.reportStatus(status: number, label: String, appVersion: String, currentDeploymentKey: String, previousLabelOrAppVersion?: string, previousDeploymentKey?: string) */\n if (deploymentKey == null || deploymentKey.isEmpty()) {\n return;\n }\n\n final String script = String.format(\n Locale.US,\n \"javascript:document.addEventListener(\\\"deviceready\\\", function () { window.codePush.reportStatus(%d, %s, %s, %s, %s, %s); });\",\n status.getValue(),\n convertStringParameter(label),\n convertStringParameter(appVersion),\n convertStringParameter(deploymentKey),\n convertStringParameter(codePushPreferences.getLastVersionLabelOrAppVersion()),\n convertStringParameter(codePushPreferences.getLastVersionDeploymentKey())\n );\n\n if (status == Status.STORE_VERSION || status == Status.UPDATE_CONFIRMED) {\n codePushPreferences.saveLastVersion(label == null ? appVersion : label, deploymentKey);\n }\n\n cordovaActivity.runOnUiThread(new Runnable() {\n public void run() {\n webView.loadUrl(script);\n }\n });\n }\n\n private String convertStringParameter(String input) {\n if (null == input) {\n return \"undefined\";\n } else {\n return \"'\" + input + \"'\";\n }\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-code-push/src/android/InstallMode.java",
"content": "package com.microsoft.cordova;\n\n/**\n * Defines the available InstallModes.\n */\npublic enum InstallMode {\n IMMEDIATE(0),\n ON_NEXT_RESTART(1),\n ON_NEXT_RESUME(2);\n\n private int value;\n\n InstallMode(int i) {\n this.value = i;\n }\n\n /**\n * Returns the InstallMode associated with a given value.\n * If no InstallMode is associated with the provided value, null is returned.\n */\n public static InstallMode fromValue(int i) {\n for (InstallMode mode : InstallMode.values()) {\n if (i == mode.value) {\n return mode;\n }\n }\n\n return null;\n }\n\n /**\n * Returns the value associated with this enum.\n */\n public int getValue() {\n return this.value;\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-code-push/src/android/InstallOptions.java",
"content": "package com.microsoft.cordova;\n\n/**\n * Defines the update installation options.\n */\npublic class InstallOptions {\n public InstallMode installMode;\n public int minimumBackgroundDuration;\n\n public InstallOptions(InstallMode installMode, int minimumBackgroundDuration) {\n this.installMode = installMode;\n this.minimumBackgroundDuration = minimumBackgroundDuration;\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-code-push/src/android/UpdateHashUtils.java",
"content": "package com.microsoft.cordova;\n\nimport android.app.Activity;\nimport android.content.res.AssetManager;\n\nimport org.json.JSONArray;\n\nimport java.io.ByteArrayInputStream;\nimport java.io.IOException;\nimport java.io.InputStream;\nimport java.security.DigestInputStream;\nimport java.security.MessageDigest;\nimport java.security.NoSuchAlgorithmException;\nimport java.util.ArrayList;\nimport java.util.Collections;\n\n/**\n * Utilities class used for native operations related to calculating hashes of update contents.\n */\npublic class UpdateHashUtils {\n\n public static String getBinaryHash(Activity activity) throws IOException, NoSuchAlgorithmException {\n ArrayList manifestEntries = new ArrayList();\n addFolderEntriesToManifest(manifestEntries, \"www\", activity.getAssets());\n Collections.sort(manifestEntries);\n JSONArray manifestJSONArray = new JSONArray();\n for (String manifestEntry : manifestEntries) {\n manifestJSONArray.put(manifestEntry);\n }\n\n // The JSON serialization turns path separators into \"\\/\", e.g. \"www\\/images\\/image.png\"\n String manifestString = manifestJSONArray.toString().replace(\"\\\\/\", \"/\");\n return computeHash(new ByteArrayInputStream(manifestString.getBytes()));\n }\n\n private static void addFolderEntriesToManifest(ArrayList manifestEntries, String path, AssetManager assetManager) throws IOException, NoSuchAlgorithmException {\n String[] fileList = assetManager.list(path);\n if (fileList.length > 0) {\n // This is a folder, recursively add folder entries to the manifest.\n for (String pathInFolder : fileList) {\n addFolderEntriesToManifest(manifestEntries, path + \"/\" + pathInFolder, assetManager);\n }\n } else {\n // This is a file, compute a hash and create a manifest entry for it.\n manifestEntries.add(path + \":\" + computeHash(assetManager.open(path)));\n }\n }\n\n private static String computeHash(InputStream dataStream) throws IOException, NoSuchAlgorithmException {\n MessageDigest messageDigest = null;\n DigestInputStream digestInputStream = null;\n try {\n messageDigest = MessageDigest.getInstance(\"SHA-256\");\n digestInputStream = new DigestInputStream(dataStream, messageDigest);\n byte[] byteBuffer = new byte[1024 * 8];\n while (digestInputStream.read(byteBuffer) != -1);\n } finally {\n try {\n if (digestInputStream != null) digestInputStream.close();\n if (dataStream != null) dataStream.close();\n } catch (IOException e) {\n e.printStackTrace();\n }\n }\n\n byte[] hash = messageDigest.digest();\n return String.format(\"%064x\", new java.math.BigInteger(1, hash));\n }\n\n}\n"
},
{
"path": "plugins/cordova-plugin-code-push/src/android/Utilities.java",
"content": "package com.microsoft.cordova;\n\nimport android.content.Context;\nimport android.content.pm.ApplicationInfo;\nimport android.content.pm.PackageInfo;\nimport android.content.pm.PackageManager;\nimport android.util.Log;\n\nimport java.io.BufferedReader;\nimport java.io.File;\nimport java.io.FileReader;\nimport java.io.IOException;\nimport java.util.zip.ZipEntry;\nimport java.util.zip.ZipFile;\n\n/**\n * Utilities class used for file and other common native operations.\n */\npublic class Utilities {\n public static String readFileContents(File file) throws IOException {\n StringBuilder sb = new StringBuilder();\n BufferedReader br = null;\n try {\n br = new BufferedReader(new FileReader(file));\n String currentLine;\n\n while ((currentLine = br.readLine()) != null) {\n sb.append(currentLine);\n sb.append('\\n');\n }\n } finally {\n if (br != null) {\n br.close();\n }\n }\n\n return sb.toString();\n }\n\n public static void deleteEntryRecursively(File entry) {\n if (entry.isDirectory()) {\n /* delete contents first */\n for (File child : entry.listFiles()) {\n Utilities.deleteEntryRecursively(child);\n }\n }\n\n entry.delete();\n }\n\n public static String getAppVersionName(Context context) throws PackageManager.NameNotFoundException {\n String currentPackageName = context.getPackageName();\n PackageInfo packageInfo = context.getPackageManager().getPackageInfo(currentPackageName, 0);\n return packageInfo.versionName;\n }\n\n public static long getApkEntryBuildTime(String entryName, Context context) {\n ZipFile applicationFile;\n long result = -1;\n\n try {\n ApplicationInfo ai = context.getPackageManager().getApplicationInfo(context.getPackageName(), 0);\n applicationFile = new ZipFile(ai.sourceDir);\n ZipEntry classesDexEntry = applicationFile.getEntry(entryName);\n result = classesDexEntry.getTime();\n applicationFile.close();\n } catch (Exception e) {\n /* empty, will return -1 */\n }\n\n return result;\n }\n\n public static void logException(Throwable e) {\n Log.e(CodePush.class.getName(), \"An error occured. \" + e.getMessage(), e);\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-code-push/src/android/build-extras.gradle",
"content": "// Needed to speed up asset listing: refer to https://github.com/apache/cordova-plugin-file/blob/76c8fd5e43598ea660c2db64eb08e2659b45a575/src/android/AssetFilesystem.java#L41\n// Taken from https://raw.githubusercontent.com/apache/cordova-plugin-file/ed4cb4b999373eaa80b2fe1f38e3fc24db1b00ae/src/android/build-extras.gradle\n\n/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\next.postBuildExtras = {\n def inAssetsDir = file(\"assets\")\n def outAssetsDir = inAssetsDir\n def outFile = new File(outAssetsDir, \"cdvasset.manifest\")\n\n def newTask = task(\"cdvCreateAssetManifest\") << {\n def contents = new HashMap()\n def sizes = new HashMap()\n contents[\"\"] = inAssetsDir.list()\n def tree = fileTree(dir: inAssetsDir)\n tree.visit { fileDetails ->\n if (fileDetails.isDirectory()) {\n contents[fileDetails.relativePath.toString()] = fileDetails.file.list()\n } else {\n sizes[fileDetails.relativePath.toString()] = fileDetails.file.length()\n }\n }\n\n outAssetsDir.mkdirs()\n outFile.withObjectOutputStream { oos ->\n oos.writeObject(contents)\n oos.writeObject(sizes)\n }\n }\n newTask.inputs.dir inAssetsDir\n newTask.outputs.file outFile\n def preBuildTask = tasks[\"preBuild\"]\n preBuildTask.dependsOn(newTask)\n}"
},
{
"path": "plugins/cordova-plugin-code-push/src/ios/CodePush.h",
"content": "#import \n\n@interface CodePush : CDVPlugin\n\n- (void)getServerURL:(CDVInvokedUrlCommand*)command;\n- (void)getDeploymentKey:(CDVInvokedUrlCommand*)command;\n- (void)getNativeBuildTime:(CDVInvokedUrlCommand*)command;\n- (void)getAppVersion:(CDVInvokedUrlCommand*)command;\n- (void)install:(CDVInvokedUrlCommand *)command;\n- (void)preInstall:(CDVInvokedUrlCommand *)command;\n- (void)isFailedUpdate:(CDVInvokedUrlCommand *)command;\n- (void)isFirstRun:(CDVInvokedUrlCommand *)command;\n- (void)isPendingUpdate:(CDVInvokedUrlCommand *)command;\n- (void)updateSuccess:(CDVInvokedUrlCommand *)command;\n- (void)restartApplication:(CDVInvokedUrlCommand *)command;\n- (void)pluginInitialize;\n\n@end\n\n"
},
{
"path": "plugins/cordova-plugin-code-push/src/ios/CodePush.m",
"content": "#import \n#import \n#import \"CodePush.h\"\n#import \"CodePushPackageMetadata.h\"\n#import \"CodePushPackageManager.h\"\n#import \"Utilities.h\"\n#import \"InstallOptions.h\"\n#import \"InstallMode.h\"\n#import \"CodePushReportingManager.h\"\n#import \"UpdateHashUtils.h\"\n\n@implementation CodePush\n\nbool didUpdate = false;\nbool pendingInstall = false;\nNSDate* lastResignedDate;\nconst NSString* DeploymentKeyPreference = @\"codepushdeploymentkey\";\n\n- (void)getBinaryHash:(CDVInvokedUrlCommand *)command {\n CDVPluginResult* pluginResult = nil;\n NSString* binaryHash = [CodePushPackageManager getCachedBinaryHash];\n if (binaryHash) {\n pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK\n messageAsString:binaryHash];\n } else {\n NSError* error;\n binaryHash = [UpdateHashUtils getBinaryHash:&error];\n if (error) {\n pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR\n messageAsString:[@\"An error occurred when trying to get the hash of the binary contents. \" stringByAppendingString:error.description]];\n } else {\n [CodePushPackageManager saveBinaryHash:binaryHash];\n pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK\n messageAsString:binaryHash];\n }\n }\n\n [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];\n}\n\n- (void)handleUnconfirmedInstall:(BOOL)navigate {\n if ([CodePushPackageManager installNeedsConfirmation]) {\n /* save reporting status */\n CodePushPackageMetadata* currentMetadata = [CodePushPackageManager getCurrentPackageMetadata];\n [CodePushReportingManager reportStatus:UPDATE_ROLLED_BACK withLabel:currentMetadata.label version:currentMetadata.appVersion deploymentKey:currentMetadata.deploymentKey webView:self.webView];\n\n [CodePushPackageManager clearInstallNeedsConfirmation];\n [CodePushPackageManager revertToPreviousVersion];\n if (navigate) {\n CodePushPackageMetadata* currentMetadata = [CodePushPackageManager getCurrentPackageMetadata];\n bool revertSuccess = (nil != currentMetadata && [self loadPackage:currentMetadata.localPath]);\n if (!revertSuccess) {\n /* first update failed, go back to store version */\n [self loadStoreVersion];\n }\n }\n }\n}\n\n- (void)updateSuccess:(CDVInvokedUrlCommand *)command {\n if ([CodePushPackageManager isFirstRun]) {\n [CodePushPackageManager markFirstRunFlag];\n NSString *appVersion = [[NSBundle mainBundle] objectForInfoDictionaryKey:@\"CFBundleShortVersionString\"];\n NSString *deploymentKey = ((CDVViewController *)self.viewController).settings[DeploymentKeyPreference];\n [CodePushReportingManager reportStatus:STORE_VERSION withLabel:nil version:appVersion deploymentKey:deploymentKey webView:self.webView];\n }\n\n if ([CodePushPackageManager installNeedsConfirmation]) {\n /* save reporting status */\n CodePushPackageMetadata* currentMetadata = [CodePushPackageManager getCurrentPackageMetadata];\n [CodePushReportingManager reportStatus:UPDATE_CONFIRMED withLabel:currentMetadata.label version:currentMetadata.appVersion deploymentKey:currentMetadata.deploymentKey webView:self.webView];\n }\n\n [CodePushPackageManager clearInstallNeedsConfirmation];\n [CodePushPackageManager cleanOldPackage];\n CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];\n [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];\n}\n\n- (void)install:(CDVInvokedUrlCommand *)command {\n CDVPluginResult* pluginResult = nil;\n\n NSString* location = [command argumentAtIndex:0 withDefault:nil andClass:[NSString class]];\n NSString* installModeString = [command argumentAtIndex:1 withDefault:IMMEDIATE andClass:[NSString class]];\n NSString* minimumBackgroundDurationString = [command argumentAtIndex:2 withDefault:0 andClass:[NSString class]];\n\n InstallOptions* options = [[InstallOptions alloc] init];\n [options setInstallMode:[installModeString intValue]];\n [options setMinimumBackgroundDuration:[minimumBackgroundDurationString intValue]];\n\n if ([options installMode] == IMMEDIATE) {\n if (nil == location) {\n pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@\"Cannot read the start URL.\"];\n }\n else {\n bool applied = [self loadPackage: location];\n if (applied) {\n [self markUpdate];\n pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];\n }\n else {\n pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@\"An error happened during package install.\"];\n }\n }\n }\n else {\n /* install on restart or on resume */\n [CodePushPackageManager savePendingInstall:options];\n pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];\n }\n\n [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];\n}\n\n- (void)restartApplication:(CDVInvokedUrlCommand *)command {\n /* Callback before navigating */\n CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];\n [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];\n\n CodePushPackageMetadata* deployedPackageMetadata = [CodePushPackageManager getCurrentPackageMetadata];\n if (deployedPackageMetadata && deployedPackageMetadata.localPath && [self getStartPageURLForLocalPackage:deployedPackageMetadata.localPath]) {\n [self loadPackage: deployedPackageMetadata.localPath];\n InstallOptions* pendingInstall = [CodePushPackageManager getPendingInstall];\n if (pendingInstall) {\n [self markUpdate];\n [CodePushPackageManager clearPendingInstall];\n }\n }\n else {\n [self loadStoreVersion];\n }\n}\n\n- (void) markUpdate {\n didUpdate = YES;\n [CodePushPackageManager markInstallNeedsConfirmation];\n}\n\n- (void)preInstall:(CDVInvokedUrlCommand *)command {\n CDVPluginResult* pluginResult = nil;\n\n NSString* location = [command argumentAtIndex:0 withDefault:nil andClass:[NSString class]];\n if (nil == location) {\n pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@\"Cannot read the start URL.\"];\n }\n else {\n NSURL* URL = [self getStartPageURLForLocalPackage:location];\n if (URL) {\n pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];\n }\n else {\n pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@\"Could not find start page in package.\"];\n }\n }\n\n [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];\n}\n\n- (void)getServerURL:(CDVInvokedUrlCommand *)command {\n [self sendResultForPreference:@\"codepushserverurl\" command:command];\n}\n\n- (void)getDeploymentKey:(CDVInvokedUrlCommand *)command {\n [self sendResultForPreference:DeploymentKeyPreference command:command];\n}\n\n\n- (void)getNativeBuildTime:(CDVInvokedUrlCommand *)command {\n NSString* timeStamp = [Utilities getApplicationTimestamp];\n CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:timeStamp];\n [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];\n}\n\n- (void)sendResultForPreference:(NSString*)preferenceName command:(CDVInvokedUrlCommand*)command {\n NSString* preferenceValue = ((CDVViewController *)self.viewController).settings[preferenceName];\n // length of NIL is zero\n CDVPluginResult* pluginResult;\n if ([preferenceValue length] > 0) {\n pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:preferenceValue];\n } else {\n pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:[NSString stringWithFormat:@\"Could not find preference %@\", preferenceName]];\n }\n\n [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];\n}\n\n- (void)dealloc {\n [[NSNotificationCenter defaultCenter] removeObserver:self];\n}\n\n- (void)handleAppStart {\n // check if we have a deployed package\n CodePushPackageMetadata* deployedPackageMetadata = [CodePushPackageManager getCurrentPackageMetadata];\n if (deployedPackageMetadata) {\n NSString* deployedPackageNativeBuildTime = deployedPackageMetadata.nativeBuildTime;\n NSString* applicationBuildTime = [Utilities getApplicationTimestamp];\n\n if (deployedPackageNativeBuildTime != nil && applicationBuildTime != nil) {\n if ([deployedPackageNativeBuildTime isEqualToString: applicationBuildTime] ) {\n // same version, safe to launch from local storage\n if (deployedPackageMetadata.localPath) {\n [self redirectStartPageToURL: deployedPackageMetadata.localPath];\n }\n }\n else {\n // installed native version is different from package version => clean up deployed package and do not modify start page\n [CodePushPackageManager cleanDeployments];\n [CodePushPackageManager clearFailedUpdates];\n [CodePushPackageManager clearPendingInstall];\n [CodePushPackageManager clearInstallNeedsConfirmation];\n NSString *appVersion = [[NSBundle mainBundle] objectForInfoDictionaryKey:@\"CFBundleShortVersionString\"];\n NSString *deploymentKey = ((CDVViewController *)self.viewController).settings[DeploymentKeyPreference];\n [CodePushReportingManager reportStatus:STORE_VERSION withLabel:nil version:appVersion deploymentKey:deploymentKey webView:self.webView];\n }\n }\n }\n}\n\n- (void)pluginInitialize {\n // register for \"on resume\", \"on pause\" notifications\n [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(applicationWillEnterForeground) name:UIApplicationWillEnterForegroundNotification object:nil];\n [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(applicationWillResignActive) name:UIApplicationWillResignActiveNotification object:nil];\n InstallOptions* pendingInstall = [CodePushPackageManager getPendingInstall];\n if (!pendingInstall) {\n [self handleUnconfirmedInstall:NO];\n }\n [self handleAppStart];\n\n // handle both ON_NEXT_RESUME and ON_NEXT_RESTART - the application might have been killed after transitioning to the background\n if (pendingInstall && (pendingInstall.installMode == ON_NEXT_RESTART || pendingInstall.installMode == ON_NEXT_RESUME)) {\n [self markUpdate];\n [CodePushPackageManager clearPendingInstall];\n }\n}\n\n- (void)applicationWillEnterForeground {\n InstallOptions* pendingInstall = [CodePushPackageManager getPendingInstall];\n // calculate the duration that the app was in the background\n long durationInBackground = lastResignedDate ? [[NSDate date] timeIntervalSinceDate:lastResignedDate] : 0;\n if (pendingInstall && pendingInstall.installMode == ON_NEXT_RESUME && durationInBackground >= pendingInstall.minimumBackgroundDuration) {\n CodePushPackageMetadata* deployedPackageMetadata = [CodePushPackageManager getCurrentPackageMetadata];\n if (deployedPackageMetadata && deployedPackageMetadata.localPath) {\n bool applied = [self loadPackage: deployedPackageMetadata.localPath];\n if (applied) {\n [self markUpdate];\n [CodePushPackageManager clearPendingInstall];\n }\n }\n }\n}\n\n- (void)applicationWillResignActive {\n // Save the current time so that when the app is later resumed, we can detect how long it was in the background\n lastResignedDate = [NSDate date];\n}\n\n- (BOOL)loadPackage:(NSString*)packageLocation {\n NSURL* URL = [self getStartPageURLForLocalPackage:packageLocation];\n if (URL) {\n [self loadURL:URL];\n return YES;\n }\n\n return NO;\n}\n\n- (void)loadURL:(NSURL*)url {\n // Cast to a UIWebView here to enable call to loadRequest.\n // Both UIWebView and WKWebview share this call, so regardless of which type the returned webview is, this will work.\n [(UIWebView*)self.webView loadRequest:[NSURLRequest requestWithURL:url]];\n}\n\n- (void)loadStoreVersion {\n NSString* mainBundlePath = [[NSBundle mainBundle] bundlePath];\n NSString* configStartPage = [self getConfigLaunchUrl];\n NSArray* realLocationArray = @[mainBundlePath, @\"www\", configStartPage];\n NSString* mainPageLocation = [NSString pathWithComponents:realLocationArray];\n if ([[NSFileManager defaultManager] fileExistsAtPath:mainPageLocation]) {\n NSURL* mainPagePath = [NSURL fileURLWithPath:mainPageLocation];\n [self loadURL:mainPagePath];\n }\n}\n\n- (NSString*)getConfigLaunchUrl\n{\n CDVConfigParser* delegate = [[CDVConfigParser alloc] init];\n NSString* configPath = [[NSBundle mainBundle] pathForResource:@\"config\" ofType:@\"xml\"];\n NSURL* configUrl = [NSURL fileURLWithPath:configPath];\n\n NSXMLParser* configParser = [[NSXMLParser alloc] initWithContentsOfURL:configUrl];\n [configParser setDelegate:((id < NSXMLParserDelegate >)delegate)];\n [configParser parse];\n\n return delegate.startPage;\n}\n\n- (NSURL *)getStartPageURLForLocalPackage:(NSString*)packageLocation {\n if (packageLocation) {\n NSString* startPage = [self getConfigLaunchUrl];\n NSString* libraryLocation = [NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES) objectAtIndex:0];\n NSArray* realLocationArray = @[libraryLocation, @\"NoCloud\", packageLocation, @\"www\", startPage];\n NSString* realStartPageLocation = [NSString pathWithComponents:realLocationArray];\n if ([[NSFileManager defaultManager] fileExistsAtPath:realStartPageLocation]) {\n return [NSURL fileURLWithPath:realStartPageLocation];\n }\n }\n\n return nil;\n}\n\n- (void)redirectStartPageToURL:(NSString*)packageLocation{\n NSURL* URL = [self getStartPageURLForLocalPackage:packageLocation];\n if (URL) {\n ((CDVViewController *)self.viewController).startPage = [URL absoluteString];\n }\n}\n\n- (void)isFailedUpdate:(CDVInvokedUrlCommand *)command {\n CDVPluginResult* result;\n NSString* packageHash = [command argumentAtIndex:0 withDefault:nil andClass:[NSString class]];\n if (nil == packageHash) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@\"Invalid package hash parameter.\"];\n }\n else {\n BOOL failedHash = [CodePushPackageManager isFailedHash:packageHash];\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsInt:failedHash ? 1 : 0];\n }\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n- (void)isFirstRun:(CDVInvokedUrlCommand *)command {\n CDVPluginResult* result;\n BOOL isFirstRun = NO;\n\n NSString* packageHash = [command argumentAtIndex:0 withDefault:nil andClass:[NSString class]];\n CodePushPackageMetadata* currentPackageMetadata = [CodePushPackageManager getCurrentPackageMetadata];\n if (currentPackageMetadata) {\n isFirstRun = (nil != packageHash\n && [packageHash length] > 0\n && [packageHash isEqualToString:currentPackageMetadata.packageHash]\n && didUpdate);\n }\n\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsInt:isFirstRun ? 1 : 0];\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n- (void)isPendingUpdate:(CDVInvokedUrlCommand *)command {\n CDVPluginResult* result;\n\n InstallOptions* pendingInstall = [CodePushPackageManager getPendingInstall];\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsInt:pendingInstall ? 1 : 0];\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n- (void)getAppVersion:(CDVInvokedUrlCommand *)command {\n NSString* version = [[NSBundle mainBundle] objectForInfoDictionaryKey:@\"CFBundleShortVersionString\"];\n CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:version];\n [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];\n}\n\n@end\n\n"
},
{
"path": "plugins/cordova-plugin-code-push/src/ios/CodePushPackageManager.h",
"content": "#import \"CodePushPackageMetadata.h\"\n#import \"InstallOptions.h\"\n\n@interface CodePushPackageManager : NSObject\n\n+ (void)cleanOldPackage;\n+ (void)revertToPreviousVersion;\n+ (CodePushPackageMetadata*)getCurrentPackageMetadata;\n+ (void)clearFailedUpdates;\n+ (void)cleanDeployments;\n+ (NSString*)getCachedBinaryHash;\n+ (void)saveBinaryHash:(NSString*)binaryHash;\n+ (BOOL)isFailedHash:(NSString*)packageHash;\n+ (void)savePendingInstall:(InstallOptions *)installOptions;\n+ (InstallOptions*)getPendingInstall;\n+ (void)clearPendingInstall;\n+ (void)markInstallNeedsConfirmation;\n+ (BOOL)installNeedsConfirmation;\n+ (void)clearInstallNeedsConfirmation;\n+ (void)markFirstRunFlag;\n+ (BOOL)isFirstRun;\n\n@end\n"
},
{
"path": "plugins/cordova-plugin-code-push/src/ios/CodePushPackageManager.m",
"content": "#import \"CodePushPackageManager.h\"\n#import \"CodePushPackageMetadata.h\"\n#import \"InstallOptions.h\"\n\n@implementation CodePushPackageManager\n\nNSString* const BinaryHashKey = @\"BINARY_HASH\";\nNSString* const FailedUpdatesKey = @\"FAILED_UPDATES\";\nNSString* const PendingInstallKey = @\"PENDING_INSTALL\";\nNSString* const NotConfirmedInstallKey = @\"NOT_CONFIRMED_INSTALL\";\nNSString* const IsFirstRunKey = @\"FIRST_RUN\";\nNSString* const OldPackageManifestName = @\"oldPackage.json\";\nNSString* const CurrentPackageManifestName = @\"currentPackage.json\";\n\n+(void)cleanOldPackage {\n CodePushPackageMetadata* oldMetadata = [self getOldPackageMetadata];\n \n // delete the package folder\n [self cleanPackageDirectory:oldMetadata];\n \n // delete the downloads folder\n [self cleanDownloads];\n}\n\n+(void)cleanDownloads {\n NSString* libraryLocation = [NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES) objectAtIndex:0];\n NSArray* downloadFolderArray = @[libraryLocation, @\"NoCloud\", @\"codepush\", @\"download\"];\n NSString* downloadFolderLocation = [NSString pathWithComponents:downloadFolderArray];\n if ([[NSFileManager defaultManager] fileExistsAtPath: downloadFolderLocation]) {\n [[NSFileManager defaultManager] removeItemAtPath:downloadFolderLocation error:nil];\n }\n}\n\n+(void)cleanPackageDirectory:(CodePushPackageMetadata*)packageMetadata {\n NSString* libraryLocation = [NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES) objectAtIndex:0];\n \n if (nil != packageMetadata && nil != packageMetadata.localPath) {\n // delete the package folder\n NSArray* oldPackageDir = @[libraryLocation, @\"NoCloud\", packageMetadata.localPath];\n NSString* oldPackageDirPath = [NSString pathWithComponents:oldPackageDir];\n if ([[NSFileManager defaultManager] fileExistsAtPath: oldPackageDirPath]) {\n [[NSFileManager defaultManager] removeItemAtPath:oldPackageDirPath error:nil];\n }\n }\n}\n\n+(void)cleanDeployments {\n // check if the file exists\n NSString* libraryLocation = [NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES) objectAtIndex:0];\n NSArray* codePushDirectoryArray = @[libraryLocation, @\"NoCloud\", @\"codepush\" ];\n NSString* codePushDirPath = [NSString pathWithComponents:codePushDirectoryArray];\n if ([[NSFileManager defaultManager] fileExistsAtPath:codePushDirPath]) {\n [[NSFileManager defaultManager] removeItemAtPath:codePushDirPath error:nil];\n }\n}\n\n+ (NSString*)getCachedBinaryHash {\n NSUserDefaults* preferences = [NSUserDefaults standardUserDefaults];\n NSString* cachedBinaryHash = [preferences objectForKey:BinaryHashKey];\n return cachedBinaryHash;\n}\n\n+ (void)saveBinaryHash:(NSString*)binaryHash {\n NSUserDefaults* preferences = [NSUserDefaults standardUserDefaults];\n [preferences setObject:binaryHash forKey:BinaryHashKey];\n [preferences synchronize];\n}\n\n+ (CodePushPackageMetadata*)getOldPackageMetadata {\n return [self readPackageManifest:OldPackageManifestName];\n}\n\n+ (CodePushPackageMetadata*)getCurrentPackageMetadata {\n return [self readPackageManifest:CurrentPackageManifestName];\n}\n\n+ (BOOL)isFailedHash:(NSString*)packageHash {\n NSUserDefaults* preferences = [NSUserDefaults standardUserDefaults];\n NSMutableArray* failedUpdates = [preferences objectForKey:FailedUpdatesKey];\n return (nil != failedUpdates && [failedUpdates containsObject:packageHash]);\n}\n\n+ (void)saveFailedUpdate:(NSString *)packageHash {\n NSUserDefaults* preferences = [NSUserDefaults standardUserDefaults];\n NSMutableArray* failedUpdates = [[preferences objectForKey:FailedUpdatesKey] mutableCopy];\n if (nil == failedUpdates) {\n failedUpdates = [[NSMutableArray alloc] init];\n }\n \n [failedUpdates addObject:packageHash];\n [preferences setObject:failedUpdates forKey:FailedUpdatesKey];\n [preferences synchronize];\n}\n\n+ (void)clearFailedUpdates {\n NSUserDefaults *preferences = [NSUserDefaults standardUserDefaults];\n [preferences removeObjectForKey:FailedUpdatesKey];\n}\n\n+ (void)savePendingInstall:(InstallOptions *)installOptions {\n NSUserDefaults* preferences = [NSUserDefaults standardUserDefaults];\n NSData* serializedPendingInstall = [NSKeyedArchiver archivedDataWithRootObject:installOptions];\n [preferences setObject:serializedPendingInstall forKey:PendingInstallKey];\n [preferences synchronize];\n}\n\n+ (InstallOptions*)getPendingInstall{\n NSUserDefaults* preferences = [NSUserDefaults standardUserDefaults];\n NSData* serializedPendingInstall = [[preferences objectForKey:PendingInstallKey] mutableCopy];\n if (serializedPendingInstall) {\n InstallOptions* pendingInstall = [NSKeyedUnarchiver unarchiveObjectWithData:serializedPendingInstall];\n return pendingInstall;\n }\n \n return nil;\n}\n\n+ (void)clearPendingInstall {\n NSUserDefaults *preferences = [NSUserDefaults standardUserDefaults];\n [preferences removeObjectForKey:PendingInstallKey];\n}\n\n+ (void)markFirstRunFlag {\n NSUserDefaults* preferences = [NSUserDefaults standardUserDefaults];\n [preferences setBool:YES forKey:IsFirstRunKey];\n [preferences synchronize];\n}\n\n+ (BOOL)isFirstRun {\n NSUserDefaults* preferences = [NSUserDefaults standardUserDefaults];\n BOOL firstRunFlagSet = [preferences boolForKey:IsFirstRunKey];\n return !firstRunFlagSet;\n}\n\n+ (void)markInstallNeedsConfirmation {\n NSUserDefaults* preferences = [NSUserDefaults standardUserDefaults];\n [preferences setBool:YES forKey:NotConfirmedInstallKey];\n [preferences synchronize];\n}\n\n+ (BOOL)installNeedsConfirmation {\n NSUserDefaults* preferences = [NSUserDefaults standardUserDefaults];\n BOOL notConfirmedInstall = [preferences boolForKey:NotConfirmedInstallKey];\n return notConfirmedInstall;\n}\n\n+ (void)clearInstallNeedsConfirmation {\n NSUserDefaults *preferences = [NSUserDefaults standardUserDefaults];\n [preferences removeObjectForKey:NotConfirmedInstallKey];\n}\n\n+ (CodePushPackageMetadata*)readPackageManifest:(NSString*)manifestName {\n // check if the file exists\n NSString* libraryLocation = [NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES) objectAtIndex:0];\n NSArray* manifestLocationArray = @[libraryLocation, @\"NoCloud\", @\"codepush\", manifestName];\n NSString* manifestLocation = [NSString pathWithComponents:manifestLocationArray];\n if ([[NSFileManager defaultManager] fileExistsAtPath:manifestLocation]) {\n // read the package manifest\n NSString* content = [NSString stringWithContentsOfFile:manifestLocation encoding:NSUTF8StringEncoding error:NULL];\n if (content != nil) {\n // parse the content\n return [CodePushPackageMetadata parsePackageManifest:content];\n }\n }\n \n return nil;\n \n}\n\n+ (void)revertToPreviousVersion {\n /* clean the current package */\n CodePushPackageMetadata* failedMetadata = [self getCurrentPackageMetadata];\n if (nil != failedMetadata.packageHash) {\n [self saveFailedUpdate:failedMetadata.packageHash];\n }\n [self cleanPackageDirectory:failedMetadata];\n \n /* replace the current metadata file with the old one */\n NSString* libraryLocation = [NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES) objectAtIndex:0];\n NSArray* oldManifestArray = @[libraryLocation, @\"NoCloud\", @\"codepush\", OldPackageManifestName];\n NSArray* currentManifestArray = @[libraryLocation, @\"NoCloud\", @\"codepush\", CurrentPackageManifestName];\n \n NSString* oldManifestLocation = [NSString pathWithComponents:oldManifestArray];\n NSString* currentManifestLocation = [NSString pathWithComponents:currentManifestArray];\n \n if ([[NSFileManager defaultManager] fileExistsAtPath:currentManifestLocation]) {\n [[NSFileManager defaultManager] removeItemAtPath:currentManifestLocation error:nil];\n }\n \n /* move the old manifest to the curent location */\n if ([[NSFileManager defaultManager] fileExistsAtPath:oldManifestLocation]) {\n [[NSFileManager defaultManager] moveItemAtPath:oldManifestLocation toPath:currentManifestLocation error:nil];\n }\n \n [self cleanDownloads];\n}\n\n@end"
},
{
"path": "plugins/cordova-plugin-code-push/src/ios/CodePushPackageMetadata.h",
"content": "@interface CodePushPackageMetadata : NSObject\n\n@property NSString* deploymentKey;\n@property NSString* packageDescription;\n@property NSString* label;\n@property NSString* appVersion;\n@property bool isMandatory;\n@property NSString* packageHash;\n@property NSNumber* packageSize;\n@property NSString* localPath;\n@property NSString* nativeBuildTime;\n\n+ (CodePushPackageMetadata*)parsePackageManifest:(NSString*)content;\n\n@end"
},
{
"path": "plugins/cordova-plugin-code-push/src/ios/CodePushPackageMetadata.m",
"content": "#import \"CodePushPackageMetadata.h\"\n\n@implementation CodePushPackageMetadata\n\n+ (CodePushPackageMetadata*)parsePackageManifest:(NSString*)content {\n if (content) {\n NSData* manifestData = [content dataUsingEncoding:NSUTF8StringEncoding];\n NSMutableDictionary *manifest = [NSJSONSerialization JSONObjectWithData:manifestData options:NSJSONReadingMutableContainers | NSJSONReadingMutableLeaves error:NULL];\n \n if (manifestData) {\n CodePushPackageMetadata* packageMetadata = [[CodePushPackageMetadata alloc] init];\n packageMetadata.deploymentKey = manifest[@\"deploymentKey\"];\n packageMetadata.packageDescription = manifest[@\"description\"];\n packageMetadata.label = manifest[@\"label\"];\n packageMetadata.appVersion = manifest[@\"appVersion\"];\n packageMetadata.isMandatory = manifest[@\"isMandatory\"];\n packageMetadata.packageHash = manifest[@\"packageHash\"];\n packageMetadata.packageSize = manifest[@\"packageSize\"];\n packageMetadata.nativeBuildTime = manifest[@\"nativeBuildTime\"];\n packageMetadata.localPath = manifest[@\"localPath\"];\n return packageMetadata;\n }\n }\n \n return nil;\n}\n\n@end"
},
{
"path": "plugins/cordova-plugin-code-push/src/ios/CodePushReportingManager.h",
"content": "enum {\n STORE_VERSION = 0,\n UPDATE_CONFIRMED = 1,\n UPDATE_ROLLED_BACK = 2\n};\ntypedef NSInteger ReportingStatus;\n\n@interface CodePushReportingManager : NSObject\n+ (void)reportStatus:(ReportingStatus)status withLabel:(NSString*)label version:(NSString*)version deploymentKey:(NSString*)deploymentKey webView:(UIView*)webView;\n@end\n\n"
},
{
"path": "plugins/cordova-plugin-code-push/src/ios/CodePushReportingManager.m",
"content": "#import \"CodePushReportingManager.h\"\n\n@implementation CodePushReportingManager\n\nconst NSString* LastVersionPreference = @\"CODE_PUSH_LAST_VERSION\";\nconst NSString* LastVersionDeploymentKeyKey = @\"LAST_VERSION_DEPLOYMENT_KEY_KEY\";\nconst NSString* LastVersionLabelOrAppVersionKey = @\"LAST_VERSION_LABEL_OR_APP_VERSION_KEY\";\n\n+ (void)reportStatus:(ReportingStatus)status withLabel:(NSString*)label version:(NSString*)version deploymentKey:(NSString*)deploymentKey webView:(UIView*)webView {\n @synchronized(self) {\n if (!deploymentKey) {\n return;\n }\n\n NSString* labelParameter = [CodePushReportingManager convertStringParameter:label];\n NSString* appVersionParameter = [CodePushReportingManager convertStringParameter:version];\n NSString* deploymentKeyParameter = [CodePushReportingManager convertStringParameter:deploymentKey];\n NSString* lastVersionLabelOrAppVersionParameter = nil;\n NSString* lastVersionDeploymentKeyParameter = nil;\n\n NSUserDefaults* preferences = [NSUserDefaults standardUserDefaults];\n NSDictionary* lastVersion = [preferences objectForKey:LastVersionPreference];\n if (lastVersion) {\n lastVersionLabelOrAppVersionParameter = [CodePushReportingManager convertStringParameter:[lastVersion objectForKey:LastVersionLabelOrAppVersionKey]];\n lastVersionDeploymentKeyParameter = [CodePushReportingManager convertStringParameter:[lastVersion objectForKey:LastVersionDeploymentKeyKey]];\n }\n\n /* JS function to call: window.codePush.reportStatus(status: number, label: String, appVersion: String, deploymentKey: String) */\n NSString* script = [NSString stringWithFormat:@\"document.addEventListener(\\\"deviceready\\\", function () { window.codePush.reportStatus(%i, %@, %@, %@, %@, %@); });\", (int)status, labelParameter, appVersionParameter, deploymentKeyParameter, lastVersionLabelOrAppVersionParameter, lastVersionDeploymentKeyParameter];\n if ([webView respondsToSelector:@selector(evaluateJavaScript:completionHandler:)]) {\n [webView performSelector:@selector(evaluateJavaScript:completionHandler:) withObject:script withObject: NULL];\n } else if ([webView isKindOfClass:[UIWebView class]]) {\n [(UIWebView*)webView stringByEvaluatingJavaScriptFromString:script];\n }\n\n if (status == STORE_VERSION || status == UPDATE_CONFIRMED) {\n NSDictionary* newLastVersion = @{LastVersionLabelOrAppVersionKey:(label ? label : version), LastVersionDeploymentKeyKey:deploymentKey};\n [preferences setObject:newLastVersion forKey:LastVersionPreference];\n [preferences synchronize];\n }\n }\n}\n\n+ (NSString*)convertStringParameter:(NSString*)input {\n if (!input) {\n return @\"undefined\";\n } else {\n return [NSString stringWithFormat:@\"'%@'\", input];\n }\n}\n\n@end\n\n\n"
},
{
"path": "plugins/cordova-plugin-code-push/src/ios/InstallMode.h",
"content": "enum {\n IMMEDIATE = 0,\n ON_NEXT_RESTART = 1,\n ON_NEXT_RESUME = 2\n};\ntypedef NSInteger InstallMode;\n\n"
},
{
"path": "plugins/cordova-plugin-code-push/src/ios/InstallOptions.h",
"content": "#include \"InstallMode.h\"\n\n@interface InstallOptions : NSObject\n\n@property InstallMode installMode;\n@property int minimumBackgroundDuration;\n\n-(void)encodeWithCoder:(NSCoder*)encoder;\n-(id)initWithCoder:(NSCoder*)decoder;\n\n@end"
},
{
"path": "plugins/cordova-plugin-code-push/src/ios/InstallOptions.m",
"content": "#include \"InstallOptions.h\"\n\n@implementation InstallOptions\n\nNSString* const InstallModeKey = @\"installMode\";\nNSString* const MinimumBackgroundDurationKey = @\"minimumBackgroundDuration\";\n\n-(void)encodeWithCoder:(NSCoder*)encoder {\n [encoder encodeInteger:self.installMode forKey:InstallModeKey];\n [encoder encodeInteger:self.minimumBackgroundDuration forKey:MinimumBackgroundDurationKey];\n}\n\n-(id)initWithCoder:(NSCoder*)decoder { \n self.installMode = [decoder decodeIntegerForKey:InstallModeKey];\n self.minimumBackgroundDuration = [decoder decodeIntegerForKey:MinimumBackgroundDurationKey];\n return self;\n}\n\n@end"
},
{
"path": "plugins/cordova-plugin-code-push/src/ios/UpdateHashUtils.h",
"content": "@interface UpdateHashUtils : NSObject\n\n+ (NSString*)getBinaryHash:(NSError**)error;\n\n@end"
},
{
"path": "plugins/cordova-plugin-code-push/src/ios/UpdateHashUtils.m",
"content": "#import \n#import \"UpdateHashUtils.h\"\n\n@implementation UpdateHashUtils : NSObject\n\n+ (NSString*)binaryAssetsPath\n{\n return [[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent:@\"www\"];\n}\n\n+ (void)addFolderEntriesToManifest:(NSString*)folderPath\n pathPrefix:(NSString*)pathPrefix\n manifestEntries:(NSMutableArray*)manifestEntries\n error:(NSError**)error\n{\n NSArray* folderFiles = [[NSFileManager defaultManager]\n contentsOfDirectoryAtPath:folderPath\n error:error];\n if (*error) {\n return;\n }\n \n for (NSString* fileName in folderFiles) {\n NSString* fullFilePath = [folderPath stringByAppendingPathComponent:fileName];\n NSString* relativePath = [pathPrefix stringByAppendingPathComponent:fileName];\n BOOL isDir = NO;\n if ([[NSFileManager defaultManager] fileExistsAtPath:fullFilePath\n isDirectory:&isDir] && isDir) {\n [self addFolderEntriesToManifest:fullFilePath\n pathPrefix:relativePath\n manifestEntries:manifestEntries\n error:error];\n if (*error) {\n return;\n }\n } else {\n NSData* fileContents = [NSData dataWithContentsOfFile:fullFilePath];\n NSString* fileContentsHash = [self computeHashForData:fileContents];\n [manifestEntries addObject:[[relativePath stringByAppendingString:@\":\"] stringByAppendingString:fileContentsHash]];\n }\n }\n}\n\n+ (NSString*)computeFinalHashFromManifestEntries:(NSMutableArray*)manifest\n error:(NSError**)error\n{\n NSArray* sortedManifest = [manifest sortedArrayUsingSelector:@selector(compare:)];\n NSData* manifestData = [NSJSONSerialization dataWithJSONObject:sortedManifest\n options:kNilOptions\n error:error];\n if (*error) {\n return nil;\n }\n \n NSString* manifestString = [[NSString alloc] initWithData:manifestData\n encoding:NSUTF8StringEncoding];\n // The JSON serialization turns path separators into \"\\/\", e.g. \"www\\/images\\/image.png\"\n manifestString = [manifestString stringByReplacingOccurrencesOfString:@\"\\\\/\"\n withString:@\"/\"];\n return [self computeHashForData:[NSData dataWithBytes:manifestString.UTF8String length:manifestString.length]];\n}\n\n+ (NSString*)computeHashForData:(NSData*)inputData\n{\n uint8_t digest[CC_SHA256_DIGEST_LENGTH];\n CC_SHA256(inputData.bytes, inputData.length, digest);\n NSMutableString* inputHash = [NSMutableString stringWithCapacity:CC_SHA256_DIGEST_LENGTH * 2];\n for (int i = 0; i < CC_SHA256_DIGEST_LENGTH; i++) {\n [inputHash appendFormat:@\"%02x\", digest[i]];\n }\n \n return inputHash;\n}\n\n+ (NSString*)getBinaryHash:(NSError**)error\n{\n NSMutableArray* manifestEntries = [NSMutableArray array];\n [self addFolderEntriesToManifest:[self binaryAssetsPath]\n pathPrefix:@\"www\"\n manifestEntries:manifestEntries\n error:error];\n return [self computeFinalHashFromManifestEntries:manifestEntries error:error];\n}\n\n@end"
},
{
"path": "plugins/cordova-plugin-code-push/src/ios/Utilities.h",
"content": "@interface Utilities : NSObject\n\n+ (NSString*)getApplicationTimestamp;\n+ (NSDate*)getApplicationBuildTime;\n\n@end"
},
{
"path": "plugins/cordova-plugin-code-push/src/ios/Utilities.m",
"content": "#import \"Utilities.h\"\n\n@implementation Utilities\n\n+ (NSString*)getApplicationTimestamp{\n NSDate* applicationBuildTime = [self getApplicationBuildTime];\n if (applicationBuildTime){\n NSNumber* timestamp = [[NSNumber alloc] initWithDouble: floor([applicationBuildTime timeIntervalSince1970] * 1000)];\n return [timestamp stringValue];\n }\n \n return nil;\n}\n\n+ (NSDate*)getApplicationBuildTime{\n NSString *appPath = [[NSBundle mainBundle] bundlePath];\n NSDictionary *executableAttributes = [[NSFileManager defaultManager] attributesOfItemAtPath:appPath error:nil];\n return [executableAttributes objectForKey:@\"NSFileModificationDate\"];\n}\n\n@end"
},
{
"path": "plugins/cordova-plugin-compat/README.md",
"content": "\n\ncordova-plugin-compat\n------------------------\n\nThis repo is for remaining backwards compatible with previous versions of Cordova.\n"
},
{
"path": "plugins/cordova-plugin-compat/package.json",
"content": "{\n \"name\": \"cordova-plugin-compat\",\n \"description\": \"This repo is for remaining backwards compatible with previous versions of Cordova.\",\n \"version\": \"1.0.0\",\n \"homepage\": \"http://github.com/apache/cordova-plugin-compat#readme\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"git://github.com/apache/cordova-plugin-compat.git\"\n },\n \"bugs\": {\n \"url\": \"https://github.com/apache/cordova-plugin-compat/issues\"\n },\n \"cordova\": {\n \"id\": \"cordova-plugin-compat\",\n \"platforms\": [\n \"android\"\n ]\n },\n \"keywords\": [\n \"ecosystem:cordova\",\n \"ecosystem:phonegap\",\n \"cordova-android\"\n ],\n \"engines\": [\n {\n \"name\": \"cordova\",\n \"version\": \">=5.0.0\"\n }\n ],\n \"author\": \"Apache Software Foundation\",\n \"license\": \"Apache-2.0\"\n}\n"
},
{
"path": "plugins/cordova-plugin-compat/plugin.xml",
"content": "\n\n\n\n\n Compat\n Cordova Compatibility Plugin\n Apache 2.0\n cordova,compat\n https://git-wip-us.apache.org/repos/asf/cordova-plugin-compat.git\n\n \n \n \n \n\n\n"
},
{
"path": "plugins/cordova-plugin-compat/src/android/PermissionHelper.java",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n*/\npackage org.apache.cordova;\n\nimport java.lang.reflect.InvocationTargetException;\nimport java.lang.reflect.Method;\nimport java.util.Arrays;\n\nimport org.apache.cordova.CordovaInterface;\nimport org.apache.cordova.CordovaPlugin;\nimport org.apache.cordova.LOG;\n\nimport android.content.pm.PackageManager;\n\n/**\n * This class provides reflective methods for permission requesting and checking so that plugins\n * written for cordova-android 5.0.0+ can still compile with earlier cordova-android versions.\n */\npublic class PermissionHelper {\n private static final String LOG_TAG = \"CordovaPermissionHelper\";\n\n /**\n * Requests a \"dangerous\" permission for the application at runtime. This is a helper method\n * alternative to cordovaInterface.requestPermission() that does not require the project to be\n * built with cordova-android 5.0.0+\n *\n * @param plugin The plugin the permission is being requested for\n * @param requestCode A requestCode to be passed to the plugin's onRequestPermissionResult()\n * along with the result of the permission request\n * @param permission The permission to be requested\n */\n public static void requestPermission(CordovaPlugin plugin, int requestCode, String permission) {\n PermissionHelper.requestPermissions(plugin, requestCode, new String[] {permission});\n }\n\n /**\n * Requests \"dangerous\" permissions for the application at runtime. This is a helper method\n * alternative to cordovaInterface.requestPermissions() that does not require the project to be\n * built with cordova-android 5.0.0+\n *\n * @param plugin The plugin the permissions are being requested for\n * @param requestCode A requestCode to be passed to the plugin's onRequestPermissionResult()\n * along with the result of the permissions request\n * @param permissions The permissions to be requested\n */\n public static void requestPermissions(CordovaPlugin plugin, int requestCode, String[] permissions) {\n try {\n Method requestPermission = CordovaInterface.class.getDeclaredMethod(\n \"requestPermissions\", CordovaPlugin.class, int.class, String[].class);\n\n // If there is no exception, then this is cordova-android 5.0.0+\n requestPermission.invoke(plugin.cordova, plugin, requestCode, permissions);\n } catch (NoSuchMethodException noSuchMethodException) {\n // cordova-android version is less than 5.0.0, so permission is implicitly granted\n LOG.d(LOG_TAG, \"No need to request permissions \" + Arrays.toString(permissions));\n\n // Notify the plugin that all were granted by using more reflection\n deliverPermissionResult(plugin, requestCode, permissions);\n } catch (IllegalAccessException illegalAccessException) {\n // Should never be caught; this is a public method\n LOG.e(LOG_TAG, \"IllegalAccessException when requesting permissions \" + Arrays.toString(permissions), illegalAccessException);\n } catch(InvocationTargetException invocationTargetException) {\n // This method does not throw any exceptions, so this should never be caught\n LOG.e(LOG_TAG, \"invocationTargetException when requesting permissions \" + Arrays.toString(permissions), invocationTargetException);\n }\n }\n\n /**\n * Checks at runtime to see if the application has been granted a permission. This is a helper\n * method alternative to cordovaInterface.hasPermission() that does not require the project to\n * be built with cordova-android 5.0.0+\n *\n * @param plugin The plugin the permission is being checked against\n * @param permission The permission to be checked\n *\n * @return True if the permission has already been granted and false otherwise\n */\n public static boolean hasPermission(CordovaPlugin plugin, String permission) {\n try {\n Method hasPermission = CordovaInterface.class.getDeclaredMethod(\"hasPermission\", String.class);\n\n // If there is no exception, then this is cordova-android 5.0.0+\n return (Boolean) hasPermission.invoke(plugin.cordova, permission);\n } catch (NoSuchMethodException noSuchMethodException) {\n // cordova-android version is less than 5.0.0, so permission is implicitly granted\n LOG.d(LOG_TAG, \"No need to check for permission \" + permission);\n return true;\n } catch (IllegalAccessException illegalAccessException) {\n // Should never be caught; this is a public method\n LOG.e(LOG_TAG, \"IllegalAccessException when checking permission \" + permission, illegalAccessException);\n } catch(InvocationTargetException invocationTargetException) {\n // This method does not throw any exceptions, so this should never be caught\n LOG.e(LOG_TAG, \"invocationTargetException when checking permission \" + permission, invocationTargetException);\n }\n return false;\n }\n\n private static void deliverPermissionResult(CordovaPlugin plugin, int requestCode, String[] permissions) {\n // Generate the request results\n int[] requestResults = new int[permissions.length];\n Arrays.fill(requestResults, PackageManager.PERMISSION_GRANTED);\n\n try {\n Method onRequestPermissionResult = CordovaPlugin.class.getDeclaredMethod(\n \"onRequestPermissionResult\", int.class, String[].class, int[].class);\n\n onRequestPermissionResult.invoke(plugin, requestCode, permissions, requestResults);\n } catch (NoSuchMethodException noSuchMethodException) {\n // Should never be caught since the plugin must be written for cordova-android 5.0.0+ if it\n // made it to this point\n LOG.e(LOG_TAG, \"NoSuchMethodException when delivering permissions results\", noSuchMethodException);\n } catch (IllegalAccessException illegalAccessException) {\n // Should never be caught; this is a public method\n LOG.e(LOG_TAG, \"IllegalAccessException when delivering permissions results\", illegalAccessException);\n } catch(InvocationTargetException invocationTargetException) {\n // This method may throw a JSONException. We are just duplicating cordova-android's\n // exception handling behavior here; all it does is log the exception in CordovaActivity,\n // print the stacktrace, and ignore it\n LOG.e(LOG_TAG, \"InvocationTargetException when delivering permissions results\", invocationTargetException);\n }\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-device/CONTRIBUTING.md",
"content": "\n\n# Contributing to Apache Cordova\n\nAnyone can contribute to Cordova. And we need your contributions.\n\nThere are multiple ways to contribute: report bugs, improve the docs, and\ncontribute code.\n\nFor instructions on this, start with the \n[contribution overview](http://cordova.apache.org/contribute/).\n\nThe details are explained there, but the important items are:\n - Sign and submit an Apache ICLA (Contributor License Agreement).\n - Have a Jira issue open that corresponds to your contribution.\n - Run the tests so your patch doesn't break existing functionality.\n\nWe look forward to your contributions!\n"
},
{
"path": "plugins/cordova-plugin-device/LICENSE",
"content": "\n Apache License\n Version 2.0, January 2004\n http://www.apache.org/licenses/\n\n TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n\n 1. Definitions.\n\n \"License\" shall mean the terms and conditions for use, reproduction,\n and distribution as defined by Sections 1 through 9 of this document.\n\n \"Licensor\" shall mean the copyright owner or entity authorized by\n the copyright owner that is granting the License.\n\n \"Legal Entity\" shall mean the union of the acting entity and all\n other entities that control, are controlled by, or are under common\n control with that entity. For the purposes of this definition,\n \"control\" means (i) the power, direct or indirect, to cause the\n direction or management of such entity, whether by contract or\n otherwise, or (ii) ownership of fifty percent (50%) or more of the\n outstanding shares, or (iii) beneficial ownership of such entity.\n\n \"You\" (or \"Your\") shall mean an individual or Legal Entity\n exercising permissions granted by this License.\n\n \"Source\" form shall mean the preferred form for making modifications,\n including but not limited to software source code, documentation\n source, and configuration files.\n\n \"Object\" form shall mean any form resulting from mechanical\n transformation or translation of a Source form, including but\n not limited to compiled object code, generated documentation,\n and conversions to other media types.\n\n \"Work\" shall mean the work of authorship, whether in Source or\n Object form, made available under the License, as indicated by a\n copyright notice that is included in or attached to the work\n (an example is provided in the Appendix below).\n\n \"Derivative Works\" shall mean any work, whether in Source or Object\n form, that is based on (or derived from) the Work and for which the\n editorial revisions, annotations, elaborations, or other modifications\n represent, as a whole, an original work of authorship. For the purposes\n of this License, Derivative Works shall not include works that remain\n separable from, or merely link (or bind by name) to the interfaces of,\n the Work and Derivative Works thereof.\n\n \"Contribution\" shall mean any work of authorship, including\n the original version of the Work and any modifications or additions\n to that Work or Derivative Works thereof, that is intentionally\n submitted to Licensor for inclusion in the Work by the copyright owner\n or by an individual or Legal Entity authorized to submit on behalf of\n the copyright owner. For the purposes of this definition, \"submitted\"\n means any form of electronic, verbal, or written communication sent\n to the Licensor or its representatives, including but not limited to\n communication on electronic mailing lists, source code control systems,\n and issue tracking systems that are managed by, or on behalf of, the\n Licensor for the purpose of discussing and improving the Work, but\n excluding communication that is conspicuously marked or otherwise\n designated in writing by the copyright owner as \"Not a Contribution.\"\n\n \"Contributor\" shall mean Licensor and any individual or Legal Entity\n on behalf of whom a Contribution has been received by Licensor and\n subsequently incorporated within the Work.\n\n 2. Grant of Copyright License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n copyright license to reproduce, prepare Derivative Works of,\n publicly display, publicly perform, sublicense, and distribute the\n Work and such Derivative Works in Source or Object form.\n\n 3. Grant of Patent License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n (except as stated in this section) patent license to make, have made,\n use, offer to sell, sell, import, and otherwise transfer the Work,\n where such license applies only to those patent claims licensable\n by such Contributor that are necessarily infringed by their\n Contribution(s) alone or by combination of their Contribution(s)\n with the Work to which such Contribution(s) was submitted. If You\n institute patent litigation against any entity (including a\n cross-claim or counterclaim in a lawsuit) alleging that the Work\n or a Contribution incorporated within the Work constitutes direct\n or contributory patent infringement, then any patent licenses\n granted to You under this License for that Work shall terminate\n as of the date such litigation is filed.\n\n 4. Redistribution. You may reproduce and distribute copies of the\n Work or Derivative Works thereof in any medium, with or without\n modifications, and in Source or Object form, provided that You\n meet the following conditions:\n\n (a) You must give any other recipients of the Work or\n Derivative Works a copy of this License; and\n\n (b) You must cause any modified files to carry prominent notices\n stating that You changed the files; and\n\n (c) You must retain, in the Source form of any Derivative Works\n that You distribute, all copyright, patent, trademark, and\n attribution notices from the Source form of the Work,\n excluding those notices that do not pertain to any part of\n the Derivative Works; and\n\n (d) If the Work includes a \"NOTICE\" text file as part of its\n distribution, then any Derivative Works that You distribute must\n include a readable copy of the attribution notices contained\n within such NOTICE file, excluding those notices that do not\n pertain to any part of the Derivative Works, in at least one\n of the following places: within a NOTICE text file distributed\n as part of the Derivative Works; within the Source form or\n documentation, if provided along with the Derivative Works; or,\n within a display generated by the Derivative Works, if and\n wherever such third-party notices normally appear. The contents\n of the NOTICE file are for informational purposes only and\n do not modify the License. You may add Your own attribution\n notices within Derivative Works that You distribute, alongside\n or as an addendum to the NOTICE text from the Work, provided\n that such additional attribution notices cannot be construed\n as modifying the License.\n\n You may add Your own copyright statement to Your modifications and\n may provide additional or different license terms and conditions\n for use, reproduction, or distribution of Your modifications, or\n for any such Derivative Works as a whole, provided Your use,\n reproduction, and distribution of the Work otherwise complies with\n the conditions stated in this License.\n\n 5. Submission of Contributions. Unless You explicitly state otherwise,\n any Contribution intentionally submitted for inclusion in the Work\n by You to the Licensor shall be under the terms and conditions of\n this License, without any additional terms or conditions.\n Notwithstanding the above, nothing herein shall supersede or modify\n the terms of any separate license agreement you may have executed\n with Licensor regarding such Contributions.\n\n 6. Trademarks. This License does not grant permission to use the trade\n names, trademarks, service marks, or product names of the Licensor,\n except as required for reasonable and customary use in describing the\n origin of the Work and reproducing the content of the NOTICE file.\n\n 7. Disclaimer of Warranty. Unless required by applicable law or\n agreed to in writing, Licensor provides the Work (and each\n Contributor provides its Contributions) on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n implied, including, without limitation, any warranties or conditions\n of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A\n PARTICULAR PURPOSE. You are solely responsible for determining the\n appropriateness of using or redistributing the Work and assume any\n risks associated with Your exercise of permissions under this License.\n\n 8. Limitation of Liability. In no event and under no legal theory,\n whether in tort (including negligence), contract, or otherwise,\n unless required by applicable law (such as deliberate and grossly\n negligent acts) or agreed to in writing, shall any Contributor be\n liable to You for damages, including any direct, indirect, special,\n incidental, or consequential damages of any character arising as a\n result of this License or out of the use or inability to use the\n Work (including but not limited to damages for loss of goodwill,\n work stoppage, computer failure or malfunction, or any and all\n other commercial damages or losses), even if such Contributor\n has been advised of the possibility of such damages.\n\n 9. Accepting Warranty or Additional Liability. While redistributing\n the Work or Derivative Works thereof, You may choose to offer,\n and charge a fee for, acceptance of support, warranty, indemnity,\n or other liability obligations and/or rights consistent with this\n License. However, in accepting such obligations, You may act only\n on Your own behalf and on Your sole responsibility, not on behalf\n of any other Contributor, and only if You agree to indemnify,\n defend, and hold each Contributor harmless for any liability\n incurred by, or claims asserted against, such Contributor by reason\n of your accepting any such warranty or additional liability.\n\n END OF TERMS AND CONDITIONS\n\n APPENDIX: How to apply the Apache License to your work.\n\n To apply the Apache License to your work, attach the following\n boilerplate notice, with the fields enclosed by brackets \"[]\"\n replaced with your own identifying information. (Don't include\n the brackets!) The text should be enclosed in the appropriate\n comment syntax for the file format. We also recommend that a\n file or class name and description of purpose be included on the\n same \"printed page\" as the copyright notice for easier\n identification within third-party archives.\n\n Copyright [yyyy] [name of copyright owner]\n\n Licensed under the Apache License, Version 2.0 (the \"License\");\n you may not use this file except in compliance with the License.\n You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing, software\n distributed under the License is distributed on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n See the License for the specific language governing permissions and\n limitations under the License."
},
{
"path": "plugins/cordova-plugin-device/NOTICE",
"content": "Apache Cordova\nCopyright 2012 The Apache Software Foundation\n\nThis product includes software developed at\nThe Apache Software Foundation (http://www.apache.org/).\n"
},
{
"path": "plugins/cordova-plugin-device/README.md",
"content": "\n\n[](https://travis-ci.org/apache/cordova-plugin-device)\n\n# cordova-plugin-device\n\nThis plugin defines a global `device` object, which describes the device's hardware and software.\nAlthough the object is in the global scope, it is not available until after the `deviceready` event.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(device.cordova);\n }\n\nReport issues with this plugin on the [Apache Cordova issue tracker](https://issues.apache.org/jira/issues/?jql=project%20%3D%20CB%20AND%20status%20in%20%28Open%2C%20%22In%20Progress%22%2C%20Reopened%29%20AND%20resolution%20%3D%20Unresolved%20AND%20component%20%3D%20%22Plugin%20Device%22%20ORDER%20BY%20priority%20DESC%2C%20summary%20ASC%2C%20updatedDate%20DESC)\n\n\n## Installation\n\n cordova plugin add cordova-plugin-device\n\n## Properties\n\n- device.cordova\n- device.model\n- device.platform\n- device.uuid\n- device.version\n- device.manufacturer\n- device.isVirtual\n- device.serial\n\n## device.cordova\n\nGet the version of Cordova running on the device.\n\n### Supported Platforms\n\n- Amazon Fire OS\n- Android\n- BlackBerry 10\n- Browser\n- Firefox OS\n- iOS\n- Tizen\n- Windows Phone 7 and 8\n- Windows\n- OSX\n\n## device.model\n\nThe `device.model` returns the name of the device's model or\nproduct. The value is set by the device manufacturer and may be\ndifferent across versions of the same product.\n\n### Supported Platforms\n\n- Android\n- BlackBerry 10\n- Browser\n- iOS\n- Tizen\n- Windows Phone 7 and 8\n- Windows\n- OSX\n\n### Quick Example\n\n // Android: Nexus One returns \"Passion\" (Nexus One code name)\n // Motorola Droid returns \"voles\"\n // BlackBerry: Torch 9800 returns \"9800\"\n // Browser: Google Chrome returns \"Chrome\"\n // Safari returns \"Safari\"\n // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. See http://theiphonewiki.com/wiki/index.php?title=Models\n // OSX: returns \"x86_64\"\n // \n var model = device.model;\n\n### Android Quirks\n\n- Gets the [product name](http://developer.android.com/reference/android/os/Build.html#PRODUCT) instead of the [model name](http://developer.android.com/reference/android/os/Build.html#MODEL), which is often the production code name. For example, the Nexus One returns `Passion`, and Motorola Droid returns `voles`.\n\n### Tizen Quirks\n\n- Returns the device model assigned by the vendor, for example, `TIZEN`\n\n### Windows Phone 7 and 8 Quirks\n\n- Returns the device model specified by the manufacturer. For example, the Samsung Focus returns `SGH-i917`.\n\n## device.platform\n\nGet the device's operating system name.\n\n var string = device.platform;\n\n### Supported Platforms\n\n- Android\n- BlackBerry 10\n- Browser\n- Firefox OS\n- iOS\n- Tizen\n- Windows Phone 7 and 8\n- Windows\n- OSX\n\n### Quick Example\n\n // Depending on the device, a few examples are:\n // - \"Android\"\n // - \"BlackBerry 10\"\n // - \"browser\"\n // - \"iOS\"\n // - \"WinCE\"\n // - \"Tizen\"\n // - \"Mac OS X\"\n var devicePlatform = device.platform;\n\n### Windows Phone 7 Quirks\n\nWindows Phone 7 devices report the platform as `WinCE`.\n\n### Windows Phone 8 Quirks\n\nWindows Phone 8 devices report the platform as `Win32NT`.\n\n## device.uuid\n\nGet the device's Universally Unique Identifier ([UUID](http://en.wikipedia.org/wiki/Universally_Unique_Identifier)).\n\n var string = device.uuid;\n\n### Description\n\nThe details of how a UUID is generated are determined by the device manufacturer and are specific to the device's platform or model.\n\n### Supported Platforms\n\n- Android\n- BlackBerry 10\n- iOS\n- Tizen\n- Windows Phone 7 and 8\n- Windows\n- OSX\n\n### Quick Example\n\n // Android: Returns a random 64-bit integer (as a string, again!)\n // The integer is generated on the device's first boot\n //\n // BlackBerry: Returns the PIN number of the device\n // This is a nine-digit unique integer (as a string, though!)\n //\n // iPhone: (Paraphrased from the UIDevice Class documentation)\n // Returns the [UIDevice identifierForVendor] UUID which is unique and the same for all apps installed by the same vendor. However the UUID can be different if the user deletes all apps from the vendor and then reinstalls it.\n // Windows Phone 7 : Returns a hash of device+current user,\n // if the user is not defined, a guid is generated and will persist until the app is uninstalled\n // Tizen: returns the device IMEI (International Mobile Equipment Identity or IMEI is a number\n // unique to every GSM and UMTS mobile phone.\n var deviceID = device.uuid;\n\n### iOS Quirk\n\nThe `uuid` on iOS uses the identifierForVendor property. It is unique to the device across the same vendor, but will be different for different vendors and will change if all apps from the vendor are deleted and then reinstalled.\nRefer [here](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIDevice_Class/#//apple_ref/occ/instp/UIDevice/identifierForVendor) for details.\nThe UUID will be the same if app is restored from a backup or iCloud as it is saved in preferences. Users using older versions of this plugin will still receive the same previous UUID generated by another means as it will be retrieved from preferences.\n\n### OSX Quirk\n\nThe `uuid` on OSX is generated automatically if it does not exist yet and is stored in the `standardUserDefaults` in the `CDVUUID` property. \n\n### Windows Phone 7 and 8 Quirks\n\nThe `uuid` for Windows Phone 7 requires the permission\n`ID_CAP_IDENTITY_DEVICE`. Microsoft will likely deprecate this\nproperty soon. If the capability is not available, the application\ngenerates a persistent guid that is maintained for the duration of the\napplication's installation on the device.\n\n## device.version\n\nGet the operating system version.\n\n var string = device.version;\n\n### Supported Platforms\n\n- Android 2.1+\n- BlackBerry 10\n- Browser\n- iOS\n- Tizen\n- Windows Phone 7 and 8\n- Windows\n- OSX\n\n### Quick Example\n\n // Android: Froyo OS would return \"2.2\"\n // Eclair OS would return \"2.1\", \"2.0.1\", or \"2.0\"\n // Version can also return update level \"2.1-update1\"\n //\n // BlackBerry: Torch 9800 using OS 6.0 would return \"6.0.0.600\"\n //\n // Browser: Returns version number for the browser\n //\n // iPhone: iOS 3.2 returns \"3.2\"\n //\n // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720\n // Windows 8: return the current OS version, ex on Windows 8.1 returns 6.3.9600.16384\n // Tizen: returns \"TIZEN_20120425_2\"\n // OSX: El Capitan would return \"10.11.2\"\n //\n var deviceVersion = device.version;\n\n## device.manufacturer\n\nGet the device's manufacturer.\n\n var string = device.manufacturer;\n\n### Supported Platforms\n\n- Android \n- BlackBerry 10\n- iOS\n- Windows Phone 7 and 8\n- Windows\n\n### Quick Example\n\n // Android: Motorola XT1032 would return \"motorola\"\n // BlackBerry: returns \"BlackBerry\"\n // iPhone: returns \"Apple\"\n //\n var deviceManufacturer = device.manufacturer;\n\n## device.isVirtual\n\nwhether the device is running on a simulator.\n\n var isSim = device.isVirtual;\n\n### Supported Platforms\n\n- Android 2.1+\n- iOS\n- Windows Phone 8\n- Windows\n- OSX \n\n### OSX Quirk\n\nThe `isVirtual` property on OS X always returns false.\n\n## device.serial\n\nGet the device hardware serial number ([SERIAL](http://developer.android.com/reference/android/os/Build.html#SERIAL)).\n\n var string = device.serial;\n\n### Supported Platforms\n\n- Android\n- OSX\n\n"
},
{
"path": "plugins/cordova-plugin-device/RELEASENOTES.md",
"content": "\n# Release Notes\n\n### 1.1.2 (Apr 15, 2016)\n* Use passed device, follow create policy forf `CFUUIDCreate`\n* CB-10631 Fix for `device.uuid` in **iOS 5.1.1**\n* Updating the comment to exclude URL\n* CB-10636 Add `JSHint` for plugins\n* Refactored `deviceInfo` on **iOS** for better readability.\n\n### 1.1.1 (Jan 15, 2016)\n* CB-10238 **OSX** Move `device-plugin` out from `cordovalib` to the plugin repository\n* CB-9923 Update `device.platform` documentation for **Browser** platform\n\n### 1.1.0 (Nov 18, 2015)\n* [CB-10035](https://issues.apache.org/jira/browse/CB-10035) Updated `RELEASENOTES` to be newest to oldest\n* Add `isVirtual` for **Windows Phone 8.x**\n* Added basic **Android** support for hardware serial number\n* [CB-9865](https://issues.apache.org/jira/browse/CB-9865) Better simulator detection for **iOS**\n* Fixing contribute link.\n* Added **WP8** implementation\n* update to use `TARGET_OS_SIMULATOR` as `TARGET_IPHONE_SIMULATOR` is deprecated.\n* update code to use 'isVirtual'\n* create test to verify existence and type of new property 'isVirtual'\n* add `isSimulator` for **iOS** & **Android** device\n* Updated documentation to mention backwards compatibility\n* Updated **README** to reflect new behaviour and quirks on **iOS**\n* Check user defaults first to maintain backwards compatibility\n* Changed `UUID` to use `[UIDevice identifierForVendor]`\n\n### 1.0.1 (Jun 17, 2015)\n* [CB-9128](https://issues.apache.org/jira/browse/CB-9128) cordova-plugin-device documentation translation: cordova-plugin-device\n* Attempts to corrent npm markdown issue\n\n### 1.0.0 (Apr 15, 2015)\n* [CB-8746](https://issues.apache.org/jira/browse/CB-8746) gave plugin major version bump\n* [CB-8683](https://issues.apache.org/jira/browse/CB-8683) changed plugin-id to pacakge-name\n* [CB-8653](https://issues.apache.org/jira/browse/CB-8653) properly updated translated docs to use new id\n* [CB-8653](https://issues.apache.org/jira/browse/CB-8653) updated translated docs to use new id\n* Use TRAVIS_BUILD_DIR, install paramedic by npm\n* [CB-8653](https://issues.apache.org/jira/browse/CB-8653) Updated Readme\n* remove defunct windows8 version\n* add travis badge\n* Add cross-plugin ios paramedic test running for TravisCI\n* [CB-8538](https://issues.apache.org/jira/browse/CB-8538) Added package.json file\n\n### 0.3.0 (Feb 04, 2015)\n* Added device.manufacturer property for Android, iOS, Blackberry, WP8\n* Support for Windows Phone 8 ANID2 ANID is only supported up to Windows Phone 7.5\n* [CB-8351](https://issues.apache.org/jira/browse/CB-8351) Use a local copy of uniqueAppInstanceIdentifier rather than CordovaLib's version\n* browser: Fixed a bug that caused an \"cannot call method of undefined\" error if the browser's user agent wasn't recognized\n\n### 0.2.13 (Dec 02, 2014)\n* Changing `device.platform` to always report the platform as \"browser\".\n* [CB-5892](https://issues.apache.org/jira/browse/CB-5892) - Remove deprecated `window.Settings`\n* [CB-7700](https://issues.apache.org/jira/browse/CB-7700) cordova-plugin-device documentation translation: cordova-plugin-device\n* [CB-7571](https://issues.apache.org/jira/browse/CB-7571) Bump version of nested plugin to match parent plugin\n\n### 0.2.12 (Sep 17, 2014)\n* [CB-7471](https://issues.apache.org/jira/browse/CB-7471) cordova-plugin-device documentation translation\n* [CB-7552](https://issues.apache.org/jira/browse/CB-7552) device.name docs have not been removed\n* [fxos] Fix cordova version\n* added status box and documentation to manual tests\n* [fxos] Fix cordova version\n* added status box and documentation to manual tests\n* Added plugin support for the browser\n* [CB-7262](https://issues.apache.org/jira/browse/CB-7262) Adds support for universal windows apps.\n\n### 0.2.11 (Aug 06, 2014)\n* [FFOS] update DeviceProxy.js\n* [CB-6127](https://issues.apache.org/jira/browse/CB-6127) Updated translations for docs\n* Use Windows system calls to get better info\n\n### 0.2.10 (Jun 05, 2014)\n* [CB-6127](https://issues.apache.org/jira/browse/CB-6127) Spanish and French Translations added. Github close #12\n* Changing 1.5 to 2.0\n* added firefoxos version - conversion\n* added firefoxos version\n* [CB-6800](https://issues.apache.org/jira/browse/CB-6800) Add license\n* [CB-6491](https://issues.apache.org/jira/browse/CB-6491) add CONTRIBUTING.md\n\n### 0.2.9 (Apr 17, 2014)\n* [CB-5105](https://issues.apache.org/jira/browse/CB-5105): [Android, windows8, WP, BlackBerry10] Removed dead code for device.version\n* [CB-6422](https://issues.apache.org/jira/browse/CB-6422): [windows8] use cordova/exec/proxy\n* [CB-6460](https://issues.apache.org/jira/browse/CB-6460): Update license headers\n* Add NOTICE file\n\n### 0.2.8 (Feb 05, 2014)\n* Tizen support added\n\n### 0.2.7 (Jan 07, 2014)\n* [CB-5737](https://issues.apache.org/jira/browse/CB-5737) Fix exception on close caused by left over telephony code from [CB-5504](https://issues.apache.org/jira/browse/CB-5504)\n\n### 0.2.6 (Jan 02, 2014)\n* [CB-5658](https://issues.apache.org/jira/browse/CB-5658) Add doc/index.md for Device plugin\n* [CB-5504](https://issues.apache.org/jira/browse/CB-5504) Moving Telephony Logic out of Device\n\n### 0.2.5 (Dec 4, 2013)\n* [CB-5316](https://issues.apache.org/jira/browse/CB-5316) Spell Cordova as a brand unless it's a command or script\n* [ubuntu] use cordova/exec/proxy\n* add ubuntu platform\n* Modify Device.platform logic to use amazon-fireos as the platform for Amazon Devices\n* 1. Added amazon-fireos platform. 2. Change to use cordova-amazon-fireos as the platform if user agent contains 'cordova-amazon-fireos'\n\n### 0.2.4 (Oct 28, 2013)\n* [CB-5128](https://issues.apache.org/jira/browse/CB-5128): added repo + issue tag in plugin.xml for device plugin\n* [CB-5085](https://issues.apache.org/jira/browse/CB-5085) device.cordova returning wrong value\n* [CB-4915](https://issues.apache.org/jira/browse/CB-4915) Incremented plugin version on dev branch.\n\n### 0.2.3 (Sept 25, 2013)\n* [CB-4889](https://issues.apache.org/jira/browse/CB-4889) bumping&resetting version\n* [windows8] commandProxy has moved\n* [BlackBerry10] removed uneeded permission tags in plugin.xml\n* [CB-4889](https://issues.apache.org/jira/browse/CB-4889) renaming org.apache.cordova.core.device to org.apache.cordova.device\n* Rename CHANGELOG.md -> RELEASENOTES.md\n* updated to use commandProxy for ffos\n* add firefoxos support\n* [CB-4752](https://issues.apache.org/jira/browse/CB-4752) Incremented plugin version on dev branch. \n\n### 0.2.1 (Sept 5, 2013)\n* removed extraneous print statement\n* [CB-4432](https://issues.apache.org/jira/browse/CB-4432) copyright notice change\n"
},
{
"path": "plugins/cordova-plugin-device/doc/de/README.md",
"content": "\n\n# cordova-plugin-device\n\n[](https://travis-ci.org/apache/cordova-plugin-device)\n\nDieses Plugin definiert eine globale `device` -Objekt, das des Geräts Hard- und Software beschreibt. Das Objekt im globalen Gültigkeitsbereich ist es zwar nicht verfügbar bis nach dem `deviceready` Ereignis.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(device.cordova);\n }\n \n\n## Installation\n\n cordova plugin add cordova-plugin-device\n \n\n## Eigenschaften\n\n * device.cordova\n * device.model\n * device.platform\n * device.uuid\n * device.version\n\n## device.cordova\n\nRufen Sie die Version von Cordova, die auf dem Gerät ausgeführt.\n\n### Unterstützte Plattformen\n\n * Amazon Fire OS\n * Android\n * BlackBerry 10\n * Browser\n * Firefox OS\n * iOS\n * Tizen\n * Windows Phone 7 und 8\n * Windows 8\n\n## device.model\n\nDie `device.model` gibt den Namen der Modell- oder des Geräts zurück. Der Wert wird vom Gerätehersteller festgelegt und kann zwischen den Versionen des gleichen Produkts unterschiedlich sein.\n\n### Unterstützte Plattformen\n\n * Android\n * BlackBerry 10\n * Browser\n * iOS\n * Tizen\n * Windows Phone 7 und 8\n * Windows 8\n\n### Kurzes Beispiel\n\n // Android: Nexus One returns \"Passion\" (Nexus One code name)\n // Motorola Droid returns \"voles\"\n // BlackBerry: Torch 9800 returns \"9800\"\n // Browser: Google Chrome returns \"Chrome\"\n // Safari returns \"Safari\"\n // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. Finden Sie unter http://theiphonewiki.com/wiki/index.php?title=Models / / Var-Modell = device.model;\n \n\n### Android Eigenarten\n\n * Ruft den [Produktname](http://developer.android.com/reference/android/os/Build.html#PRODUCT) anstelle des [Modellnamens](http://developer.android.com/reference/android/os/Build.html#MODEL), das ist oft der Codename für die Produktion. Beispielsweise das Nexus One gibt `Passion` , und Motorola Droid gibt`voles`.\n\n### Tizen Macken\n\n * Gibt z. B. das Gerätemodell von dem Kreditor zugeordnet,`TIZEN`\n\n### Windows Phone 7 und 8 Eigenarten\n\n * Gibt das vom Hersteller angegebenen Gerätemodell zurück. Beispielsweise gibt der Samsung-Fokus`SGH-i917`.\n\n## device.platform\n\nName des Betriebssystems des Geräts zu erhalten.\n\n var string = device.platform;\n \n\n### Unterstützte Plattformen\n\n * Android\n * BlackBerry 10\n * Browser4\n * Firefox OS\n * iOS\n * Tizen\n * Windows Phone 7 und 8\n * Windows 8\n\n### Kurzes Beispiel\n\n // Depending on the device, a few examples are:\n // - \"Android\"\n // - \"BlackBerry 10\"\n // - Browser: returns \"MacIntel\" on Mac\n // returns \"Win32\" on Windows\n // - \"iOS\"\n // - \"WinCE\"\n // - \"Tizen\"\n var devicePlatform = device.platform;\n \n\n### Windows Phone 7 Macken\n\nWindows Phone 7 Geräte melden die Plattform als`WinCE`.\n\n### Windows Phone 8 Macken\n\nWindows Phone 8 Geräte melden die Plattform als`Win32NT`.\n\n## device.uuid\n\nDes Geräts Universally Unique Identifier ([UUID](http://en.wikipedia.org/wiki/Universally_Unique_Identifier) zu erhalten).\n\n var string = device.uuid;\n \n\n### Beschreibung\n\nDie Details wie eine UUID generiert wird werden vom Gerätehersteller und beziehen sich auf die Plattform oder das Modell des Geräts.\n\n### Unterstützte Plattformen\n\n * Android\n * BlackBerry 10\n * iOS\n * Tizen\n * Windows Phone 7 und 8\n * Windows 8\n\n### Kurzes Beispiel\n\n / / Android: wird eine zufällige 64-Bit-Ganzzahl (als Zeichenfolge, wieder!) / / die ganze Zahl wird beim ersten Start des Geräts erzeugt / / / / BlackBerry: gibt die PIN-Nummer des Gerätes / / Dies ist eine neunstellige eindeutige Ganzzahl (als String, obwohl!) / / / / iPhone: (paraphrasiert aus der Dokumentation zur UIDevice-Klasse) / / liefert eine Reihe von Hash-Werte, die aus mehreren Hardware erstellt identifiziert.\n / / Es ist gewährleistet, dass für jedes Gerät eindeutig sein und kann nicht gebunden werden / / an den Benutzer weitergeleitet.\n / / Windows Phone 7: gibt einen Hash des Gerät + aktueller Benutzer, / / wenn der Benutzer nicht definiert ist, eine Guid generiert und wird weiter bestehen, bis die app deinstalliert wird / / Tizen: gibt das Gerät IMEI (International Mobile Equipment Identity oder IMEI ist eine Zahl / / einzigartig für jedes GSM- und UMTS-Handy.\n var deviceID = device.uuid;\n \n\n### iOS Quirk\n\nDie `uuid` auf iOS ist nicht eindeutig zu einem Gerät, aber für jede Anwendung, für jede Installation variiert. Es ändert sich, wenn Sie löschen und neu die app installieren, und möglicherweise auch beim iOS zu aktualisieren, oder auch ein Upgrade möglich die app pro Version (scheinbaren in iOS 5.1). Die `uuid` ist kein zuverlässiger Wert.\n\n### Windows Phone 7 und 8 Eigenarten\n\nDie `uuid` für Windows Phone 7 die Berechtigung erfordert `ID_CAP_IDENTITY_DEVICE` . Microsoft wird diese Eigenschaft wahrscheinlich bald abzuschaffen. Wenn die Funktion nicht verfügbar ist, generiert die Anwendung eine persistente Guid, die für die Dauer der Installation der Anwendung auf dem Gerät gewährleistet ist.\n\n## device.version\n\nVersion des Betriebssystems zu erhalten.\n\n var string = device.version;\n \n\n### Unterstützte Plattformen\n\n * Android 2.1 +\n * BlackBerry 10\n * Browser\n * iOS\n * Tizen\n * Windows Phone 7 und 8\n * Windows 8\n\n### Kurzes Beispiel\n\n // Android: Froyo OS would return \"2.2\"\n // Eclair OS would return \"2.1\", \"2.0.1\", or \"2.0\"\n // Version can also return update level \"2.1-update1\"\n //\n // BlackBerry: Torch 9800 using OS 6.0 would return \"6.0.0.600\"\n //\n // Browser: Returns version number for the browser\n //\n // iPhone: iOS 3.2 returns \"3.2\"\n //\n // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720\n // Tizen: returns \"TIZEN_20120425_2\"\n var deviceVersion = device.version;"
},
{
"path": "plugins/cordova-plugin-device/doc/de/index.md",
"content": "\n\n# cordova-plugin-device\n\nDieses Plugin definiert eine globale `device` -Objekt, das des Geräts Hard- und Software beschreibt. Das Objekt im globalen Gültigkeitsbereich ist es zwar nicht verfügbar bis nach dem `deviceready` Ereignis.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(device.cordova);\n }\n \n\n## Installation\n\n cordova plugin add cordova-plugin-device\n \n\n## Eigenschaften\n\n* device.cordova\n* device.model\n* device.platform\n* device.uuid\n* device.version\n\n## device.cordova\n\nRufen Sie die Version von Cordova, die auf dem Gerät ausgeführt.\n\n### Unterstützte Plattformen\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* Browser\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 und 8\n* Windows 8\n\n## device.model\n\nDie `device.model` gibt den Namen der Modell- oder des Geräts zurück. Der Wert wird vom Gerätehersteller festgelegt und kann zwischen den Versionen des gleichen Produkts unterschiedlich sein.\n\n### Unterstützte Plattformen\n\n* Android\n* BlackBerry 10\n* Browser\n* iOS\n* Tizen\n* Windows Phone 7 und 8\n* Windows 8\n\n### Kurzes Beispiel\n\n // Android: Nexus One returns \"Passion\" (Nexus One code name)\n // Motorola Droid returns \"voles\"\n // BlackBerry: Torch 9800 returns \"9800\"\n // Browser: Google Chrome returns \"Chrome\"\n // Safari returns \"Safari\"\n // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. Finden Sie unter http://theiphonewiki.com/wiki/index.php?title=Models / / Var-Modell = device.model;\n \n\n### Android Eigenarten\n\n* Ruft den [Produktname][1] anstelle des [Modellnamens][2], das ist oft der Codename für die Produktion. Beispielsweise das Nexus One gibt `Passion` , und Motorola Droid gibt`voles`.\n\n [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT\n [2]: http://developer.android.com/reference/android/os/Build.html#MODEL\n\n### Tizen Macken\n\n* Gibt z. B. das Gerätemodell von dem Kreditor zugeordnet,`TIZEN`\n\n### Windows Phone 7 und 8 Eigenarten\n\n* Gibt das vom Hersteller angegebenen Gerätemodell zurück. Beispielsweise gibt der Samsung-Fokus`SGH-i917`.\n\n## device.platform\n\nName des Betriebssystems des Geräts zu erhalten.\n\n var string = device.platform;\n \n\n### Unterstützte Plattformen\n\n* Android\n* BlackBerry 10\n* Browser4\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 und 8\n* Windows 8\n\n### Kurzes Beispiel\n\n // Depending on the device, a few examples are:\n // - \"Android\"\n // - \"BlackBerry 10\"\n // - Browser: returns \"MacIntel\" on Mac\n // returns \"Win32\" on Windows\n // - \"iOS\"\n // - \"WinCE\"\n // - \"Tizen\"\n var devicePlatform = device.platform;\n \n\n### Windows Phone 7 Macken\n\nWindows Phone 7 Geräte melden die Plattform als`WinCE`.\n\n### Windows Phone 8 Macken\n\nWindows Phone 8 Geräte melden die Plattform als`Win32NT`.\n\n## device.uuid\n\nDes Geräts Universally Unique Identifier ([UUID][3] zu erhalten).\n\n [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier\n\n var string = device.uuid;\n \n\n### Beschreibung\n\nDie Details wie eine UUID generiert wird werden vom Gerätehersteller und beziehen sich auf die Plattform oder das Modell des Geräts.\n\n### Unterstützte Plattformen\n\n* Android\n* BlackBerry 10\n* iOS\n* Tizen\n* Windows Phone 7 und 8\n* Windows 8\n\n### Kurzes Beispiel\n\n / / Android: wird eine zufällige 64-Bit-Ganzzahl (als Zeichenfolge, wieder!) / / die ganze Zahl wird beim ersten Start des Geräts erzeugt / / / / BlackBerry: gibt die PIN-Nummer des Gerätes / / Dies ist eine neunstellige eindeutige Ganzzahl (als String, obwohl!) / / / / iPhone: (paraphrasiert aus der Dokumentation zur UIDevice-Klasse) / / liefert eine Reihe von Hash-Werte, die aus mehreren Hardware erstellt identifiziert.\n / / Es ist gewährleistet, dass für jedes Gerät eindeutig sein und kann nicht gebunden werden / / an den Benutzer weitergeleitet.\n / / Windows Phone 7: gibt einen Hash des Gerät + aktueller Benutzer, / / wenn der Benutzer nicht definiert ist, eine Guid generiert und wird weiter bestehen, bis die app deinstalliert wird / / Tizen: gibt das Gerät IMEI (International Mobile Equipment Identity oder IMEI ist eine Zahl / / einzigartig für jedes GSM- und UMTS-Handy.\n var deviceID = device.uuid;\n \n\n### iOS Quirk\n\nDie `uuid` auf iOS ist nicht eindeutig zu einem Gerät, aber für jede Anwendung, für jede Installation variiert. Es ändert sich, wenn Sie löschen und neu die app installieren, und möglicherweise auch beim iOS zu aktualisieren, oder auch ein Upgrade möglich die app pro Version (scheinbaren in iOS 5.1). Die `uuid` ist kein zuverlässiger Wert.\n\n### Windows Phone 7 und 8 Eigenarten\n\nDie `uuid` für Windows Phone 7 die Berechtigung erfordert `ID_CAP_IDENTITY_DEVICE` . Microsoft wird diese Eigenschaft wahrscheinlich bald abzuschaffen. Wenn die Funktion nicht verfügbar ist, generiert die Anwendung eine persistente Guid, die für die Dauer der Installation der Anwendung auf dem Gerät gewährleistet ist.\n\n## device.version\n\nVersion des Betriebssystems zu erhalten.\n\n var string = device.version;\n \n\n### Unterstützte Plattformen\n\n* Android 2.1 +\n* BlackBerry 10\n* Browser\n* iOS\n* Tizen\n* Windows Phone 7 und 8\n* Windows 8\n\n### Kurzes Beispiel\n\n // Android: Froyo OS would return \"2.2\"\n // Eclair OS would return \"2.1\", \"2.0.1\", or \"2.0\"\n // Version can also return update level \"2.1-update1\"\n //\n // BlackBerry: Torch 9800 using OS 6.0 would return \"6.0.0.600\"\n //\n // Browser: Returns version number for the browser\n //\n // iPhone: iOS 3.2 returns \"3.2\"\n //\n // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720\n // Tizen: returns \"TIZEN_20120425_2\"\n var deviceVersion = device.version;\n"
},
{
"path": "plugins/cordova-plugin-device/doc/es/README.md",
"content": "\n\n# cordova-plugin-device\n\n[](https://travis-ci.org/apache/cordova-plugin-device)\n\nEste plugin define un global `device` objeto que describe del dispositivo hardware y software. Aunque el objeto está en el ámbito global, no está disponible hasta después de la `deviceready` evento.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(device.cordova);\n }\n \n\n## Instalación\n\n cordova plugin add cordova-plugin-device\n \n\n## Propiedades\n\n * device.cordova\n * device.model\n * device.platform\n * device.uuid\n * device.version\n\n## device.cordova\n\nObtener la versión de Cordova que se ejecuta en el dispositivo.\n\n### Plataformas soportadas\n\n * Amazon fire OS\n * Android\n * BlackBerry 10\n * Explorador\n * Firefox OS\n * iOS\n * Tizen\n * Windows Phone 7 y 8\n * Windows 8\n\n## device.model\n\nEl `device.model` devuelve el nombre de modelo del dispositivo o producto. El valor es fijado por el fabricante del dispositivo y puede ser diferente a través de versiones del mismo producto.\n\n### Plataformas soportadas\n\n * Android\n * BlackBerry 10\n * Explorador\n * iOS\n * Tizen\n * Windows Phone 7 y 8\n * Windows 8\n\n### Ejemplo rápido\n\n // Android: Nexus One returns \"Passion\" (Nexus One code name)\n // Motorola Droid returns \"voles\"\n // BlackBerry: Torch 9800 returns \"9800\"\n // Browser: Google Chrome returns \"Chrome\"\n // Safari returns \"Safari\"\n // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. See http://theiphonewiki.com/wiki/index.php?title=Models\n //\n var model = device.model;\n \n\n### Rarezas Android\n\n * Obtiene el [nombre del producto](http://developer.android.com/reference/android/os/Build.html#PRODUCT) en lugar del [nombre de la modelo](http://developer.android.com/reference/android/os/Build.html#MODEL), que es a menudo el nombre de código de producción. Por ejemplo, el Nexus One devuelve `Passion` y Motorola Droid devuelve `voles`.\n\n### Rarezas Tizen\n\n * Devuelve que el modelo de dispositivo asignado por el proveedor, por ejemplo, `TIZEN`\n\n### Windows Phone 7 y 8 rarezas\n\n * Devuelve el modelo de dispositivo especificado por el fabricante. Por ejemplo, el Samsung Focus devuelve `SGH-i917`.\n\n## device.platform\n\nObtener el nombre del sistema operativo del dispositivo.\n\n var string = device.platform;\n \n\n### Plataformas soportadas\n\n * Android\n * BlackBerry 10\n * Browser4\n * Firefox OS\n * iOS\n * Tizen\n * Windows Phone 7 y 8\n * Windows 8\n\n### Ejemplo rápido\n\n // Depending on the device, a few examples are:\n // - \"Android\"\n // - \"BlackBerry 10\"\n // - Browser: returns \"MacIntel\" on Mac\n // returns \"Win32\" on Windows\n // - \"iOS\"\n // - \"WinCE\"\n // - \"Tizen\"\n var devicePlatform = device.platform;\n \n\n### Windows Phone 7 rarezas\n\nDispositivos Windows Phone 7 informe de la plataforma como `WinCE`.\n\n### Windows Phone 8 rarezas\n\nDispositivos Windows Phone 8 Informe la plataforma como `Win32NT`.\n\n## device.uuid\n\nObtener identificador universalmente única del dispositivo ([UUID](http://en.wikipedia.org/wiki/Universally_Unique_Identifier)).\n\n var string = device.uuid;\n \n\n### Descripción\n\nLos detalles de cómo se genera un UUID son determinados por el fabricante del dispositivo y son específicos a la plataforma del dispositivo o modelo.\n\n### Plataformas soportadas\n\n * Android\n * BlackBerry 10\n * iOS\n * Tizen\n * Windows Phone 7 y 8\n * Windows 8\n\n### Ejemplo rápido\n\n // Android: Returns a random 64-bit integer (as a string, again!)\n // The integer is generated on the device's first boot\n //\n // BlackBerry: Returns the PIN number of the device\n // This is a nine-digit unique integer (as a string, though!)\n //\n // iPhone: (Paraphrased from the UIDevice Class documentation)\n // Returns a string of hash values created from multiple hardware identifies.\n // It is guaranteed to be unique for every device and can't be tied\n // to the user account.\n // Windows Phone 7 : Returns a hash of device+current user,\n // if the user is not defined, a guid is generated and will persist until the app is uninstalled\n // Tizen: returns the device IMEI (International Mobile Equipment Identity or IMEI is a number\n // unique to every GSM and UMTS mobile phone.\n var deviceID = device.uuid;\n \n\n### Rarezas de iOS\n\nEl `uuid` en iOS no es exclusiva de un dispositivo, pero varía para cada aplicación, para cada instalación. Cambia si puedes borrar y volver a instalar la aplicación, y posiblemente también cuándo actualizar iOS, o incluso mejorar la aplicación por la versión (evidente en iOS 5.1). El `uuid` no es un valor confiable.\n\n### Windows Phone 7 y 8 rarezas\n\nEl `uuid` para Windows Phone 7 requiere el permiso `ID_CAP_IDENTITY_DEVICE`. Microsoft pronto probablemente desaprueban esta propiedad. Si la capacidad no está disponible, la aplicación genera un guid persistente que se mantiene durante la duración de la instalación de la aplicación en el dispositivo.\n\n## device.version\n\nObtener la versión del sistema operativo.\n\n var string = device.version;\n \n\n### Plataformas soportadas\n\n * Android 2.1 +\n * BlackBerry 10\n * Explorador\n * iOS\n * Tizen\n * Windows Phone 7 y 8\n * Windows 8\n\n### Ejemplo rápido\n\n // Android: Froyo OS would return \"2.2\"\n // Eclair OS would return \"2.1\", \"2.0.1\", or \"2.0\"\n // Version can also return update level \"2.1-update1\"\n //\n // BlackBerry: Torch 9800 using OS 6.0 would return \"6.0.0.600\"\n //\n // Browser: Returns version number for the browser\n //\n // iPhone: iOS 3.2 returns \"3.2\"\n //\n // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720\n // Tizen: returns \"TIZEN_20120425_2\"\n var deviceVersion = device.version;"
},
{
"path": "plugins/cordova-plugin-device/doc/es/index.md",
"content": "\n\n# cordova-plugin-device\n\nEste plugin define un global `device` objeto que describe del dispositivo hardware y software. Aunque el objeto está en el ámbito global, no está disponible hasta después de la `deviceready` evento.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(device.cordova);\n }\n \n\n## Instalación\n\n cordova plugin add cordova-plugin-device\n \n\n## Propiedades\n\n* device.cordova\n* device.model\n* device.platform\n* device.uuid\n* device.version\n\n## device.cordova\n\nObtener la versión de Cordova que se ejecuta en el dispositivo.\n\n### Plataformas soportadas\n\n* Amazon fire OS\n* Android\n* BlackBerry 10\n* Explorador\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 y 8\n* Windows 8\n\n## device.model\n\nEl `device.model` devuelve el nombre de modelo del dispositivo o producto. El valor es fijado por el fabricante del dispositivo y puede ser diferente a través de versiones del mismo producto.\n\n### Plataformas soportadas\n\n* Android\n* BlackBerry 10\n* Explorador\n* iOS\n* Tizen\n* Windows Phone 7 y 8\n* Windows 8\n\n### Ejemplo rápido\n\n // Android: Nexus One returns \"Passion\" (Nexus One code name)\n // Motorola Droid returns \"voles\"\n // BlackBerry: Torch 9800 returns \"9800\"\n // Browser: Google Chrome returns \"Chrome\"\n // Safari returns \"Safari\"\n // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. See http://theiphonewiki.com/wiki/index.php?title=Models\n //\n var model = device.model;\n \n\n### Rarezas Android\n\n* Obtiene el [nombre del producto][1] en lugar del [nombre de la modelo][2], que es a menudo el nombre de código de producción. Por ejemplo, el Nexus One devuelve `Passion` y Motorola Droid devuelve `voles`.\n\n [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT\n [2]: http://developer.android.com/reference/android/os/Build.html#MODEL\n\n### Rarezas Tizen\n\n* Devuelve que el modelo de dispositivo asignado por el proveedor, por ejemplo, `TIZEN`\n\n### Windows Phone 7 y 8 rarezas\n\n* Devuelve el modelo de dispositivo especificado por el fabricante. Por ejemplo, el Samsung Focus devuelve `SGH-i917`.\n\n## device.platform\n\nObtener el nombre del sistema operativo del dispositivo.\n\n var string = device.platform;\n \n\n### Plataformas soportadas\n\n* Android\n* BlackBerry 10\n* Browser4\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 y 8\n* Windows 8\n\n### Ejemplo rápido\n\n // Depending on the device, a few examples are:\n // - \"Android\"\n // - \"BlackBerry 10\"\n // - Browser: returns \"MacIntel\" on Mac\n // returns \"Win32\" on Windows\n // - \"iOS\"\n // - \"WinCE\"\n // - \"Tizen\"\n var devicePlatform = device.platform;\n \n\n### Windows Phone 7 rarezas\n\nDispositivos Windows Phone 7 informe de la plataforma como `WinCE`.\n\n### Windows Phone 8 rarezas\n\nDispositivos Windows Phone 8 Informe la plataforma como `Win32NT`.\n\n## device.uuid\n\nObtener identificador universalmente única del dispositivo ([UUID][3]).\n\n [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier\n\n var string = device.uuid;\n \n\n### Descripción\n\nLos detalles de cómo se genera un UUID son determinados por el fabricante del dispositivo y son específicos a la plataforma del dispositivo o modelo.\n\n### Plataformas soportadas\n\n* Android\n* BlackBerry 10\n* iOS\n* Tizen\n* Windows Phone 7 y 8\n* Windows 8\n\n### Ejemplo rápido\n\n // Android: devuelve un entero de 64 bits al azar (como una cadena, otra vez!) \n // el entero es generado en el primer arranque del dispositivo \n // \n // BlackBerry: devuelve el número PIN del dispositivo \n // este es un entero único de nueve dígitos (como una cadena, aunque!) \n // \n // iPhone: (parafraseado de la documentación de la clase UIDevice) \n // devuelve una cadena de valores hash creado a partir \n // de múltiples hardware identifica.\n / / Está garantizado para ser único para cada dispositivo y no puede ser atado / / a la cuenta de usuario.\n // Windows Phone 7: devuelve un hash de dispositivo + usuario actual, \n // si el usuario no está definido, un guid generado y persistirá hasta que se desinstala la aplicación \n // \n // Tizen: devuelve el dispositivo IMEI (identidad de equipo móvil internacional o IMEI es un número \n // único para cada teléfono móvil GSM y UMTS.\n var deviceID = device.uuid;\n \n\n### iOS chanfle\n\nEl `uuid` en iOS no es exclusiva de un dispositivo, pero varía para cada aplicación, para cada instalación. Cambia si puedes borrar y volver a instalar la aplicación, y posiblemente también cuándo actualizar iOS, o incluso mejorar la aplicación por la versión (evidente en iOS 5.1). El `uuid` no es un valor confiable.\n\n### Windows Phone 7 y 8 rarezas\n\nEl `uuid` para Windows Phone 7 requiere el permiso `ID_CAP_IDENTITY_DEVICE`. Microsoft pronto probablemente desaprueban esta propiedad. Si la capacidad no está disponible, la aplicación genera un guid persistente que se mantiene durante la duración de la instalación de la aplicación en el dispositivo.\n\n## device.version\n\nObtener la versión del sistema operativo.\n\n var string = device.version;\n \n\n### Plataformas soportadas\n\n* Android 2.1 +\n* BlackBerry 10\n* Explorador\n* iOS\n* Tizen\n* Windows Phone 7 y 8\n* Windows 8\n\n### Ejemplo rápido\n\n // Android: Froyo OS would return \"2.2\"\n // Eclair OS would return \"2.1\", \"2.0.1\", or \"2.0\"\n // Version can also return update level \"2.1-update1\"\n //\n // BlackBerry: Torch 9800 using OS 6.0 would return \"6.0.0.600\"\n //\n // Browser: Returns version number for the browser\n //\n // iPhone: iOS 3.2 returns \"3.2\"\n //\n // Windows Phone 7: returns current OS version number, ex. el Mango se vuelve 7.10.7720 \n // Tizen: devuelve \"TIZEN_20120425_2\" \n var deviceVersion = device.version;\n"
},
{
"path": "plugins/cordova-plugin-device/doc/fr/README.md",
"content": "\n\n# cordova-plugin-device\n\n[](https://travis-ci.org/apache/cordova-plugin-device)\n\nCe plugin définit un global `device` objet qui décrit le matériel et les logiciels de l'appareil. Bien que l'objet est dans la portée globale, il n'est pas disponible jusqu'après la `deviceready` événement.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(device.cordova);\n }\n \n\n## Installation\n\n cordova plugin add cordova-plugin-device\n \n\n## Propriétés\n\n * device.cordova\n * device.model\n * device.platform\n * device.uuid\n * device.version\n\n## device.cordova\n\nRetourne la version de Cordova en cours d'exécution sur l'appareil.\n\n### Plates-formes supportées\n\n * Amazon Fire OS\n * Android\n * BlackBerry 10\n * Navigateur\n * Firefox OS\n * iOS\n * Paciarelli\n * Windows Phone 7 et 8\n * Windows 8\n\n## device.model\n\nL'objet `device.model` retourne le nom du modèle de l'appareil/produit. Cette valeur est définie par le fabricant du périphérique et peut varier entre les différentes versions d'un même produit.\n\n### Plates-formes supportées\n\n * Android\n * BlackBerry 10\n * Navigateur\n * iOS\n * Paciarelli\n * Windows Phone 7 et 8\n * Windows 8\n\n### Exemple court\n\n // Android: Nexus One returns \"Passion\" (Nexus One code name)\n // Motorola Droid returns \"voles\"\n // BlackBerry: Torch 9800 returns \"9800\"\n // Browser: Google Chrome returns \"Chrome\"\n // Safari returns \"Safari\"\n // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. Voir http://theiphonewiki.com/wiki/index.php?title=Models\n //\n var model = device.model;\n \n\n### Quirks Android\n\n * Retourne le [nom du produit](http://developer.android.com/reference/android/os/Build.html#PRODUCT) au lieu du [nom du modèle](http://developer.android.com/reference/android/os/Build.html#MODEL), ce qui équivaut souvent au nom de code de production. Par exemple, `Passion` pour le Nexus One et `voles` pour le Motorola Droid.\n\n### Bizarreries de paciarelli\n\n * Retourne le modèle du dispositif, assigné par le vendeur, par exemple `TIZEN`\n\n### Notes au sujet de Windows Phone 7 et 8\n\n * Retourne le modèle de l'appareil spécifié par le fabricant. Par exemple `SGH-i917` pour le Samsung Focus.\n\n## device.platform\n\nObtenir le nom de système d'exploitation de l'appareil.\n\n var string = device.platform;\n \n\n### Plates-formes supportées\n\n * Android\n * BlackBerry 10\n * Browser4\n * Firefox OS\n * iOS\n * Paciarelli\n * Windows Phone 7 et 8\n * Windows 8\n\n### Exemple court\n\n // Depending on the device, a few examples are:\n // - \"Android\"\n // - \"BlackBerry 10\"\n // - Browser: returns \"MacIntel\" on Mac\n // returns \"Win32\" on Windows\n // - \"iOS\"\n // - \"WinCE\"\n // - \"Tizen\"\n var devicePlatform = device.platform;\n \n\n### Windows Phone 7 Quirks\n\nAppareils Windows Phone 7 rapport de la plate-forme comme`WinCE`.\n\n### Notes au sujet de Windows Phone 8\n\nAppareils Windows Phone 8 rapport de la plate-forme comme`Win32NT`.\n\n## device.uuid\n\nObtenir Universally Unique Identifier de l'appareil ([UUID](http://en.wikipedia.org/wiki/Universally_Unique_Identifier)).\n\n var string = device.uuid;\n \n\n### Description\n\nLes détails de comment un UUID généré sont déterminées par le fabricant du périphérique et sont spécifiques à la plate-forme ou le modèle de l'appareil.\n\n### Plates-formes supportées\n\n * Android\n * BlackBerry 10\n * iOS\n * Paciarelli\n * Windows Phone 7 et 8\n * Windows 8\n\n### Exemple court\n\n // Android : retourne un nombre entier 64-bit aléatoire (sous la forme d'une chaîne de caractères, encore !)\n // Ce nombre entier est généré lors du premier démarrage de l'appareil\n //\n // BlackBerry : retourne le numéro PIN de l'appareil\n // Il s'agit d'un nombre entier unique à neuf chiffres (sous la forme d'une chaîne de caractères cependant !)\n //\n // iPhone : (copié depuis la documentation de la classe UIDevice)\n // Retourne une chaîne de caractères générée à partir de plusieurs caractéristiques matérielles.\n / / Il est garanti pour être unique pour chaque appareil et ne peut pas être lié / / pour le compte d'utilisateur.\n // Windows Phone 7 : retourne un hashage généré à partir de appareil+utilisateur actuel,\n // si aucun utilisateur n'est défini, un guid est généré persistera jusqu'à ce que l'application soit désinstallée\n // Tizen : retourne le numéro IMEI (International Mobile Equipment Identity) de l'appareil, ce numéro est\n // unique pour chaque téléphone GSM et UMTS.\n var deviceID = device.uuid;\n \n\n### Spécificités iOS\n\nLe `uuid` sur iOS n'est pas propre à un périphérique, mais varie pour chaque application, pour chaque installation. Elle change si vous supprimez, puis réinstallez l'application, et éventuellement aussi quand vous mettre à jour d'iOS, ou même mettre à jour le soft par version (apparent dans iOS 5.1). Le `uuid` n'est pas une valeur fiable.\n\n### Notes au sujet de Windows Phone 7 et 8\n\nLe `uuid` pour Windows Phone 7 requiert l'autorisation `ID_CAP_IDENTITY_DEVICE` . Microsoft va probablement bientôt obsolète de cette propriété. Si la capacité n'est pas disponible, l'application génère un guid persistant qui est maintenu pendant toute la durée de l'installation de l'application sur le périphérique.\n\n## device.version\n\nTéléchargez la version de système d'exploitation.\n\n var string = device.version;\n \n\n### Plates-formes supportées\n\n * Android 2.1+\n * BlackBerry 10\n * Navigateur\n * iOS\n * Paciarelli\n * Windows Phone 7 et 8\n * Windows 8\n\n### Exemple court\n\n // Android: Froyo OS would return \"2.2\"\n // Eclair OS would return \"2.1\", \"2.0.1\", or \"2.0\"\n // Version can also return update level \"2.1-update1\"\n //\n // BlackBerry: Torch 9800 using OS 6.0 would return \"6.0.0.600\"\n //\n // Browser: Returns version number for the browser\n //\n // iPhone: iOS 3.2 returns \"3.2\"\n //\n // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720\n // Tizen: returns \"TIZEN_20120425_2\"\n var deviceVersion = device.version;"
},
{
"path": "plugins/cordova-plugin-device/doc/fr/index.md",
"content": "\n\n# cordova-plugin-device\n\nCe plugin définit un global `device` objet qui décrit le matériel et les logiciels de l'appareil. Bien que l'objet est dans la portée globale, il n'est pas disponible jusqu'après la `deviceready` événement.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(device.cordova);\n }\n \n\n## Installation\n\n cordova plugin add cordova-plugin-device\n \n\n## Propriétés\n\n* device.cordova\n* device.model\n* device.platform\n* device.uuid\n* device.version\n\n## device.cordova\n\nRetourne la version de Cordova en cours d'exécution sur l'appareil.\n\n### Plates-formes prises en charge\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* Navigateur\n* Firefox OS\n* iOS\n* Paciarelli\n* Windows Phone 7 et 8\n* Windows 8\n\n## device.model\n\nL'objet `device.model` retourne le nom du modèle de l'appareil/produit. Cette valeur est définie par le fabricant du périphérique et peut varier entre les différentes versions d'un même produit.\n\n### Plates-formes prises en charge\n\n* Android\n* BlackBerry 10\n* Navigateur\n* iOS\n* Paciarelli\n* Windows Phone 7 et 8\n* Windows 8\n\n### Petit exemple\n\n // Android: Nexus One returns \"Passion\" (Nexus One code name)\n // Motorola Droid returns \"voles\"\n // BlackBerry: Torch 9800 returns \"9800\"\n // Browser: Google Chrome returns \"Chrome\"\n // Safari returns \"Safari\"\n // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. Voir http://theiphonewiki.com/wiki/index.php?title=Models\n //\n var model = device.model;\n \n\n### Quirks Android\n\n* Retourne le [nom du produit][1] au lieu du [nom du modèle][2], ce qui équivaut souvent au nom de code de production. Par exemple, `Passion` pour le Nexus One et `voles` pour le Motorola Droid.\n\n [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT\n [2]: http://developer.android.com/reference/android/os/Build.html#MODEL\n\n### Bizarreries de paciarelli\n\n* Retourne le modèle du dispositif, assigné par le vendeur, par exemple `TIZEN`\n\n### Windows Phone 7 et 8 Quirks\n\n* Retourne le modèle de l'appareil spécifié par le fabricant. Par exemple `SGH-i917` pour le Samsung Focus.\n\n## device.platform\n\nObtenir le nom de système d'exploitation de l'appareil.\n\n var string = device.platform;\n \n\n### Plates-formes prises en charge\n\n* Android\n* BlackBerry 10\n* Browser4\n* Firefox OS\n* iOS\n* Paciarelli\n* Windows Phone 7 et 8\n* Windows 8\n\n### Petit exemple\n\n // Depending on the device, a few examples are:\n // - \"Android\"\n // - \"BlackBerry 10\"\n // - Browser: returns \"MacIntel\" on Mac\n // returns \"Win32\" on Windows\n // - \"iOS\"\n // - \"WinCE\"\n // - \"Tizen\"\n var devicePlatform = device.platform;\n \n\n### Windows Phone 7 Quirks\n\nAppareils Windows Phone 7 rapport de la plate-forme comme`WinCE`.\n\n### Notes au sujet de Windows Phone 8\n\nAppareils Windows Phone 8 rapport de la plate-forme comme`Win32NT`.\n\n## device.uuid\n\nObtenir Universally Unique Identifier de l'appareil ([UUID][3]).\n\n [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier\n\n var string = device.uuid;\n \n\n### Description\n\nLes détails de comment un UUID généré sont déterminées par le fabricant du périphérique et sont spécifiques à la plate-forme ou le modèle de l'appareil.\n\n### Plates-formes prises en charge\n\n* Android\n* BlackBerry 10\n* iOS\n* Paciarelli\n* Windows Phone 7 et 8\n* Windows 8\n\n### Petit exemple\n\n // Android : retourne un nombre entier 64-bit aléatoire (sous la forme d'une chaîne de caractères, encore !)\n // Ce nombre entier est généré lors du premier démarrage de l'appareil\n //\n // BlackBerry : retourne le numéro PIN de l'appareil\n // Il s'agit d'un nombre entier unique à neuf chiffres (sous la forme d'une chaîne de caractères cependant !)\n //\n // iPhone : (copié depuis la documentation de la classe UIDevice)\n // Retourne une chaîne de caractères générée à partir de plusieurs caractéristiques matérielles.\n / / Il est garanti pour être unique pour chaque appareil et ne peut pas être lié / / pour le compte d'utilisateur.\n // Windows Phone 7 : retourne un hashage généré à partir de appareil+utilisateur actuel,\n // si aucun utilisateur n'est défini, un guid est généré persistera jusqu'à ce que l'application soit désinstallée\n // Tizen : retourne le numéro IMEI (International Mobile Equipment Identity) de l'appareil, ce numéro est\n // unique pour chaque téléphone GSM et UMTS.\n var deviceID = device.uuid;\n \n\n### Spécificités iOS\n\nLe `uuid` sur iOS n'est pas propre à un périphérique, mais varie pour chaque application, pour chaque installation. Elle change si vous supprimez, puis réinstallez l'application, et éventuellement aussi quand vous mettre à jour d'iOS, ou même mettre à jour le soft par version (apparent dans iOS 5.1). Le `uuid` n'est pas une valeur fiable.\n\n### Windows Phone 7 et 8 Quirks\n\nLe `uuid` pour Windows Phone 7 requiert l'autorisation `ID_CAP_IDENTITY_DEVICE` . Microsoft va probablement bientôt obsolète de cette propriété. Si la capacité n'est pas disponible, l'application génère un guid persistant qui est maintenu pendant toute la durée de l'installation de l'application sur le périphérique.\n\n## device.version\n\nTéléchargez la version de système d'exploitation.\n\n var string = device.version;\n \n\n### Plates-formes prises en charge\n\n* Android 2.1+\n* BlackBerry 10\n* Navigateur\n* iOS\n* Paciarelli\n* Windows Phone 7 et 8\n* Windows 8\n\n### Petit exemple\n\n // Android: Froyo OS would return \"2.2\"\n // Eclair OS would return \"2.1\", \"2.0.1\", or \"2.0\"\n // Version can also return update level \"2.1-update1\"\n //\n // BlackBerry: Torch 9800 using OS 6.0 would return \"6.0.0.600\"\n //\n // Browser: Returns version number for the browser\n //\n // iPhone: iOS 3.2 returns \"3.2\"\n //\n // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720\n // Tizen: returns \"TIZEN_20120425_2\"\n var deviceVersion = device.version;\n"
},
{
"path": "plugins/cordova-plugin-device/doc/it/README.md",
"content": "\n\n# cordova-plugin-device\n\n[](https://travis-ci.org/apache/cordova-plugin-device)\n\nQuesto plugin definisce un global `device` oggetto che descrive il dispositivo hardware e software. Sebbene l'oggetto sia in ambito globale, non è disponibile fino a dopo il `deviceready` evento.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(device.cordova);\n }\n \n\n## Installazione\n\n cordova plugin add cordova-plugin-device\n \n\n## Proprietà\n\n * device.cordova\n * device.model\n * device.platform\n * device.uuid\n * device.version\n\n## device.cordova\n\nOttenere la versione di Cordova in esecuzione nel dispositivo.\n\n### Piattaforme supportate\n\n * Amazon fuoco OS\n * Android\n * BlackBerry 10\n * Browser\n * Firefox OS\n * iOS\n * Tizen\n * Windows Phone 7 e 8\n * Windows 8\n\n## device.model\n\nIl `device.model` restituisce il nome del modello del dispositivo o del prodotto. Il valore viene impostato dal produttore del dispositivo e può essere differente tra le versioni dello stesso prodotto.\n\n### Piattaforme supportate\n\n * Android\n * BlackBerry 10\n * Browser\n * iOS\n * Tizen\n * Windows Phone 7 e 8\n * Windows 8\n\n### Esempio rapido\n\n // Android: Nexus One returns \"Passion\" (Nexus One code name)\n // Motorola Droid returns \"voles\"\n // BlackBerry: Torch 9800 returns \"9800\"\n // Browser: Google Chrome returns \"Chrome\"\n // Safari returns \"Safari\"\n // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. Vedi http://theiphonewiki.com/wiki/index.php?title=Models / / modello var = device.model;\n \n\n### Stranezze Android\n\n * Ottiene il [nome del prodotto](http://developer.android.com/reference/android/os/Build.html#PRODUCT) anziché il [nome del modello](http://developer.android.com/reference/android/os/Build.html#MODEL), che è spesso il nome di codice di produzione. Ad esempio, restituisce il Nexus One `Passion` , e Motorola Droid restituisce`voles`.\n\n### Tizen stranezze\n\n * Restituisce il modello di dispositivo assegnato dal fornitore, ad esempio,`TIZEN`\n\n### Windows Phone 7 e 8 stranezze\n\n * Restituisce il modello di dispositivo specificato dal produttore. Ad esempio, restituisce il Samsung Focus`SGH-i917`.\n\n## device.platform\n\nOttenere il nome del sistema operativo del dispositivo.\n\n var string = device.platform;\n \n\n### Piattaforme supportate\n\n * Android\n * BlackBerry 10\n * Browser4\n * Firefox OS\n * iOS\n * Tizen\n * Windows Phone 7 e 8\n * Windows 8\n\n### Esempio rapido\n\n // Depending on the device, a few examples are:\n // - \"Android\"\n // - \"BlackBerry 10\"\n // - Browser: returns \"MacIntel\" on Mac\n // returns \"Win32\" on Windows\n // - \"iOS\"\n // - \"WinCE\"\n // - \"Tizen\"\n var devicePlatform = device.platform;\n \n\n### Windows Phone 7 capricci\n\nWindows Phone 7 dispositivi segnalano la piattaforma come`WinCE`.\n\n### Windows Phone 8 stranezze\n\nDispositivi Windows Phone 8 segnalano la piattaforma come`Win32NT`.\n\n## device.uuid\n\nOttenere identificatore del dispositivo univoco universale ([UUID](http://en.wikipedia.org/wiki/Universally_Unique_Identifier)).\n\n var string = device.uuid;\n \n\n### Descrizione\n\nI dettagli di come viene generato un UUID sono determinati dal produttore del dispositivo e sono specifici per la piattaforma o il modello del dispositivo.\n\n### Piattaforme supportate\n\n * Android\n * BlackBerry 10\n * iOS\n * Tizen\n * Windows Phone 7 e 8\n * Windows 8\n\n### Esempio rapido\n\n / / Android: restituisce un intero casuale di 64 bit (come stringa, ancora una volta!) / / il numero intero è generato al primo avvio del dispositivo / / / / BlackBerry: restituisce il numero PIN del dispositivo / / questo è un valore integer univoco a nove cifre (come stringa, benchè!) / / / / iPhone: (parafrasato dalla documentazione della classe UIDevice) / / restituisce una stringa di valori hash creata dall'hardware più identifica.\n / / È garantito per essere unica per ogni dispositivo e non può essere legato / / per l'account utente.\n / / Windows Phone 7: restituisce un hash dell'utente corrente, + dispositivo / / se l'utente non è definito, un guid generato e persisterà fino a quando l'applicazione viene disinstallata / / Tizen: restituisce il dispositivo IMEI (International Mobile Equipment Identity o IMEI è un numero / / unico per ogni cellulare GSM e UMTS.\n var deviceID = device.uuid;\n \n\n### iOS Quirk\n\nIl `uuid` su iOS non è univoco per un dispositivo, ma varia per ogni applicazione, per ogni installazione. Cambia se si elimina e re-installare l'app, e possibilmente anche quando aggiornare iOS o anche aggiornare l'app per ogni versione (apparente in iOS 5.1). Il `uuid` non è un valore affidabile.\n\n### Windows Phone 7 e 8 stranezze\n\nIl `uuid` per Windows Phone 7 richiede l'autorizzazione `ID_CAP_IDENTITY_DEVICE` . Microsoft probabilmente sarà presto deprecare questa proprietà. Se la funzionalità non è disponibile, l'applicazione genera un guid persistente che viene mantenuto per la durata dell'installazione dell'applicazione sul dispositivo.\n\n## device.version\n\nOttenere la versione del sistema operativo.\n\n var string = device.version;\n \n\n### Piattaforme supportate\n\n * Android 2.1 +\n * BlackBerry 10\n * Browser\n * iOS\n * Tizen\n * Windows Phone 7 e 8\n * Windows 8\n\n### Esempio rapido\n\n // Android: Froyo OS would return \"2.2\"\n // Eclair OS would return \"2.1\", \"2.0.1\", or \"2.0\"\n // Version can also return update level \"2.1-update1\"\n //\n // BlackBerry: Torch 9800 using OS 6.0 would return \"6.0.0.600\"\n //\n // Browser: Returns version number for the browser\n //\n // iPhone: iOS 3.2 returns \"3.2\"\n //\n // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720\n // Tizen: returns \"TIZEN_20120425_2\"\n var deviceVersion = device.version;"
},
{
"path": "plugins/cordova-plugin-device/doc/it/index.md",
"content": "\n\n# cordova-plugin-device\n\nQuesto plugin definisce un global `device` oggetto che descrive il dispositivo hardware e software. Sebbene l'oggetto sia in ambito globale, non è disponibile fino a dopo il `deviceready` evento.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(device.cordova);\n }\n \n\n## Installazione\n\n cordova plugin add cordova-plugin-device\n \n\n## Proprietà\n\n* device.cordova\n* device.model\n* device.platform\n* device.uuid\n* device.version\n\n## device.cordova\n\nOttenere la versione di Cordova in esecuzione nel dispositivo.\n\n### Piattaforme supportate\n\n* Amazon fuoco OS\n* Android\n* BlackBerry 10\n* Browser\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 e 8\n* Windows 8\n\n## device.model\n\nIl `device.model` restituisce il nome del modello del dispositivo o del prodotto. Il valore viene impostato dal produttore del dispositivo e può essere differente tra le versioni dello stesso prodotto.\n\n### Piattaforme supportate\n\n* Android\n* BlackBerry 10\n* Browser\n* iOS\n* Tizen\n* Windows Phone 7 e 8\n* Windows 8\n\n### Esempio rapido\n\n // Android: Nexus One returns \"Passion\" (Nexus One code name)\n // Motorola Droid returns \"voles\"\n // BlackBerry: Torch 9800 returns \"9800\"\n // Browser: Google Chrome returns \"Chrome\"\n // Safari returns \"Safari\"\n // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. Vedi http://theiphonewiki.com/wiki/index.php?title=Models / / modello var = device.model;\n \n\n### Stranezze Android\n\n* Ottiene il [nome del prodotto][1] anziché il [nome del modello][2], che è spesso il nome di codice di produzione. Ad esempio, restituisce il Nexus One `Passion` , e Motorola Droid restituisce`voles`.\n\n [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT\n [2]: http://developer.android.com/reference/android/os/Build.html#MODEL\n\n### Tizen stranezze\n\n* Restituisce il modello di dispositivo assegnato dal fornitore, ad esempio,`TIZEN`\n\n### Windows Phone 7 e 8 stranezze\n\n* Restituisce il modello di dispositivo specificato dal produttore. Ad esempio, restituisce il Samsung Focus`SGH-i917`.\n\n## device.platform\n\nOttenere il nome del sistema operativo del dispositivo.\n\n var string = device.platform;\n \n\n### Piattaforme supportate\n\n* Android\n* BlackBerry 10\n* Browser4\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 e 8\n* Windows 8\n\n### Esempio rapido\n\n // Depending on the device, a few examples are:\n // - \"Android\"\n // - \"BlackBerry 10\"\n // - Browser: returns \"MacIntel\" on Mac\n // returns \"Win32\" on Windows\n // - \"iOS\"\n // - \"WinCE\"\n // - \"Tizen\"\n var devicePlatform = device.platform;\n \n\n### Windows Phone 7 capricci\n\nWindows Phone 7 dispositivi segnalano la piattaforma come`WinCE`.\n\n### Windows Phone 8 stranezze\n\nDispositivi Windows Phone 8 segnalano la piattaforma come`Win32NT`.\n\n## device.uuid\n\nOttenere identificatore del dispositivo univoco universale ([UUID][3]).\n\n [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier\n\n var string = device.uuid;\n \n\n### Descrizione\n\nI dettagli di come viene generato un UUID sono determinati dal produttore del dispositivo e sono specifici per la piattaforma o il modello del dispositivo.\n\n### Piattaforme supportate\n\n* Android\n* BlackBerry 10\n* iOS\n* Tizen\n* Windows Phone 7 e 8\n* Windows 8\n\n### Esempio rapido\n\n / / Android: restituisce un intero casuale di 64 bit (come stringa, ancora una volta!) / / il numero intero è generato al primo avvio del dispositivo / / / / BlackBerry: restituisce il numero PIN del dispositivo / / questo è un valore integer univoco a nove cifre (come stringa, benchè!) / / / / iPhone: (parafrasato dalla documentazione della classe UIDevice) / / restituisce una stringa di valori hash creata dall'hardware più identifica.\n / / È garantito per essere unica per ogni dispositivo e non può essere legato / / per l'account utente.\n / / Windows Phone 7: restituisce un hash dell'utente corrente, + dispositivo / / se l'utente non è definito, un guid generato e persisterà fino a quando l'applicazione viene disinstallata / / Tizen: restituisce il dispositivo IMEI (International Mobile Equipment Identity o IMEI è un numero / / unico per ogni cellulare GSM e UMTS.\n var deviceID = device.uuid;\n \n\n### iOS Quirk\n\nIl `uuid` su iOS non è univoco per un dispositivo, ma varia per ogni applicazione, per ogni installazione. Cambia se si elimina e re-installare l'app, e possibilmente anche quando aggiornare iOS o anche aggiornare l'app per ogni versione (apparente in iOS 5.1). Il `uuid` non è un valore affidabile.\n\n### Windows Phone 7 e 8 stranezze\n\nIl `uuid` per Windows Phone 7 richiede l'autorizzazione `ID_CAP_IDENTITY_DEVICE` . Microsoft probabilmente sarà presto deprecare questa proprietà. Se la funzionalità non è disponibile, l'applicazione genera un guid persistente che viene mantenuto per la durata dell'installazione dell'applicazione sul dispositivo.\n\n## device.version\n\nOttenere la versione del sistema operativo.\n\n var string = device.version;\n \n\n### Piattaforme supportate\n\n* Android 2.1 +\n* BlackBerry 10\n* Browser\n* iOS\n* Tizen\n* Windows Phone 7 e 8\n* Windows 8\n\n### Esempio rapido\n\n // Android: Froyo OS would return \"2.2\"\n // Eclair OS would return \"2.1\", \"2.0.1\", or \"2.0\"\n // Version can also return update level \"2.1-update1\"\n //\n // BlackBerry: Torch 9800 using OS 6.0 would return \"6.0.0.600\"\n //\n // Browser: Returns version number for the browser\n //\n // iPhone: iOS 3.2 returns \"3.2\"\n //\n // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720\n // Tizen: returns \"TIZEN_20120425_2\"\n var deviceVersion = device.version;\n"
},
{
"path": "plugins/cordova-plugin-device/doc/ja/README.md",
"content": "\n\n# cordova-plugin-device\n\n[](https://travis-ci.org/apache/cordova-plugin-device)\n\nこのプラグインをグローバル定義します `device` オブジェクトは、デバイスのハードウェアとソフトウェアについて説明します。 それは後まで利用可能なオブジェクトがグローバル スコープでは、 `deviceready` イベント。\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(device.cordova);\n }\n \n\n## インストール\n\n cordova plugin add cordova-plugin-device\n \n\n## プロパティ\n\n * device.cordova\n * device.model\n * device.platform\n * device.uuid\n * device.version\n\n## device.cordova\n\nデバイスで実行されているコルドバのバージョンを取得します。\n\n### サポートされているプラットフォーム\n\n * アマゾン火 OS\n * アンドロイド\n * ブラックベリー 10\n * ブラウザー\n * Firefox の OS\n * iOS\n * Tizen\n * Windows Phone 7 と 8\n * Windows 8\n\n## device.model\n\n`device.model`、デバイスのモデルまたは製品の名前を返します。値は、デバイスの製造元によって設定され、同じ製品のバージョン間で異なる可能性があります。\n\n### サポートされているプラットフォーム\n\n * アンドロイド\n * ブラックベリー 10\n * ブラウザー\n * iOS\n * Tizen\n * Windows Phone 7 と 8\n * Windows 8\n\n### 簡単な例\n\n // Android: Nexus One returns \"Passion\" (Nexus One code name)\n // Motorola Droid returns \"voles\"\n // BlackBerry: Torch 9800 returns \"9800\"\n // Browser: Google Chrome returns \"Chrome\"\n // Safari returns \"Safari\"\n // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. Http://theiphonewiki.com/wiki/index.php?title=Models を参照してください//var モデル = device.model;\n \n\n### Android の癖\n\n * 生産コード名は[モデル名](http://developer.android.com/reference/android/os/Build.html#MODEL)の代わりに[製品名](http://developer.android.com/reference/android/os/Build.html#PRODUCT)を取得します。 たとえば、ネクサス 1 つを返します `Passion` 、Motorola のドロイドを返します`voles`.\n\n### Tizen の癖\n\n * たとえば、ベンダーによって割り当てられているデバイスのモデルを返します`TIZEN`\n\n### Windows Phone 7 と 8 癖\n\n * 製造元によって指定されたデバイスのモデルを返します。たとえば、三星フォーカスを返します`SGH-i917`.\n\n## device.platform\n\nデバイスのオペレーティング システム名を取得します。\n\n var string = device.platform;\n \n\n### サポートされているプラットフォーム\n\n * アンドロイド\n * ブラックベリー 10\n * Browser4\n * Firefox の OS\n * iOS\n * Tizen\n * Windows Phone 7 と 8\n * Windows 8\n\n### 簡単な例\n\n // Depending on the device, a few examples are:\n // - \"Android\"\n // - \"BlackBerry 10\"\n // - Browser: returns \"MacIntel\" on Mac\n // returns \"Win32\" on Windows\n // - \"iOS\"\n // - \"WinCE\"\n // - \"Tizen\"\n var devicePlatform = device.platform;\n \n\n### Windows Phone 7 の癖\n\nWindows Phone 7 デバイスとプラットフォームを報告します。`WinCE`.\n\n### Windows Phone 8 癖\n\nWindows Phone 8 デバイスとプラットフォームを報告します。`Win32NT`.\n\n## device.uuid\n\nデバイスのユニバーサル ・ ユニーク識別子 ([UUID](http://en.wikipedia.org/wiki/Universally_Unique_Identifier)を取得します。).\n\n var string = device.uuid;\n \n\n### 解説\n\nUUID を生成する方法の詳細は、デバイスの製造元によって決定され、デバイスのプラットフォームやモデルに固有です。\n\n### サポートされているプラットフォーム\n\n * アンドロイド\n * ブラックベリー 10\n * iOS\n * Tizen\n * Windows Phone 7 と 8\n * Windows 8\n\n### 簡単な例\n\n //アンドロイド: ランダムな 64 ビットの整数 (を文字列として返します、再び ！）/デバイスの最初の起動時に生成される整数/////ブラックベリー: デバイスのピン番号を返します//これは 9 桁の一意な整数 (を文字列としても ！)////iPhone: (UIDevice クラスのドキュメントから言い換え）//識別複数のハードウェアから作成されたハッシュ値の文字列を返します。。\n //それはすべてのデバイスに対して一意であることが保証され、接続することはできません//ユーザー アカウント。\n //Windows Phone 7: デバイス + 現在のユーザーのハッシュを返します//ユーザーが定義されていない場合 guid が生成され、アプリがアンインストールされるまで保持されます//Tizen: デバイスの IMEI を返します （国際モバイル機器アイデンティティまたは IMEI は番号です//すべての GSM および UMTS の携帯電話に固有です。\n var deviceID = device.uuid;\n \n\n### iOS の気まぐれ\n\n`uuid`IOS で、デバイスに固有ではないインストールごと、アプリケーションごとに異なります。 削除、アプリを再インストールした場合に変更と多分またときアップグレード iOS の, またはもアップグレードするアプリ (iOS の 5.1 で明らかに） バージョンごと。 `uuid`は信頼性の高い値ではありません。\n\n### Windows Phone 7 と 8 癖\n\n`uuid`のために Windows Phone 7 には、権限が必要です `ID_CAP_IDENTITY_DEVICE` 。 Microsoft はすぐにこのプロパティを廃止して可能性があります。 機能が利用できない場合、アプリケーションはデバイスへのアプリケーションのインストールの持続期間のために保持されている永続的な guid を生成します。\n\n## device.version\n\nオペレーティング システムのバージョンを取得します。\n\n var string = device.version;\n \n\n### サポートされているプラットフォーム\n\n * アンドロイド 2.1 +\n * ブラックベリー 10\n * ブラウザー\n * iOS\n * Tizen\n * Windows Phone 7 と 8\n * Windows 8\n\n### 簡単な例\n\n // Android: Froyo OS would return \"2.2\"\n // Eclair OS would return \"2.1\", \"2.0.1\", or \"2.0\"\n // Version can also return update level \"2.1-update1\"\n //\n // BlackBerry: Torch 9800 using OS 6.0 would return \"6.0.0.600\"\n //\n // Browser: Returns version number for the browser\n //\n // iPhone: iOS 3.2 returns \"3.2\"\n //\n // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720\n // Tizen: returns \"TIZEN_20120425_2\"\n var deviceVersion = device.version;"
},
{
"path": "plugins/cordova-plugin-device/doc/ja/index.md",
"content": "\n\n# cordova-plugin-device\n\nこのプラグインをグローバル定義します `device` オブジェクトは、デバイスのハードウェアとソフトウェアについて説明します。 それは後まで利用可能なオブジェクトがグローバル スコープでは、 `deviceready` イベント。\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(device.cordova);\n }\n \n\n## インストール\n\n cordova plugin add cordova-plugin-device\n \n\n## プロパティ\n\n* device.cordova\n* device.model\n* device.platform\n* device.uuid\n* device.version\n\n## device.cordova\n\nデバイスで実行されているコルドバのバージョンを取得します。\n\n### サポートされているプラットフォーム\n\n* アマゾン火 OS\n* アンドロイド\n* ブラックベリー 10\n* ブラウザー\n* Firefox の OS\n* iOS\n* Tizen\n* Windows Phone 7 と 8\n* Windows 8\n\n## device.model\n\n`device.model`、デバイスのモデルまたは製品の名前を返します。値は、デバイスの製造元によって設定され、同じ製品のバージョン間で異なる可能性があります。\n\n### サポートされているプラットフォーム\n\n* アンドロイド\n* ブラックベリー 10\n* ブラウザー\n* iOS\n* Tizen\n* Windows Phone 7 と 8\n* Windows 8\n\n### 簡単な例\n\n // Android: Nexus One returns \"Passion\" (Nexus One code name)\n // Motorola Droid returns \"voles\"\n // BlackBerry: Torch 9800 returns \"9800\"\n // Browser: Google Chrome returns \"Chrome\"\n // Safari returns \"Safari\"\n // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. Http://theiphonewiki.com/wiki/index.php?title=Models を参照してください//var モデル = device.model;\n \n\n### Android の癖\n\n* 生産コード名は[モデル名][1]の代わりに[製品名][2]を取得します。 たとえば、ネクサス 1 つを返します `Passion` 、Motorola のドロイドを返します`voles`.\n\n [1]: http://developer.android.com/reference/android/os/Build.html#MODEL\n [2]: http://developer.android.com/reference/android/os/Build.html#PRODUCT\n\n### Tizen の癖\n\n* たとえば、ベンダーによって割り当てられているデバイスのモデルを返します`TIZEN`\n\n### Windows Phone 7 と 8 癖\n\n* 製造元によって指定されたデバイスのモデルを返します。たとえば、三星フォーカスを返します`SGH-i917`.\n\n## device.platform\n\nデバイスのオペレーティング システム名を取得します。\n\n var string = device.platform;\n \n\n### サポートされているプラットフォーム\n\n* アンドロイド\n* ブラックベリー 10\n* Browser4\n* Firefox の OS\n* iOS\n* Tizen\n* Windows Phone 7 と 8\n* Windows 8\n\n### 簡単な例\n\n // Depending on the device, a few examples are:\n // - \"Android\"\n // - \"BlackBerry 10\"\n // - Browser: returns \"MacIntel\" on Mac\n // returns \"Win32\" on Windows\n // - \"iOS\"\n // - \"WinCE\"\n // - \"Tizen\"\n var devicePlatform = device.platform;\n \n\n### Windows Phone 7 の癖\n\nWindows Phone 7 デバイスとプラットフォームを報告します。`WinCE`.\n\n### Windows Phone 8 癖\n\nWindows Phone 8 デバイスとプラットフォームを報告します。`Win32NT`.\n\n## device.uuid\n\nデバイスのユニバーサル ・ ユニーク識別子 ([UUID][3]を取得します。).\n\n [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier\n\n var string = device.uuid;\n \n\n### 説明\n\nUUID を生成する方法の詳細は、デバイスの製造元によって決定され、デバイスのプラットフォームやモデルに固有です。\n\n### サポートされているプラットフォーム\n\n* アンドロイド\n* ブラックベリー 10\n* iOS\n* Tizen\n* Windows Phone 7 と 8\n* Windows 8\n\n### 簡単な例\n\n //アンドロイド: ランダムな 64 ビットの整数 (を文字列として返します、再び ！）/デバイスの最初の起動時に生成される整数/////ブラックベリー: デバイスのピン番号を返します//これは 9 桁の一意な整数 (を文字列としても ！)////iPhone: (UIDevice クラスのドキュメントから言い換え）//識別複数のハードウェアから作成されたハッシュ値の文字列を返します。。\n //それはすべてのデバイスに対して一意であることが保証され、接続することはできません//ユーザー アカウント。\n //Windows Phone 7: デバイス + 現在のユーザーのハッシュを返します//ユーザーが定義されていない場合 guid が生成され、アプリがアンインストールされるまで保持されます//Tizen: デバイスの IMEI を返します （国際モバイル機器アイデンティティまたは IMEI は番号です//すべての GSM および UMTS の携帯電話に固有です。\n var deviceID = device.uuid;\n \n\n### iOS の気まぐれ\n\n`uuid`IOS で、デバイスに固有ではないインストールごと、アプリケーションごとに異なります。 削除、アプリを再インストールした場合に変更と多分またときアップグレード iOS の, またはもアップグレードするアプリ (iOS の 5.1 で明らかに） バージョンごと。 `uuid`は信頼性の高い値ではありません。\n\n### Windows Phone 7 と 8 癖\n\n`uuid`のために Windows Phone 7 には、権限が必要です `ID_CAP_IDENTITY_DEVICE` 。 Microsoft はすぐにこのプロパティを廃止して可能性があります。 機能が利用できない場合、アプリケーションはデバイスへのアプリケーションのインストールの持続期間のために保持されている永続的な guid を生成します。\n\n## device.version\n\nオペレーティング システムのバージョンを取得します。\n\n var string = device.version;\n \n\n### サポートされているプラットフォーム\n\n* アンドロイド 2.1 +\n* ブラックベリー 10\n* ブラウザー\n* iOS\n* Tizen\n* Windows Phone 7 と 8\n* Windows 8\n\n### 簡単な例\n\n // Android: Froyo OS would return \"2.2\"\n // Eclair OS would return \"2.1\", \"2.0.1\", or \"2.0\"\n // Version can also return update level \"2.1-update1\"\n //\n // BlackBerry: Torch 9800 using OS 6.0 would return \"6.0.0.600\"\n //\n // Browser: Returns version number for the browser\n //\n // iPhone: iOS 3.2 returns \"3.2\"\n //\n // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720\n // Tizen: returns \"TIZEN_20120425_2\"\n var deviceVersion = device.version;\n"
},
{
"path": "plugins/cordova-plugin-device/doc/ko/README.md",
"content": "\n\n# cordova-plugin-device\n\n[](https://travis-ci.org/apache/cordova-plugin-device)\n\n이 플러그인 정의 전역 `device` 개체, 디바이스의 하드웨어 및 소프트웨어에 설명 합니다. 개체는 전역 범위에서 비록 그것은 후까지 사용할 수 있는 `deviceready` 이벤트.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(device.cordova);\n }\n \n\n## 설치\n\n cordova plugin add cordova-plugin-device\n \n\n## 속성\n\n * device.cordova\n * device.model\n * device.platform\n * device.uuid\n * device.version\n\n## device.cordova\n\n코르도바는 장치에서 실행 중인 버전을 얻을.\n\n### 지원 되는 플랫폼\n\n * 아마존 화재 운영 체제\n * 안 드 로이드\n * 블랙베리 10\n * 브라우저\n * Firefox 운영 체제\n * iOS\n * Tizen\n * Windows Phone 7과 8\n * 윈도우 8\n\n## device.model\n\n`device.model`소자의 모델 또는 제품의 이름을 반환 합니다. 값 장치 제조업체에서 설정 되 고 동일 제품의 버전 간에 다를 수 있습니다.\n\n### 지원 되는 플랫폼\n\n * 안 드 로이드\n * 블랙베리 10\n * 브라우저\n * iOS\n * Tizen\n * Windows Phone 7과 8\n * 윈도우 8\n\n### 빠른 예제\n\n // Android: Nexus One returns \"Passion\" (Nexus One code name)\n // Motorola Droid returns \"voles\"\n // BlackBerry: Torch 9800 returns \"9800\"\n // Browser: Google Chrome returns \"Chrome\"\n // Safari returns \"Safari\"\n // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. Http://theiphonewiki.com/wiki/index.php?title=Models 참조 / / var 모델 = device.model;\n \n\n### 안 드 로이드 단점\n\n * 어떤은 종종 프로덕션 코드 이름 대신 [제품 모델 이름](http://developer.android.com/reference/android/os/Build.html#MODEL), [제품 이름](http://developer.android.com/reference/android/os/Build.html#PRODUCT) 을 가져옵니다. 예를 들어 넥서스 하나 반환 합니다 `Passion` , 모토로라 Droid를 반환 합니다`voles`.\n\n### Tizen 특수\n\n * 예를 들어, 공급 업체에 의해 할당 된 디바이스 모델을 반환 합니다.`TIZEN`\n\n### Windows Phone 7, 8 특수\n\n * 제조업체에서 지정 하는 장치 모델을 반환 합니다. 예를 들어 삼성 포커스를 반환 합니다.`SGH-i917`.\n\n## device.platform\n\n장치의 운영 체제 이름을 얻을.\n\n var string = device.platform;\n \n\n### 지원 되는 플랫폼\n\n * 안 드 로이드\n * 블랙베리 10\n * Browser4\n * Firefox 운영 체제\n * iOS\n * Tizen\n * Windows Phone 7과 8\n * 윈도우 8\n\n### 빠른 예제\n\n // Depending on the device, a few examples are:\n // - \"Android\"\n // - \"BlackBerry 10\"\n // - Browser: returns \"MacIntel\" on Mac\n // returns \"Win32\" on Windows\n // - \"iOS\"\n // - \"WinCE\"\n // - \"Tizen\"\n var devicePlatform = device.platform;\n \n\n### Windows Phone 7 단점\n\nWindows Phone 7 장치 보고 플랫폼으로`WinCE`.\n\n### Windows Phone 8 단점\n\nWindows Phone 8 장치 보고 플랫폼으로`Win32NT`.\n\n## device.uuid\n\n소자의 보편적으로 고유 식별자 ([UUID](http://en.wikipedia.org/wiki/Universally_Unique_Identifier) 를 얻을합니다).\n\n var string = device.uuid;\n \n\n### 설명\n\nUUID 생성 방법의 자세한 내용은 장치 제조업체에 의해 결정 됩니다 및 소자의 플랫폼 이나 모델.\n\n### 지원 되는 플랫폼\n\n * 안 드 로이드\n * 블랙베리 10\n * iOS\n * Tizen\n * Windows Phone 7과 8\n * 윈도우 8\n\n### 빠른 예제\n\n / / 안 드 로이드: (문자열로 다시!) 임의의 64 비트 정수를 반환 합니다 / / 정수 장치의 첫 번째 부팅에서 생성 / / / / 블랙베리: 디바이스의 핀 번호를 반환 합니다 / / 이것은 9 자리 고유 정수 (문자열로 비록!) / / / / 아이폰: (UIDevice 클래스 설명서에서 읊 었) / / 문자열 여러 하드웨어에서 생성 하는 해시 값을 식별 하는 반환 합니다.\n / 그것은 모든 장치에 대 한 고유 해야 보장 되 고 묶일 수 없습니다 / / / 사용자 계정에.\n / / Windows Phone 7: 장치 + 현재 사용자의 해시를 반환 합니다 / / 사용자 정의 되지 않은 경우 guid 생성 되 고 응용 프로그램을 제거할 때까지 유지 됩니다 / / Tizen: 반환 장치 IMEI (국제 모바일 기기 식별 또는 IMEI 숫자입니다 / / 모든 GSM와 UMTS 휴대 전화 고유.\n var deviceID = device.uuid;\n \n\n### iOS 특질\n\n`uuid`ios 장치에 고유 하지 않습니다 하지만 각 설치에 대 한 응용 프로그램 마다 다릅니다. 삭제 하 고 다시 애플 리 케이 션을 설치 하는 경우 변경 가능 하 게 또한 iOS를 업그레이드 하거나 때 버전 (iOS 5.1에에서 명백한) 당 응용 프로그램 업그레이드도 하 고. `uuid`은 신뢰할 수 있는 값이 아닙니다.\n\n### Windows Phone 7, 8 특수\n\n`uuid`Windows Phone 7 필요 허가 `ID_CAP_IDENTITY_DEVICE` . Microsoft는 곧이 속성을 세웁니다 가능성이 것입니다. 기능을 사용할 수 없는 경우 응용 프로그램 장치에 응용 프로그램의 설치 하는 동안 유지 하는 영구 guid를 생성 합니다.\n\n## device.version\n\n운영 체제 버전을 얻을.\n\n var string = device.version;\n \n\n### 지원 되는 플랫폼\n\n * 안 드 로이드 2.1 +\n * 블랙베리 10\n * 브라우저\n * iOS\n * Tizen\n * Windows Phone 7과 8\n * 윈도우 8\n\n### 빠른 예제\n\n // Android: Froyo OS would return \"2.2\"\n // Eclair OS would return \"2.1\", \"2.0.1\", or \"2.0\"\n // Version can also return update level \"2.1-update1\"\n //\n // BlackBerry: Torch 9800 using OS 6.0 would return \"6.0.0.600\"\n //\n // Browser: Returns version number for the browser\n //\n // iPhone: iOS 3.2 returns \"3.2\"\n //\n // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720\n // Tizen: returns \"TIZEN_20120425_2\"\n var deviceVersion = device.version;"
},
{
"path": "plugins/cordova-plugin-device/doc/ko/index.md",
"content": "\n\n# cordova-plugin-device\n\n이 플러그인 정의 전역 `device` 개체, 디바이스의 하드웨어 및 소프트웨어에 설명 합니다. 개체는 전역 범위에서 비록 그것은 후까지 사용할 수 있는 `deviceready` 이벤트.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(device.cordova);\n }\n \n\n## 설치\n\n cordova plugin add cordova-plugin-device\n \n\n## 속성\n\n* device.cordova\n* device.model\n* device.platform\n* device.uuid\n* device.version\n\n## device.cordova\n\n코르도바는 장치에서 실행 중인 버전을 얻을.\n\n### 지원 되는 플랫폼\n\n* 아마존 화재 운영 체제\n* 안 드 로이드\n* 블랙베리 10\n* 브라우저\n* Firefox 운영 체제\n* iOS\n* Tizen\n* Windows Phone 7과 8\n* 윈도우 8\n\n## device.model\n\n`device.model`소자의 모델 또는 제품의 이름을 반환 합니다. 값 장치 제조업체에서 설정 되 고 동일 제품의 버전 간에 다를 수 있습니다.\n\n### 지원 되는 플랫폼\n\n* 안 드 로이드\n* 블랙베리 10\n* 브라우저\n* iOS\n* Tizen\n* Windows Phone 7과 8\n* 윈도우 8\n\n### 빠른 예제\n\n // Android: Nexus One returns \"Passion\" (Nexus One code name)\n // Motorola Droid returns \"voles\"\n // BlackBerry: Torch 9800 returns \"9800\"\n // Browser: Google Chrome returns \"Chrome\"\n // Safari returns \"Safari\"\n // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. Http://theiphonewiki.com/wiki/index.php?title=Models 참조 / / var 모델 = device.model;\n \n\n### 안 드 로이드 단점\n\n* 어떤은 종종 프로덕션 코드 이름 대신 [제품 모델 이름][1], [제품 이름][2] 을 가져옵니다. 예를 들어 넥서스 하나 반환 합니다 `Passion` , 모토로라 Droid를 반환 합니다`voles`.\n\n [1]: http://developer.android.com/reference/android/os/Build.html#MODEL\n [2]: http://developer.android.com/reference/android/os/Build.html#PRODUCT\n\n### Tizen 특수\n\n* 예를 들어, 공급 업체에 의해 할당 된 디바이스 모델을 반환 합니다.`TIZEN`\n\n### Windows Phone 7, 8 특수\n\n* 제조업체에서 지정 하는 장치 모델을 반환 합니다. 예를 들어 삼성 포커스를 반환 합니다.`SGH-i917`.\n\n## device.platform\n\n장치의 운영 체제 이름을 얻을.\n\n var string = device.platform;\n \n\n### 지원 되는 플랫폼\n\n* 안 드 로이드\n* 블랙베리 10\n* Browser4\n* Firefox 운영 체제\n* iOS\n* Tizen\n* Windows Phone 7과 8\n* 윈도우 8\n\n### 빠른 예제\n\n // Depending on the device, a few examples are:\n // - \"Android\"\n // - \"BlackBerry 10\"\n // - Browser: returns \"MacIntel\" on Mac\n // returns \"Win32\" on Windows\n // - \"iOS\"\n // - \"WinCE\"\n // - \"Tizen\"\n var devicePlatform = device.platform;\n \n\n### Windows Phone 7 단점\n\nWindows Phone 7 장치 보고 플랫폼으로`WinCE`.\n\n### Windows Phone 8 단점\n\nWindows Phone 8 장치 보고 플랫폼으로`Win32NT`.\n\n## device.uuid\n\n소자의 보편적으로 고유 식별자 ([UUID][3] 를 얻을합니다).\n\n [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier\n\n var string = device.uuid;\n \n\n### 설명\n\nUUID 생성 방법의 자세한 내용은 장치 제조업체에 의해 결정 됩니다 및 소자의 플랫폼 이나 모델.\n\n### 지원 되는 플랫폼\n\n* 안 드 로이드\n* 블랙베리 10\n* iOS\n* Tizen\n* Windows Phone 7과 8\n* 윈도우 8\n\n### 빠른 예제\n\n / / 안 드 로이드: (문자열로 다시!) 임의의 64 비트 정수를 반환 합니다 / / 정수 장치의 첫 번째 부팅에서 생성 / / / / 블랙베리: 디바이스의 핀 번호를 반환 합니다 / / 이것은 9 자리 고유 정수 (문자열로 비록!) / / / / 아이폰: (UIDevice 클래스 설명서에서 읊 었) / / 문자열 여러 하드웨어에서 생성 하는 해시 값을 식별 하는 반환 합니다.\n / 그것은 모든 장치에 대 한 고유 해야 보장 되 고 묶일 수 없습니다 / / / 사용자 계정에.\n / / Windows Phone 7: 장치 + 현재 사용자의 해시를 반환 합니다 / / 사용자 정의 되지 않은 경우 guid 생성 되 고 응용 프로그램을 제거할 때까지 유지 됩니다 / / Tizen: 반환 장치 IMEI (국제 모바일 기기 식별 또는 IMEI 숫자입니다 / / 모든 GSM와 UMTS 휴대 전화 고유.\n var deviceID = device.uuid;\n \n\n### iOS 특질\n\n`uuid`ios 장치에 고유 하지 않습니다 하지만 각 설치에 대 한 응용 프로그램 마다 다릅니다. 삭제 하 고 다시 애플 리 케이 션을 설치 하는 경우 변경 가능 하 게 또한 iOS를 업그레이드 하거나 때 버전 (iOS 5.1에에서 명백한) 당 응용 프로그램 업그레이드도 하 고. `uuid`은 신뢰할 수 있는 값이 아닙니다.\n\n### Windows Phone 7, 8 특수\n\n`uuid`Windows Phone 7 필요 허가 `ID_CAP_IDENTITY_DEVICE` . Microsoft는 곧이 속성을 세웁니다 가능성이 것입니다. 기능을 사용할 수 없는 경우 응용 프로그램 장치에 응용 프로그램의 설치 하는 동안 유지 하는 영구 guid를 생성 합니다.\n\n## device.version\n\n운영 체제 버전을 얻을.\n\n var string = device.version;\n \n\n### 지원 되는 플랫폼\n\n* 안 드 로이드 2.1 +\n* 블랙베리 10\n* 브라우저\n* iOS\n* Tizen\n* Windows Phone 7과 8\n* 윈도우 8\n\n### 빠른 예제\n\n // Android: Froyo OS would return \"2.2\"\n // Eclair OS would return \"2.1\", \"2.0.1\", or \"2.0\"\n // Version can also return update level \"2.1-update1\"\n //\n // BlackBerry: Torch 9800 using OS 6.0 would return \"6.0.0.600\"\n //\n // Browser: Returns version number for the browser\n //\n // iPhone: iOS 3.2 returns \"3.2\"\n //\n // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720\n // Tizen: returns \"TIZEN_20120425_2\"\n var deviceVersion = device.version;\n"
},
{
"path": "plugins/cordova-plugin-device/doc/pl/README.md",
"content": "\n\n# cordova-plugin-device\n\n[](https://travis-ci.org/apache/cordova-plugin-device)\n\nTen plugin określa globalne `device` obiekt, który opisuje urządzenia sprzętowe i programowe. Mimo, że obiekt jest w globalnym zasięgu, nie jest dostępne dopiero po `deviceready` zdarzenie.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(device.cordova);\n }\n \n\n## Instalacja\n\n cordova plugin add cordova-plugin-device\n \n\n## Właściwości\n\n * device.cordova\n * device.model\n * device.platform\n * device.uuid\n * device.version\n\n## device.cordova\n\nPobierz wersję Cordova działa na urządzeniu.\n\n### Obsługiwane platformy\n\n * Amazon Fire OS\n * Android\n * BlackBerry 10\n * Przeglądarka\n * Firefox OS\n * iOS\n * Tizen\n * Windows Phone 7 i 8\n * Windows 8\n\n## device.model\n\n`device.model`Zwraca nazwę modelu lub produktu. Wartość jest zestaw przez producenta urządzenia i mogą się różnić między wersjami tego samego produktu.\n\n### Obsługiwane platformy\n\n * Android\n * BlackBerry 10\n * Przeglądarka\n * iOS\n * Tizen\n * Windows Phone 7 i 8\n * Windows 8\n\n### Szybki przykład\n\n // Android: Nexus One returns \"Passion\" (Nexus One code name)\n // Motorola Droid returns \"voles\"\n // BlackBerry: Torch 9800 returns \"9800\"\n // Browser: Google Chrome returns \"Chrome\"\n // Safari returns \"Safari\"\n // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. Zobacz http://theiphonewiki.com/wiki/index.php?title=Models / / modelu var = device.model;\n \n\n### Dziwactwa Androida\n\n * Pobiera [nazwę produktu](http://developer.android.com/reference/android/os/Build.html#PRODUCT) zamiast [nazwy modelu](http://developer.android.com/reference/android/os/Build.html#MODEL), który często jest nazwą kod produkcji. Na przykład, Nexus One zwraca `Passion` , i zwraca Motorola Droid`voles`.\n\n### Dziwactwa Tizen\n\n * Zwraca modelu urządzenia przypisane przez dostawcę, na przykład,`TIZEN`\n\n### Windows Phone 7 i 8 dziwactwa\n\n * Zwraca modelu urządzenia, określonej przez producenta. Na przykład Samsung ostrości zwraca`SGH-i917`.\n\n## device.platform\n\nUzyskać nazwę systemu operacyjnego urządzenia.\n\n var string = device.platform;\n \n\n### Obsługiwane platformy\n\n * Android\n * BlackBerry 10\n * Browser4\n * Firefox OS\n * iOS\n * Tizen\n * Windows Phone 7 i 8\n * Windows 8\n\n### Szybki przykład\n\n // Depending on the device, a few examples are:\n // - \"Android\"\n // - \"BlackBerry 10\"\n // - Browser: returns \"MacIntel\" on Mac\n // returns \"Win32\" on Windows\n // - \"iOS\"\n // - \"WinCE\"\n // - \"Tizen\"\n var devicePlatform = device.platform;\n \n\n### Dziwactwa Windows Phone 7\n\nUrządzenia Windows Phone 7 raport platformy jako`WinCE`.\n\n### Windows Phone 8 dziwactwa\n\nUrządzenia Windows Phone 8 raport platformy jako`Win32NT`.\n\n## device.uuid\n\nSię urządzenia uniwersalnie unikatowy identyfikator ([UUID](http://en.wikipedia.org/wiki/Universally_Unique_Identifier)).\n\n var string = device.uuid;\n \n\n### Opis\n\nSzczegóły jak UUID jest generowane są określane przez producenta urządzenia i są specyficzne dla platformy lub modelu urządzenia.\n\n### Obsługiwane platformy\n\n * Android\n * BlackBerry 10\n * iOS\n * Tizen\n * Windows Phone 7 i 8\n * Windows 8\n\n### Szybki przykład\n\n // Android: Returns a random 64-bit integer (as a string, again!)\n // The integer is generated on the device's first boot\n //\n // BlackBerry: Returns the PIN number of the device\n // This is a nine-digit unique integer (as a string, though!)\n //\n // iPhone: (Paraphrased from the UIDevice Class documentation)\n // Returns a string of hash values created from multiple hardware identifies.\n // It is guaranteed to be unique for every device and can't be tied\n // to the user account.\n // Windows Phone 7 : Returns a hash of device+current user,\n // if the user is not defined, a guid is generated and will persist until the app is uninstalled\n // Tizen: returns the device IMEI (International Mobile Equipment Identity or IMEI is a number\n // unique to every GSM and UMTS mobile phone.\n var deviceID = device.uuid;\n \n\n### iOS dziwactwo\n\n`uuid`Na iOS nie jest przypisany do urządzenia, ale różni się dla każdej aplikacji, dla każdej instalacji. Zmienia się jeśli możesz usunąć i ponownie zainstalować aplikację, a ewentualnie także po aktualizacji iOS czy nawet uaktualnienia aplikacji dla wersji (widoczny w iOS 5.1). `uuid`Jest nie wiarygodne wartości.\n\n### Windows Phone 7 i 8 dziwactwa\n\n`uuid`Dla Windows Phone 7 wymaga uprawnień `ID_CAP_IDENTITY_DEVICE` . Microsoft będzie prawdopodobnie potępiać ten wkrótce. Jeśli funkcja nie jest dostępna, aplikacja generuje trwałe identyfikator guid, który jest utrzymywany przez czas trwania instalacji aplikacji na urządzeniu.\n\n## device.version\n\nPobierz wersję systemu operacyjnego.\n\n var string = device.version;\n \n\n### Obsługiwane platformy\n\n * Android 2.1 +\n * BlackBerry 10\n * Przeglądarka\n * iOS\n * Tizen\n * Windows Phone 7 i 8\n * Windows 8\n\n### Szybki przykład\n\n // Android: Froyo OS would return \"2.2\"\n // Eclair OS would return \"2.1\", \"2.0.1\", or \"2.0\"\n // Version can also return update level \"2.1-update1\"\n //\n // BlackBerry: Torch 9800 using OS 6.0 would return \"6.0.0.600\"\n //\n // Browser: Returns version number for the browser\n //\n // iPhone: iOS 3.2 returns \"3.2\"\n //\n // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720\n // Tizen: returns \"TIZEN_20120425_2\"\n var deviceVersion = device.version;"
},
{
"path": "plugins/cordova-plugin-device/doc/pl/index.md",
"content": "\n\n# cordova-plugin-device\n\nTen plugin określa globalne `device` obiekt, który opisuje urządzenia sprzętowe i programowe. Mimo, że obiekt jest w globalnym zasięgu, nie jest dostępne dopiero po `deviceready` zdarzenie.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(device.cordova);\n }\n \n\n## Instalacja\n\n cordova plugin add cordova-plugin-device\n \n\n## Właściwości\n\n* device.cordova\n* device.model\n* device.platform\n* device.uuid\n* device.version\n\n## device.cordova\n\nPobierz wersję Cordova działa na urządzeniu.\n\n### Obsługiwane platformy\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* Przeglądarka\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 i 8\n* Windows 8\n\n## device.model\n\n`device.model`Zwraca nazwę modelu lub produktu. Wartość jest zestaw przez producenta urządzenia i mogą się różnić między wersjami tego samego produktu.\n\n### Obsługiwane platformy\n\n* Android\n* BlackBerry 10\n* Przeglądarka\n* iOS\n* Tizen\n* Windows Phone 7 i 8\n* Windows 8\n\n### Szybki przykład\n\n // Android: Nexus One returns \"Passion\" (Nexus One code name)\n // Motorola Droid returns \"voles\"\n // BlackBerry: Torch 9800 returns \"9800\"\n // Browser: Google Chrome returns \"Chrome\"\n // Safari returns \"Safari\"\n // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. Zobacz http://theiphonewiki.com/wiki/index.php?title=Models / / modelu var = device.model;\n \n\n### Dziwactwa Androida\n\n* Pobiera [nazwę produktu][1] zamiast [nazwy modelu][2], który często jest nazwą kod produkcji. Na przykład, Nexus One zwraca `Passion` , i zwraca Motorola Droid`voles`.\n\n [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT\n [2]: http://developer.android.com/reference/android/os/Build.html#MODEL\n\n### Dziwactwa Tizen\n\n* Zwraca modelu urządzenia przypisane przez dostawcę, na przykład,`TIZEN`\n\n### Windows Phone 7 i 8 dziwactwa\n\n* Zwraca modelu urządzenia, określonej przez producenta. Na przykład Samsung ostrości zwraca`SGH-i917`.\n\n## device.platform\n\nUzyskać nazwę systemu operacyjnego urządzenia.\n\n var string = device.platform;\n \n\n### Obsługiwane platformy\n\n* Android\n* BlackBerry 10\n* Browser4\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 i 8\n* Windows 8\n\n### Szybki przykład\n\n // Depending on the device, a few examples are:\n // - \"Android\"\n // - \"BlackBerry 10\"\n // - Browser: returns \"MacIntel\" on Mac\n // returns \"Win32\" on Windows\n // - \"iOS\"\n // - \"WinCE\"\n // - \"Tizen\"\n var devicePlatform = device.platform;\n \n\n### Dziwactwa Windows Phone 7\n\nUrządzenia Windows Phone 7 raport platformy jako`WinCE`.\n\n### Windows Phone 8 dziwactwa\n\nUrządzenia Windows Phone 8 raport platformy jako`Win32NT`.\n\n## device.uuid\n\nSię urządzenia uniwersalnie unikatowy identyfikator ([UUID][3]).\n\n [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier\n\n var string = device.uuid;\n \n\n### Opis\n\nSzczegóły jak UUID jest generowane są określane przez producenta urządzenia i są specyficzne dla platformy lub modelu urządzenia.\n\n### Obsługiwane platformy\n\n* Android\n* BlackBerry 10\n* iOS\n* Tizen\n* Windows Phone 7 i 8\n* Windows 8\n\n### Szybki przykład\n\n / / Android: zwraca losowe 64-bitowa liczba całkowita (jako ciąg, znowu!) / / liczba całkowita jest generowany na pierwszego uruchomienia urządzenia / / / / BlackBerry: zwraca numer PIN urządzenia / / to jest unikatową liczbą całkowitą dziewięciu cyfr (jako ciąg, choć!) / / / / iPhone: (zacytowana w dokumentacji klasy UIDevice) / / zwraca ciąg wartości mieszania utworzone z wielu sprzętu identyfikuje.\n Zapewniona jest unikatowy dla każdego urządzenia i nie może być związane z / do konta użytkownika.\n / / Windows Phone 7: zwraca wartość mieszania urządzenia + bieżący użytkownik, / / jeśli nie zdefiniowane przez użytkownika, identyfikator guid jest generowany i będzie trwać do czasu odinstalowania aplikacji / / Tizen: zwraca urządzenia IMEI (International Mobile Equipment Identity lub IMEI jest liczbą / / unikatowe dla każdego telefonu komórkowego GSM i UMTS.\n var deviceID = device.uuid;\n \n\n### iOS dziwactwo\n\n`uuid`Na iOS nie jest przypisany do urządzenia, ale różni się dla każdej aplikacji, dla każdej instalacji. Zmienia się jeśli możesz usunąć i ponownie zainstalować aplikację, a ewentualnie także po aktualizacji iOS czy nawet uaktualnienia aplikacji dla wersji (widoczny w iOS 5.1). `uuid`Jest nie wiarygodne wartości.\n\n### Windows Phone 7 i 8 dziwactwa\n\n`uuid`Dla Windows Phone 7 wymaga uprawnień `ID_CAP_IDENTITY_DEVICE` . Microsoft będzie prawdopodobnie potępiać ten wkrótce. Jeśli funkcja nie jest dostępna, aplikacja generuje trwałe identyfikator guid, który jest utrzymywany przez czas trwania instalacji aplikacji na urządzeniu.\n\n## device.version\n\nPobierz wersję systemu operacyjnego.\n\n var string = device.version;\n \n\n### Obsługiwane platformy\n\n* Android 2.1 +\n* BlackBerry 10\n* Przeglądarka\n* iOS\n* Tizen\n* Windows Phone 7 i 8\n* Windows 8\n\n### Szybki przykład\n\n // Android: Froyo OS would return \"2.2\"\n // Eclair OS would return \"2.1\", \"2.0.1\", or \"2.0\"\n // Version can also return update level \"2.1-update1\"\n //\n // BlackBerry: Torch 9800 using OS 6.0 would return \"6.0.0.600\"\n //\n // Browser: Returns version number for the browser\n //\n // iPhone: iOS 3.2 returns \"3.2\"\n //\n // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720\n // Tizen: returns \"TIZEN_20120425_2\"\n var deviceVersion = device.version;\n"
},
{
"path": "plugins/cordova-plugin-device/doc/ru/index.md",
"content": "\n\n# cordova-plugin-device\n\nЭтот плагин определяет глобальный объект `device`, который описывает оборудование и программное обеспечение устройства. Несмотря на то что объект в глобальной области видимости, он не доступен до того момента пока не произойдет событие `deviceready`.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(device.cordova);\n }\n \n\n## Установка\n\n cordova plugin add cordova-plugin-device\n \n\n## Параметры\n\n* device.cordova\n* device.model\n* device.platform\n* device.uuid\n* device.version\n\n## device.cordova\n\nВозвращает версию Cordova, работающую на устройстве.\n\n### Поддерживаемые платформы\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* Обозреватель\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 и 8\n* Windows 8\n\n## device.model\n\nСвойство `device.model` возвращает имя устройства модели или продукта. Значение устанавливается производителем устройства и могут отличаться в разных версиях одного и того же продукта.\n\n### Поддерживаемые платформы\n\n* Android\n* BlackBerry 10\n* Обозреватель\n* iOS\n* Tizen\n* Windows Phone 7 и 8\n* Windows 8\n\n### Краткий пример\n\n // Android: Nexus One returns \"Passion\" (Nexus One code name)\n // Motorola Droid returns \"voles\"\n // BlackBerry: Torch 9800 returns \"9800\"\n // Browser: Google Chrome returns \"Chrome\"\n // Safari returns \"Safari\"\n // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. See http://theiphonewiki.com/wiki/index.php?title=Models\n //\n var model = device.model;\n \n\n### Особенности Android\n\n* Возвращает [имя продукта][1] , а не [имя модели][2], которое часто является производственным кодом. Например, Nexus One из них возвращает `Passion` , и Motorola Droid возвращает `voles`.\n\n [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT\n [2]: http://developer.android.com/reference/android/os/Build.html#MODEL\n\n### Особенности Tizen\n\n* Возвращает модель устройства, назначенного вендором, например,`TIZEN`\n\n### Особенности Windows Phone 7 и 8\n\n* Возвращает модель устройства, указанной заводом-изготовителем. Например Samsung Focus возвращает `SGH-i917`.\n\n## device.platform\n\nПолучите имя операционной системы устройства.\n\n var string = device.platform;\n \n\n### Поддерживаемые платформы\n\n* Android\n* BlackBerry 10\n* Браузером4\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 и 8\n* Windows 8\n\n### Краткий пример\n\n // Depending on the device, a few examples are:\n // - \"Android\"\n // - \"BlackBerry 10\"\n // - Browser: returns \"MacIntel\" on Mac\n // returns \"Win32\" on Windows\n // - \"iOS\"\n // - \"WinCE\"\n // - \"Tizen\"\n var devicePlatform = device.platform;\n \n\n### Особенности Windows Phone 7\n\nWindows Phone 7 устройства сообщают платформу как `WinCE`.\n\n### Особенности Windows Phone 8\n\nУстройства Windows Phone 8 сообщают платформу как `Win32NT`.\n\n## device.uuid\n\nВозвращает универсальный уникального идентификатора ([UUID][3] устройства).\n\n [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier\n\n var string = device.uuid;\n \n\n### Описание\n\nПодробная информация о том как UUID генерируется, определяются изготовителем устройства и являются специфическими для платформы или модели устройства.\n\n### Поддерживаемые платформы\n\n* Android\n* BlackBerry 10\n* iOS\n* Tizen\n* Windows Phone 7 и 8\n* Windows 8\n\n### Краткий пример\n\n // Android: Возвращает случайное 64-разрядное целое число (в виде строки, опять!) \n // целое число генерируется при первой загрузке устройства \n //\n // BlackBerry: Возвращает номер PIN устройства \n // это 9 значный уникальный целочисленный (как строка, хотя!) \n // \n // iPhone: (Перефразировано из документации класса UIDevice) \n // возвращает строку хэш-значения, созданные из нескольких аппаратных определяет.\n // Это значение гарантированно является уникальным для каждого устройства и не может быть привязано \n // к учетной записи пользователя.\n // Windows Phone 7: Возвращает хэш устройство + текущего пользователя, \n // если пользователь не определен, формируется guid который и будет сохраняться до тех пор, пока приложение не удалиться \n // Tizen: возвращает IMEI устройства (Международный идентификатор мобильного оборудования или IMEI это число \n // уникальное для каждого мобильного телефона GSM и UMTS.\n var deviceID = device.uuid;\n \n\n### Особенности iOS\n\nНа iOS `uuid` не является уникальным для устройства, но варьируется для каждого приложения, и для каждой установки. Значение меняется, если удалить и повторно установить приложение, и возможно также когда вы обновите iOS, или даже обновить приложение до следующей версии (очевидно в iOS 5.1). Значение `uuid` не является надежным.\n\n### Особенности Windows Phone 7 и 8\n\nДля Windows Phone 7 `uuid` требует разрешения `ID_CAP_IDENTITY_DEVICE` . Microsoft скорее всего скоро сделает это свойство устаревшим. Если возможность недоступна, приложение создает постоянные guid, который сохраняется на все время установки приложения на устройстве.\n\n## device.version\n\nВозвращает версию операционной системы.\n\n var string = device.version;\n \n\n### Поддерживаемые платформы\n\n* Android 2.1 +\n* BlackBerry 10\n* Обозреватель\n* iOS\n* Tizen\n* Windows Phone 7 и 8\n* Windows 8\n\n### Краткий пример\n\n // Android: Froyo OS would return \"2.2\"\n // Eclair OS would return \"2.1\", \"2.0.1\", or \"2.0\"\n // Version can also return update level \"2.1-update1\"\n //\n // BlackBerry: Torch 9800 using OS 6.0 would return \"6.0.0.600\"\n //\n // Browser: Returns version number for the browser\n //\n // iPhone: iOS 3.2 returns \"3.2\"\n //\n // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720\n // Tizen: returns \"TIZEN_20120425_2\"\n var deviceVersion = device.version;\n"
},
{
"path": "plugins/cordova-plugin-device/doc/zh/README.md",
"content": "\n\n# cordova-plugin-device\n\n[](https://travis-ci.org/apache/cordova-plugin-device)\n\n這個外掛程式定義全球 `device` 物件，描述該設備的硬體和軟體。 雖然物件是在全球範圍內，但不是可用，直到後 `deviceready` 事件。\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(device.cordova);\n }\n \n\n## 安裝\n\n cordova plugin add cordova-plugin-device\n \n\n## 屬性\n\n * device.cordova\n * device.model\n * device.platform\n * device.uuid\n * device.version\n\n## device.cordova\n\n獲取科爾多瓦在設備上運行的版本。\n\n### 支援的平臺\n\n * 亞馬遜火 OS\n * Android 系統\n * 黑莓 10\n * 瀏覽器\n * 火狐瀏覽器作業系統\n * iOS\n * Tizen\n * Windows Phone 7 和 8\n * Windows 8\n\n## device.model\n\n`device.model`返回設備的模型或產品的名稱。值由設備製造商設置和同一產品的不同版本可能不同。\n\n### 支援的平臺\n\n * Android 系統\n * 黑莓 10\n * 瀏覽器\n * iOS\n * Tizen\n * Windows Phone 7 和 8\n * Windows 8\n\n### 快速的示例\n\n // Android: Nexus One returns \"Passion\" (Nexus One code name)\n // Motorola Droid returns \"voles\"\n // BlackBerry: Torch 9800 returns \"9800\"\n // Browser: Google Chrome returns \"Chrome\"\n // Safari returns \"Safari\"\n // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. 請參閱 HTTP://theiphonewiki.com/wiki/index.php?title=Models / / var 模型 = device.model ；\n \n\n### Android 的怪癖\n\n * 獲取[產品名稱](http://developer.android.com/reference/android/os/Build.html#PRODUCT)而不是[產品型號名稱](http://developer.android.com/reference/android/os/Build.html#MODEL)，這往往是生產代碼名稱。 例如，Nexus One 返回 `Passion` ，和摩托羅拉 Droid 返回`voles`.\n\n### Tizen 怪癖\n\n * 例如，返回與供應商指派的設備模型`TIZEN`\n\n### Windows Phone 7 和 8 怪癖\n\n * 返回由製造商指定的設備模型。例如，三星焦點返回`SGH-i917`.\n\n## device.platform\n\n獲取設備的作業系統名稱。\n\n var string = device.platform;\n \n\n### 支援的平臺\n\n * Android 系統\n * 黑莓 10\n * Browser4\n * 火狐瀏覽器作業系統\n * iOS\n * Tizen\n * Windows Phone 7 和 8\n * Windows 8\n\n### 快速的示例\n\n // Depending on the device, a few examples are:\n // - \"Android\"\n // - \"BlackBerry 10\"\n // - Browser: returns \"MacIntel\" on Mac\n // returns \"Win32\" on Windows\n // - \"iOS\"\n // - \"WinCE\"\n // - \"Tizen\"\n var devicePlatform = device.platform;\n \n\n### Windows Phone 7 的怪癖\n\nWindows Phone 7 設備報告作為平臺`WinCE`.\n\n### Windows Phone 8 怪癖\n\nWindows Phone 8 設備報告作為平臺`Win32NT`.\n\n## device.uuid\n\n獲取設備的通用唯一識別碼 ([UUID](http://en.wikipedia.org/wiki/Universally_Unique_Identifier)).\n\n var string = device.uuid;\n \n\n### 說明\n\n如何生成一個 UUID 的細節由設備製造商和特定于設備的平臺或模型。\n\n### 支援的平臺\n\n * Android 系統\n * 黑莓 10\n * iOS\n * Tizen\n * Windows Phone 7 和 8\n * Windows 8\n\n### 快速的示例\n\n / / Android： 一個隨機的 64 位整數 （作為字串返回，再次!) / / 上設備的第一次啟動生成的整數 / / / / 黑莓手機： 返回設備的 PIN 號碼 / / 這是九個數字的唯一整數 （作為字串，雖然!) / / / / iPhone： （從 UIDevice 類文檔解釋） / / 返回一個字串的雜湊值創建的多個硬體標識。\n / / 它保證是唯一的每個設備並不能綁 / / 到使用者帳戶。\n / / Windows Phone 7： 返回的雜湊代碼的設備 + 當前使用者，/ / 如果未定義使用者，則一個 guid 生成的並且將會保留直到卸載該應用程式 / / Tizen： 返回設備 IMEI （國際行動裝置身份或 IMEI 是一個數位 / / 獨有的每一個 UMTS 和 GSM 行動電話。\n var deviceID = device.uuid;\n \n\n### iOS 怪癖\n\n`uuid`在 iOS 不是唯一的一種裝置，但對於每個應用程式，為每個安裝而異。 如果您刪除並重新安裝該應用程式，它更改和可能還當你升級 iOS，或甚至升級每個版本 （iOS 5.1 中存在明顯的） 的應用程式。 `uuid`不是一個可靠的值。\n\n### Windows Phone 7 和 8 怪癖\n\n`uuid`為 Windows Phone 7 須經許可 `ID_CAP_IDENTITY_DEVICE` 。 Microsoft 可能會很快棄用此屬性。 如果沒有可用的能力，應用程式將生成設備上應用程式的安裝過程中保持持續的 guid。\n\n## device.version\n\n獲取作業系統版本。\n\n var string = device.version;\n \n\n### 支援的平臺\n\n * Android 2.1 +\n * 黑莓 10\n * 瀏覽器\n * iOS\n * Tizen\n * Windows Phone 7 和 8\n * Windows 8\n\n### 快速的示例\n\n // Android: Froyo OS would return \"2.2\"\n // Eclair OS would return \"2.1\", \"2.0.1\", or \"2.0\"\n // Version can also return update level \"2.1-update1\"\n //\n // BlackBerry: Torch 9800 using OS 6.0 would return \"6.0.0.600\"\n //\n // Browser: Returns version number for the browser\n //\n // iPhone: iOS 3.2 returns \"3.2\"\n //\n // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720\n // Tizen: returns \"TIZEN_20120425_2\"\n var deviceVersion = device.version;"
},
{
"path": "plugins/cordova-plugin-device/doc/zh/index.md",
"content": "\n\n# cordova-plugin-device\n\n這個外掛程式定義全球 `device` 物件，描述該設備的硬體和軟體。 雖然物件是在全球範圍內，但不是可用，直到後 `deviceready` 事件。\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(device.cordova);\n }\n \n\n## 安裝\n\n cordova plugin add cordova-plugin-device\n \n\n## 屬性\n\n* device.cordova\n* device.model\n* device.platform\n* device.uuid\n* device.version\n\n## device.cordova\n\n獲取科爾多瓦在設備上運行的版本。\n\n### 支援的平臺\n\n* 亞馬遜火 OS\n* Android 系統\n* 黑莓 10\n* 瀏覽器\n* 火狐瀏覽器的作業系統\n* iOS\n* 泰\n* Windows Phone 7 和 8\n* Windows 8\n\n## device.model\n\n`device.model`返回設備的模型或產品的名稱。值由設備製造商設置和同一產品的不同版本可能不同。\n\n### 支援的平臺\n\n* Android 系統\n* 黑莓 10\n* 瀏覽器\n* iOS\n* 泰\n* Windows Phone 7 和 8\n* Windows 8\n\n### 快速的示例\n\n // Android: Nexus One returns \"Passion\" (Nexus One code name)\n // Motorola Droid returns \"voles\"\n // BlackBerry: Torch 9800 returns \"9800\"\n // Browser: Google Chrome returns \"Chrome\"\n // Safari returns \"Safari\"\n // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. 請參閱 HTTP://theiphonewiki.com/wiki/index.php?title=Models / / var 模型 = device.model ；\n \n\n### Android 的怪癖\n\n* 獲取[產品名稱][1]而不是[產品型號名稱][2]，這往往是生產代碼名稱。 例如，Nexus One 返回 `Passion` ，和摩托羅拉 Droid 返回`voles`.\n\n [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT\n [2]: http://developer.android.com/reference/android/os/Build.html#MODEL\n\n### Tizen 怪癖\n\n* 例如，返回與供應商指派的設備模型`TIZEN`\n\n### Windows Phone 7 和 8 怪癖\n\n* 返回由製造商指定的設備模型。例如，三星焦點返回`SGH-i917`.\n\n## device.platform\n\n獲取設備的作業系統名稱。\n\n var string = device.platform;\n \n\n### 支援的平臺\n\n* Android 系統\n* 黑莓 10\n* Browser4\n* 火狐瀏覽器的作業系統\n* iOS\n* 泰\n* Windows Phone 7 和 8\n* Windows 8\n\n### 快速的示例\n\n // Depending on the device, a few examples are:\n // - \"Android\"\n // - \"BlackBerry 10\"\n // - Browser: returns \"MacIntel\" on Mac\n // returns \"Win32\" on Windows\n // - \"iOS\"\n // - \"WinCE\"\n // - \"Tizen\"\n var devicePlatform = device.platform;\n \n\n### Windows Phone 7 的怪癖\n\nWindows Phone 7 設備報告作為平臺`WinCE`.\n\n### Windows Phone 8 怪癖\n\nWindows Phone 8 設備報告作為平臺`Win32NT`.\n\n## device.uuid\n\n獲取設備的通用唯一識別碼 ([UUID][3]).\n\n [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier\n\n var string = device.uuid;\n \n\n### 說明\n\n如何生成一個 UUID 的細節由設備製造商和特定于設備的平臺或模型。\n\n### 支援的平臺\n\n* Android 系統\n* 黑莓 10\n* iOS\n* Tizen\n* Windows Phone 7 和 8\n* Windows 8\n\n### 快速的示例\n\n / / Android： 一個隨機的 64 位整數 （作為字串返回，再次!) / / 上設備的第一次啟動生成的整數 / / / / 黑莓手機： 返回設備的 PIN 號碼 / / 這是九個數字的唯一整數 （作為字串，雖然!) / / / / iPhone： （從 UIDevice 類文檔解釋） / / 返回一個字串的雜湊值創建的多個硬體標識。\n / / 它保證是唯一的每個設備並不能綁 / / 到使用者帳戶。\n / / Windows Phone 7： 返回的雜湊代碼的設備 + 當前使用者，/ / 如果未定義使用者，則一個 guid 生成的並且將會保留直到卸載該應用程式 / / Tizen： 返回設備 IMEI （國際行動裝置身份或 IMEI 是一個數位 / / 獨有的每一個 UMTS 和 GSM 行動電話。\n var deviceID = device.uuid;\n \n\n### iOS 怪癖\n\n`uuid`在 iOS 不是唯一的一種裝置，但對於每個應用程式，為每個安裝而異。 如果您刪除並重新安裝該應用程式，它更改和可能還當你升級 iOS，或甚至升級每個版本 （iOS 5.1 中存在明顯的） 的應用程式。 `uuid`不是一個可靠的值。\n\n### Windows Phone 7 和 8 怪癖\n\n`uuid`為 Windows Phone 7 須經許可 `ID_CAP_IDENTITY_DEVICE` 。 Microsoft 可能會很快棄用此屬性。 如果沒有可用的能力，應用程式將生成設備上應用程式的安裝過程中保持持續的 guid。\n\n## device.version\n\n獲取作業系統版本。\n\n var string = device.version;\n \n\n### 支援的平臺\n\n* Android 2.1 +\n* 黑莓 10\n* 瀏覽器\n* iOS\n* 泰\n* Windows Phone 7 和 8\n* Windows 8\n\n### 快速的示例\n\n // Android: Froyo OS would return \"2.2\"\n // Eclair OS would return \"2.1\", \"2.0.1\", or \"2.0\"\n // Version can also return update level \"2.1-update1\"\n //\n // BlackBerry: Torch 9800 using OS 6.0 would return \"6.0.0.600\"\n //\n // Browser: Returns version number for the browser\n //\n // iPhone: iOS 3.2 returns \"3.2\"\n //\n // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720\n // Tizen: returns \"TIZEN_20120425_2\"\n var deviceVersion = device.version;\n"
},
{
"path": "plugins/cordova-plugin-device/package.json",
"content": "{\n \"name\": \"cordova-plugin-device\",\n \"version\": \"1.1.2\",\n \"description\": \"Cordova Device Plugin\",\n \"cordova\": {\n \"id\": \"cordova-plugin-device\",\n \"platforms\": [\n \"firefoxos\",\n \"tizen\",\n \"android\",\n \"amazon-fireos\",\n \"ubuntu\",\n \"ios\",\n \"blackberry10\",\n \"wp7\",\n \"wp8\",\n \"windows8\",\n \"windows\",\n \"browser\",\n \"osx\"\n ]\n },\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/apache/cordova-plugin-device\"\n },\n \"keywords\": [\n \"cordova\",\n \"device\",\n \"ecosystem:cordova\",\n \"cordova-firefoxos\",\n \"cordova-tizen\",\n \"cordova-android\",\n \"cordova-amazon-fireos\",\n \"cordova-ubuntu\",\n \"cordova-ios\",\n \"cordova-blackberry10\",\n \"cordova-wp7\",\n \"cordova-wp8\",\n \"cordova-windows8\",\n \"cordova-windows\",\n \"cordova-browser\",\n \"cordova-osx\"\n ],\n \"scripts\": {\n \"test\": \"npm run jshint\",\n \"jshint\": \"node node_modules/jshint/bin/jshint www && node node_modules/jshint/bin/jshint src && node node_modules/jshint/bin/jshint tests\"\n },\n \"author\": \"Apache Software Foundation\",\n \"license\": \"Apache-2.0\",\n \"devDependencies\": {\n \"jshint\": \"^2.6.0\"\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-device/plugin.xml",
"content": "\n\n\n\n Device\n Cordova Device Plugin\n Apache 2.0\n cordova,device\n https://git-wip-us.apache.org/repos/asf/cordova-plugin-device.git\n https://issues.apache.org/jira/browse/CB/component/12320648\n\n \n \n \n\n \n \n \n \n \n \n \n\n \n \n \n \n\n \n \n \n \n \n \n\n \n \n \n \n \n \n \n\n \n \n\n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n\n \n \n \n\n \n \n \n \n \n \n \n read_device_identifying_information\n \n \n\n \n \n \n \n \n \n \n\n \n \n \n\n \n \n\n \n \n \n \n \n \n \n\n \n \n \n\n \n \n\n \n \n \n \n \n \n\n \n \n \n \n \n \n \n\n \n \n \n \n\n \n \n \n \n \n \n \n\n \n \n \n\n\n\n"
},
{
"path": "plugins/cordova-plugin-device/src/android/Device.java",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n*/\npackage org.apache.cordova.device;\n\nimport java.util.TimeZone;\n\nimport org.apache.cordova.CordovaWebView;\nimport org.apache.cordova.CallbackContext;\nimport org.apache.cordova.CordovaPlugin;\nimport org.apache.cordova.CordovaInterface;\nimport org.json.JSONArray;\nimport org.json.JSONException;\nimport org.json.JSONObject;\n\nimport android.provider.Settings;\n\npublic class Device extends CordovaPlugin {\n public static final String TAG = \"Device\";\n\n public static String platform; // Device OS\n public static String uuid; // Device UUID\n\n private static final String ANDROID_PLATFORM = \"Android\";\n private static final String AMAZON_PLATFORM = \"amazon-fireos\";\n private static final String AMAZON_DEVICE = \"Amazon\";\n\n /**\n * Constructor.\n */\n public Device() {\n }\n\n /**\n * Sets the context of the Command. This can then be used to do things like\n * get file paths associated with the Activity.\n *\n * @param cordova The context of the main Activity.\n * @param webView The CordovaWebView Cordova is running in.\n */\n public void initialize(CordovaInterface cordova, CordovaWebView webView) {\n super.initialize(cordova, webView);\n Device.uuid = getUuid();\n }\n\n /**\n * Executes the request and returns PluginResult.\n *\n * @param action The action to execute.\n * @param args JSONArry of arguments for the plugin.\n * @param callbackContext The callback id used when calling back into JavaScript.\n * @return True if the action was valid, false if not.\n */\n public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException {\n if (\"getDeviceInfo\".equals(action)) {\n JSONObject r = new JSONObject();\n r.put(\"uuid\", Device.uuid);\n r.put(\"version\", this.getOSVersion());\n r.put(\"platform\", this.getPlatform());\n r.put(\"model\", this.getModel());\n r.put(\"manufacturer\", this.getManufacturer());\n\t r.put(\"isVirtual\", this.isVirtual());\n r.put(\"serial\", this.getSerialNumber());\n callbackContext.success(r);\n }\n else {\n return false;\n }\n return true;\n }\n\n //--------------------------------------------------------------------------\n // LOCAL METHODS\n //--------------------------------------------------------------------------\n\n /**\n * Get the OS name.\n *\n * @return\n */\n public String getPlatform() {\n String platform;\n if (isAmazonDevice()) {\n platform = AMAZON_PLATFORM;\n } else {\n platform = ANDROID_PLATFORM;\n }\n return platform;\n }\n\n /**\n * Get the device's Universally Unique Identifier (UUID).\n *\n * @return\n */\n public String getUuid() {\n String uuid = Settings.Secure.getString(this.cordova.getActivity().getContentResolver(), android.provider.Settings.Secure.ANDROID_ID);\n return uuid;\n }\n\n public String getModel() {\n String model = android.os.Build.MODEL;\n return model;\n }\n\n public String getProductName() {\n String productname = android.os.Build.PRODUCT;\n return productname;\n }\n\n public String getManufacturer() {\n String manufacturer = android.os.Build.MANUFACTURER;\n return manufacturer;\n }\n\n public String getSerialNumber() {\n String serial = android.os.Build.SERIAL;\n return serial;\n }\n\n /**\n * Get the OS version.\n *\n * @return\n */\n public String getOSVersion() {\n String osversion = android.os.Build.VERSION.RELEASE;\n return osversion;\n }\n\n public String getSDKVersion() {\n @SuppressWarnings(\"deprecation\")\n String sdkversion = android.os.Build.VERSION.SDK;\n return sdkversion;\n }\n\n public String getTimeZoneID() {\n TimeZone tz = TimeZone.getDefault();\n return (tz.getID());\n }\n\n /**\n * Function to check if the device is manufactured by Amazon\n *\n * @return\n */\n public boolean isAmazonDevice() {\n if (android.os.Build.MANUFACTURER.equals(AMAZON_DEVICE)) {\n return true;\n }\n return false;\n }\n\n public boolean isVirtual() {\n\treturn android.os.Build.FINGERPRINT.contains(\"generic\") ||\n\t android.os.Build.PRODUCT.contains(\"sdk\");\n }\n\n}\n"
},
{
"path": "plugins/cordova-plugin-device/src/blackberry10/index.js",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n*/\n\n/* global PluginResult */\n\nfunction getModelName () {\n var modelName = window.qnx.webplatform.device.modelName;\n //Pre 10.2 (meaning Z10 or Q10)\n if (typeof modelName === \"undefined\") {\n if (window.screen.height === 720 && window.screen.width === 720) {\n if ( window.matchMedia(\"(-blackberry-display-technology: -blackberry-display-oled)\").matches) {\n modelName = \"Q10\";\n } else {\n modelName = \"Q5\";\n }\n } else if ((window.screen.height === 1280 && window.screen.width === 768) ||\n (window.screen.height === 768 && window.screen.width === 1280)) {\n modelName = \"Z10\";\n } else {\n modelName = window.qnx.webplatform.deviceName;\n }\n }\n\n return modelName;\n}\n\nfunction getUUID () {\n var uuid = \"\";\n try {\n //Must surround by try catch because this will throw if the app is missing permissions\n uuid = window.qnx.webplatform.device.devicePin;\n } catch (e) {\n //DO Nothing\n }\n return uuid;\n}\n\nmodule.exports = {\n getDeviceInfo: function (success, fail, args, env) {\n var result = new PluginResult(args, env),\n modelName = getModelName(),\n uuid = getUUID(),\n info = {\n manufacturer: 'BlackBerry',\n platform: \"blackberry10\",\n version: window.qnx.webplatform.device.scmBundle,\n model: modelName,\n uuid: uuid\n };\n\n result.ok(info);\n }\n};\n"
},
{
"path": "plugins/cordova-plugin-device/src/browser/DeviceProxy.js",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n */\nvar browser = require('cordova/platform');\n\nfunction getPlatform() {\n return \"browser\";\n}\n\nfunction getModel() {\n return getBrowserInfo(true);\n}\n\nfunction getVersion() {\n return getBrowserInfo(false);\n}\n\nfunction getBrowserInfo(getModel) {\n var userAgent = navigator.userAgent;\n var returnVal = '';\n var offset;\n\n if ((offset = userAgent.indexOf('Chrome')) !== -1) {\n returnVal = (getModel) ? 'Chrome' : userAgent.substring(offset + 7);\n } else if ((offset = userAgent.indexOf('Safari')) !== -1) {\n if (getModel) {\n returnVal = 'Safari';\n } else {\n returnVal = userAgent.substring(offset + 7);\n\n if ((offset = userAgent.indexOf('Version')) !== -1) {\n returnVal = userAgent.substring(offset + 8);\n }\n }\n } else if ((offset = userAgent.indexOf('Firefox')) !== -1) {\n returnVal = (getModel) ? 'Firefox' : userAgent.substring(offset + 8);\n } else if ((offset = userAgent.indexOf('MSIE')) !== -1) {\n returnVal = (getModel) ? 'MSIE' : userAgent.substring(offset + 5);\n } else if ((offset = userAgent.indexOf('Trident')) !== -1) {\n returnVal = (getModel) ? 'MSIE' : '11';\n }\n\n if ((offset = returnVal.indexOf(';')) !== -1 || (offset = returnVal.indexOf(' ')) !== -1) {\n returnVal = returnVal.substring(0, offset);\n }\n\n return returnVal;\n}\n\n\nmodule.exports = {\n getDeviceInfo: function (success, error) {\n setTimeout(function () {\n success({\n cordova: browser.cordovaVersion,\n platform: getPlatform(),\n model: getModel(),\n version: getVersion(),\n uuid: null\n });\n }, 0);\n }\n};\n\nrequire(\"cordova/exec/proxy\").add(\"Device\", module.exports);\n"
},
{
"path": "plugins/cordova-plugin-device/src/firefoxos/DeviceProxy.js",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n */\n//example UA String for Firefox OS \n//Mozilla/5.0 (Mobile; rv:26.0) Gecko/26.0 Firefox/26.0\n\n//UA parsing not recommended but currently this is the only way to get the Firefox OS version\n//https://developer.mozilla.org/en-US/docs/Gecko_user_agent_string_reference\n\n//Should be replaced when better conversion to Firefox OS Version is available\nfunction convertVersionNumber(ver) {\n var hashVersion = {\n '18.0': '1.0.1',\n '18.1': '1.1',\n '26.0': '1.2',\n '28.0': '1.3',\n '30.0': '1.4',\n '32.0': '2.0'\n };\n var rver = ver;\n var sStr = ver.substring(0, 4);\n if (hashVersion[sStr]) {\n rver = hashVersion[sStr];\n }\n return (rver);\n\n}\nfunction getVersion() {\n if (navigator.userAgent.match(/(mobile|tablet)/i)) {\n var ffVersionArray = (navigator.userAgent.match(/Firefox\\/([\\d]+\\.[\\w]?\\.?[\\w]+)/));\n if (ffVersionArray.length === 2) {\n return (convertVersionNumber(ffVersionArray[1]));\n }\n }\n return (null);\n}\n\nfunction getModel() {\n var uaArray = navigator.userAgent.split(/\\s*[;)(]\\s*/);\n if (navigator.userAgent.match(/(mobile|tablet)/i)) {\n if (uaArray.length === 5) {\n return (uaArray[2]);\n }\n }\n return (null);\n}\nmodule.exports = {\n getDeviceInfo: function (success, error) {\n setTimeout(function () {\n success({\n platform: 'firefoxos',\n model: getModel(),\n version: getVersion(),\n uuid: null\n });\n }, 0);\n }\n};\n\nrequire(\"cordova/exec/proxy\").add(\"Device\", module.exports);\n"
},
{
"path": "plugins/cordova-plugin-device/src/ios/CDVDevice.h",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\n\n#import \n#import \n\n@interface CDVDevice : CDVPlugin\n{}\n\n+ (NSString*)cordovaVersion;\n\n- (void)getDeviceInfo:(CDVInvokedUrlCommand*)command;\n\n@end\n"
},
{
"path": "plugins/cordova-plugin-device/src/ios/CDVDevice.m",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\n\n#include \n#include \n#include \"TargetConditionals.h\"\n\n#import \n#import \"CDVDevice.h\"\n\n@implementation UIDevice (ModelVersion)\n\n- (NSString*)modelVersion\n{\n size_t size;\n\n sysctlbyname(\"hw.machine\", NULL, &size, NULL, 0);\n char* machine = malloc(size);\n sysctlbyname(\"hw.machine\", machine, &size, NULL, 0);\n NSString* platform = [NSString stringWithUTF8String:machine];\n free(machine);\n\n return platform;\n}\n\n@end\n\n@interface CDVDevice () {}\n@end\n\n@implementation CDVDevice\n\n- (NSString*)uniqueAppInstanceIdentifier:(UIDevice*)device\n{\n NSUserDefaults* userDefaults = [NSUserDefaults standardUserDefaults];\n static NSString* UUID_KEY = @\"CDVUUID\";\n \n // Check user defaults first to maintain backwards compaitibility with previous versions\n // which didn't user identifierForVendor\n NSString* app_uuid = [userDefaults stringForKey:UUID_KEY];\n if (app_uuid == nil) {\n if ([device respondsToSelector:@selector(identifierForVendor)]) {\n app_uuid = [[device identifierForVendor] UUIDString];\n } else {\n CFUUIDRef uuid = CFUUIDCreate(NULL);\n app_uuid = (__bridge_transfer NSString *)CFUUIDCreateString(NULL, uuid);\n CFRelease(uuid);\n }\n\n [userDefaults setObject:app_uuid forKey:UUID_KEY];\n [userDefaults synchronize];\n }\n \n return app_uuid;\n}\n\n- (void)getDeviceInfo:(CDVInvokedUrlCommand*)command\n{\n NSDictionary* deviceProperties = [self deviceProperties];\n CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:deviceProperties];\n\n [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];\n}\n\n- (NSDictionary*)deviceProperties\n{\n UIDevice* device = [UIDevice currentDevice];\n\n return @{\n @\"manufacturer\": @\"Apple\",\n @\"model\": [device modelVersion],\n @\"platform\": @\"iOS\",\n @\"version\": [device systemVersion],\n @\"uuid\": [self uniqueAppInstanceIdentifier:device],\n @\"cordova\": [[self class] cordovaVersion],\n @\"isVirtual\": @([self isVirtual])\n };\n}\n\n+ (NSString*)cordovaVersion\n{\n return CDV_VERSION;\n}\n\n- (BOOL)isVirtual\n{\n #if TARGET_OS_SIMULATOR\n return true;\n #elif TARGET_IPHONE_SIMULATOR\n return true;\n #else\n return false;\n #endif\n}\n\n@end\n"
},
{
"path": "plugins/cordova-plugin-device/src/osx/CDVDevice.h",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\n\n#import \n\n@interface CDVDevice : CDVPlugin\n\n+ (NSString*) cordovaVersion;\n\n- (void) getDeviceInfo:(CDVInvokedUrlCommand*)command;\n\n@end\n"
},
{
"path": "plugins/cordova-plugin-device/src/osx/CDVDevice.m",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\n\n#include \n\n#import \"CDVDevice.h\"\n\n#define SYSTEM_VERSION_PLIST @\"/System/Library/CoreServices/SystemVersion.plist\"\n\n@implementation CDVDevice\n\n- (NSString*) modelVersion {\n size_t size;\n\n sysctlbyname(\"hw.machine\", NULL, &size, NULL, 0);\n char* machine = malloc(size);\n sysctlbyname(\"hw.machine\", machine, &size, NULL, 0);\n NSString* modelVersion = [NSString stringWithUTF8String:machine];\n free(machine);\n\n return modelVersion;\n}\n\n\n- (NSString*) getSerialNr {\n NSString* serialNr;\n io_service_t platformExpert = IOServiceGetMatchingService(kIOMasterPortDefault, IOServiceMatching(\"IOPlatformExpertDevice\"));\n if (platformExpert) {\n CFTypeRef serialNumberAsCFString =\n IORegistryEntryCreateCFProperty(platformExpert,\n CFSTR(kIOPlatformSerialNumberKey),\n kCFAllocatorDefault, 0);\n if (serialNumberAsCFString) {\n serialNr = (__bridge NSString*) serialNumberAsCFString;\n }\n IOObjectRelease(platformExpert);\n }\n return serialNr;\n}\n\n- (NSString*) uniqueAppInstanceIdentifier {\n NSUserDefaults* userDefaults = [NSUserDefaults standardUserDefaults];\n static NSString* UUID_KEY = @\"CDVUUID\";\n\n NSString* app_uuid = [userDefaults stringForKey:UUID_KEY];\n\n if (app_uuid == nil) {\n CFUUIDRef uuidRef = CFUUIDCreate(kCFAllocatorDefault);\n CFStringRef uuidString = CFUUIDCreateString(kCFAllocatorDefault, uuidRef);\n\n app_uuid = [NSString stringWithString:(__bridge NSString*) uuidString];\n [userDefaults setObject:app_uuid forKey:UUID_KEY];\n [userDefaults synchronize];\n\n CFRelease(uuidString);\n CFRelease(uuidRef);\n }\n\n return app_uuid;\n}\n\n- (NSString*) platform {\n return [NSDictionary dictionaryWithContentsOfFile:SYSTEM_VERSION_PLIST][@\"ProductName\"];\n}\n\n- (NSString*) systemVersion {\n return [NSDictionary dictionaryWithContentsOfFile:SYSTEM_VERSION_PLIST][@\"ProductVersion\"];\n}\n\n- (void) getDeviceInfo:(CDVInvokedUrlCommand*) command {\n NSDictionary* deviceProperties = [self deviceProperties];\n CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:deviceProperties];\n\n [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];\n}\n\n- (NSDictionary*) deviceProperties {\n NSMutableDictionary* devProps = [NSMutableDictionary dictionaryWithCapacity:4];\n\n devProps[@\"manufacturer\"] = @\"Apple\";\n devProps[@\"model\"] = [self modelVersion];\n devProps[@\"platform\"] = [self platform];\n devProps[@\"version\"] = [self systemVersion];\n devProps[@\"uuid\"] = [self uniqueAppInstanceIdentifier];\n devProps[@\"cordova\"] = [[self class] cordovaVersion];\n devProps[@\"serial\"] = [self getSerialNr];\n devProps[@\"isVirtual\"] = @NO;\n\n NSDictionary* devReturn = [NSDictionary dictionaryWithDictionary:devProps];\n return devReturn;\n}\n\n+ (NSString*) cordovaVersion {\n return CDV_VERSION;\n}\n\n@end\n"
},
{
"path": "plugins/cordova-plugin-device/src/tizen/DeviceProxy.js",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n*/\n\nvar tizen = require('cordova/platform');\n\nmodule.exports = {\n getDeviceInfo: function(success, error) {\n setTimeout(function () {\n success({\n cordova: tizen.cordovaVersion,\n platform: 'tizen',\n model: null,\n version: null,\n uuid: null\n });\n }, 0);\n }\n};\n\nrequire(\"cordova/tizen/commandProxy\").add(\"Device\", module.exports);\n"
},
{
"path": "plugins/cordova-plugin-device/src/ubuntu/device.cpp",
"content": "/*\n * Copyright 2011 Wolfgang Koller - http://www.gofg.at/\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n#include \n#include \n\n#include\"device.h\"\n\n#define CORDOVA \"3.0.0\"\n\nDevice::Device(Cordova *cordova) : CPlugin(cordova) {\n}\n\nstatic QString getOSName() {\n#ifdef Q_OS_SYMBIAN\n QString platform = \"Symbian\";\n#endif\n#ifdef Q_OS_WIN\n QString platform = \"Windows\";\n#endif\n#ifdef Q_OS_WINCE\n QString platform = \"Windows CE\";\n#endif\n#ifdef Q_OS_LINUX\n QString platform = \"Linux\";\n#endif\n return platform;\n}\n\nvoid Device::getInfo(int scId, int ecId) {\n Q_UNUSED(ecId)\n\n QDeviceInfo systemDeviceInfo;\n QDeviceInfo systemInfo;\n\n QString platform = getOSName();\n\n QString uuid = systemDeviceInfo.uniqueDeviceID();\n if (uuid.isEmpty()) {\n QString deviceDescription = systemInfo.imei(0) + \";\" + systemInfo.manufacturer() + \";\" + systemInfo.model() + \";\" + systemInfo.productName() + \";\" + platform;\n QString user = qgetenv(\"USER\");\n if (user.isEmpty()) {\n user = qgetenv(\"USERNAME\");\n if (user.isEmpty())\n user = QDir::homePath();\n }\n uuid = QString(QCryptographicHash::hash((deviceDescription + \";\" + user).toUtf8(), QCryptographicHash::Md5).toHex());\n }\n\n this->cb(scId, systemDeviceInfo.model(), CORDOVA, platform, uuid, systemInfo.version(QDeviceInfo::Os));\n}\n"
},
{
"path": "plugins/cordova-plugin-device/src/ubuntu/device.h",
"content": "/*\n * Copyright 2011 Wolfgang Koller - http://www.gofg.at/\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n#ifndef DEVICE_H_FDSAFAS\n#define DEVICE_H_FDSAFAS\n\n#include \n\n#include \n\nclass Device: public CPlugin {\n Q_OBJECT\npublic:\n explicit Device(Cordova *cordova);\n\n virtual const QString fullName() override {\n return Device::fullID();\n }\n\n virtual const QString shortName() override {\n return \"Device\";\n }\n\n static const QString fullID() {\n return \"com.cordova.Device\";\n }\n\nsignals:\n\npublic slots:\n void getInfo(int scId, int ecId);\n};\n\n#endif\n"
},
{
"path": "plugins/cordova-plugin-device/src/ubuntu/device.js",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n*/\n\n/* global Cordova */\n\nmodule.exports = {\n getInfo:function(win,fail,args) {\n Cordova.exec(function (model, cordova, platform, uuid, version) {\n win({name: name, model: model, cordova: cordova,\n platform: platform, uuid: uuid, version: version});\n }, null, \"com.cordova.Device\", \"getInfo\", []);\n }\n};\n\nrequire(\"cordova/exec/proxy\").add(\"Device\", module.exports);\n"
},
{
"path": "plugins/cordova-plugin-device/src/windows/DeviceProxy.js",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n*/\n\n/* global Windows, createUUID */\n\nvar ROOT_CONTAINER = \"{00000000-0000-0000-FFFF-FFFFFFFFFFFF}\";\nvar DEVICE_CLASS_KEY = \"{A45C254E-DF1C-4EFD-8020-67D146A850E0},10\";\nvar DEVICE_CLASS_KEY_NO_SEMICOLON = \"{A45C254E-DF1C-4EFD-8020-67D146A850E0}10\";\nvar ROOT_CONTAINER_QUERY = \"System.Devices.ContainerId:=\\\"\" + ROOT_CONTAINER + \"\\\"\";\nvar HAL_DEVICE_CLASS = \"4d36e966-e325-11ce-bfc1-08002be10318\";\nvar DEVICE_DRIVER_VERSION_KEY = \"{A8B865DD-2E3D-4094-AD97-E593A70C75D6},3\";\n\nmodule.exports = {\n\n getDeviceInfo:function(win, fail, args) {\n\n // deviceId aka uuid, stored in Windows.Storage.ApplicationData.current.localSettings.values.deviceId\n var deviceId;\n // get deviceId, or create and store one\n var localSettings = Windows.Storage.ApplicationData.current.localSettings;\n if (localSettings.values.deviceId) {\n deviceId = localSettings.values.deviceId;\n }\n else {\n // App-specific hardware id could be used as uuid, but it changes if the hardware changes...\n try {\n var ASHWID = Windows.System.Profile.HardwareIdentification.getPackageSpecificToken(null).id;\n deviceId = Windows.Storage.Streams.DataReader.fromBuffer(ASHWID).readGuid();\n } catch (e) {\n // Couldn't get the hardware UUID\n deviceId = createUUID();\n }\n //...so cache it per-install\n localSettings.values.deviceId = deviceId;\n }\n\n\n var userAgent = window.clientInformation.userAgent;\n // this will report \"windows\" in windows8.1 and windows phone 8.1 apps\n // and \"windows8\" in windows 8.0 apps similar to cordova.js\n // See https://github.com/apache/cordova-js/blob/master/src/windows/platform.js#L25\n var devicePlatform = userAgent.indexOf(\"MSAppHost/1.0\") == -1 ? \"windows\" : \"windows8\";\n var versionString = userAgent.match(/Windows (?:Phone |NT )?([0-9.]+)/)[1];\n\n var deviceInfo = new Windows.Security.ExchangeActiveSyncProvisioning.EasClientDeviceInformation();\n // Running in the Windows Simulator is a remote session.\n // Running in the Windows Phone Emulator has the systemProductName set to \"Virtual\"\n var isVirtual = Windows.System.RemoteDesktop.InteractiveSession.isRemote || deviceInfo.systemProductName == \"Virtual\";\n var manufacturer = deviceInfo.systemManufacturer;\n var model = deviceInfo.systemProductName;\n\n var Pnp = Windows.Devices.Enumeration.Pnp;\n\n Pnp.PnpObject.findAllAsync(Pnp.PnpObjectType.device,\n [DEVICE_DRIVER_VERSION_KEY, DEVICE_CLASS_KEY],\n ROOT_CONTAINER_QUERY)\n .then(function (rootDevices) {\n for (var i = 0; i < rootDevices.length; i++) {\n var rootDevice = rootDevices[i];\n if (!rootDevice.properties) continue;\n if (rootDevice.properties[DEVICE_CLASS_KEY_NO_SEMICOLON] == HAL_DEVICE_CLASS) {\n versionString = rootDevice.properties[DEVICE_DRIVER_VERSION_KEY];\n break;\n }\n }\n\n setTimeout(function () {\n win({ platform: devicePlatform,\n version: versionString,\n uuid: deviceId,\n isVirtual: isVirtual,\n model: model,\n manufacturer:manufacturer});\n }, 0);\n });\n }\n\n}; // exports\n\nrequire(\"cordova/exec/proxy\").add(\"Device\", module.exports);\n"
},
{
"path": "plugins/cordova-plugin-device/src/wp/Device.cs",
"content": "/* \n Licensed under the Apache License, Version 2.0 (the \"License\");\n you may not use this file except in compliance with the License.\n You may obtain a copy of the License at\n \n http://www.apache.org/licenses/LICENSE-2.0\n \n Unless required by applicable law or agreed to in writing, software\n distributed under the License is distributed on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n See the License for the specific language governing permissions and\n limitations under the License.\n*/\n\nusing Microsoft.Phone.Info;\nusing System;\nusing System.IO;\nusing System.IO.IsolatedStorage;\n\nnamespace WPCordovaClassLib.Cordova.Commands\n{\n public class Device : BaseCommand\n {\n public void getDeviceInfo(string notused)\n {\n string res = String.Format(\"\\\"name\\\":\\\"{0}\\\",\\\"platform\\\":\\\"{1}\\\",\\\"uuid\\\":\\\"{2}\\\",\\\"version\\\":\\\"{3}\\\",\\\"model\\\":\\\"{4}\\\",\\\"manufacturer\\\":\\\"{5}\\\",\\\"isVirtual\\\":{6}\",\n DeviceStatus.DeviceName,\n Environment.OSVersion.Platform.ToString(),\n UUID,\n Environment.OSVersion.Version.ToString(),\n DeviceStatus.DeviceName,\n DeviceStatus.DeviceManufacturer,\n IsVirtual ? \"true\" : \"false\");\n DispatchCommandResult(new PluginResult(PluginResult.Status.OK, \"{\" + res + \"}\"));\n }\n\n\n public bool IsVirtual\n {\n get \n {\n return (Microsoft.Devices.Environment.DeviceType == Microsoft.Devices.DeviceType.Emulator);\n }\n }\n\n public string UUID\n {\n get\n {\n object id;\n\n UserExtendedProperties.TryGetValue(\"ANID\", out id);\n if (id != null)\n {\n return id.ToString().Substring(2, 32);\n }\n\n UserExtendedProperties.TryGetValue(\"ANID2\", out id);\n if (id != null)\n {\n return id.ToString();\n }\n\n string returnVal = \"???unknown???\";\n\n using (IsolatedStorageFile appStorage = IsolatedStorageFile.GetUserStoreForApplication())\n {\n try\n {\n IsolatedStorageFileStream fileStream = new IsolatedStorageFileStream(\"DeviceID.txt\", FileMode.Open, FileAccess.Read, appStorage);\n\n using (StreamReader reader = new StreamReader(fileStream))\n {\n returnVal = reader.ReadLine();\n }\n }\n catch (Exception /*ex*/)\n {\n\n }\n }\n\n return returnVal;\n }\n }\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-device/tests/plugin.xml",
"content": "\n\n\n\n Cordova Device Plugin Tests\n Apache 2.0\n\n \n \n\n"
},
{
"path": "plugins/cordova-plugin-device/tests/tests.js",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n*/\n\n/* jshint jasmine: true */\n\nexports.defineAutoTests = function() {\n describe('Device Information (window.device)', function () {\n it(\"should exist\", function() {\n expect(window.device).toBeDefined();\n });\n\n it(\"should contain a platform specification that is a string\", function() {\n expect(window.device.platform).toBeDefined();\n expect((String(window.device.platform)).length > 0).toBe(true);\n });\n\n it(\"should contain a version specification that is a string\", function() {\n expect(window.device.version).toBeDefined();\n expect((String(window.device.version)).length > 0).toBe(true);\n });\n\n it(\"should contain a UUID specification that is a string or a number\", function() {\n expect(window.device.uuid).toBeDefined();\n if (typeof window.device.uuid == 'string' || typeof window.device.uuid == 'object') {\n expect((String(window.device.uuid)).length > 0).toBe(true);\n } else {\n expect(window.device.uuid > 0).toBe(true);\n }\n });\n\n it(\"should contain a cordova specification that is a string\", function() {\n expect(window.device.cordova).toBeDefined();\n expect((String(window.device.cordova)).length > 0).toBe(true);\n });\n\n it(\"should depend on the presence of cordova.version string\", function() {\n expect(window.cordova.version).toBeDefined();\n expect((String(window.cordova.version)).length > 0).toBe(true);\n });\n\n it(\"should contain device.cordova equal to cordova.version\", function() {\n expect(window.device.cordova).toBe(window.cordova.version);\n });\n\n it(\"should contain a model specification that is a string\", function() {\n expect(window.device.model).toBeDefined();\n expect((String(window.device.model)).length > 0).toBe(true);\n });\n\n it(\"should contain a manufacturer property that is a string\", function() {\n expect(window.device.manufacturer).toBeDefined();\n expect((String(window.device.manufacturer)).length > 0).toBe(true);\n });\n\n it(\"should contain an isVirtual property that is a boolean\", function() {\n expect(window.device.isVirtual).toBeDefined();\n expect(typeof window.device.isVirtual).toBe(\"boolean\");\n });\n\n it(\"should contain a serial number specification that is a string\", function() {\n expect(window.device.serial).toBeDefined();\n expect((String(window.device.serial)).length > 0).toBe(true);\n\n });\n\n });\n};\n\nexports.defineManualTests = function(contentEl, createActionButton) {\n var logMessage = function (message, color) {\n var log = document.getElementById('info');\n var logLine = document.createElement('div');\n if (color) {\n logLine.style.color = color;\n }\n logLine.innerHTML = message;\n log.appendChild(logLine);\n };\n\n var clearLog = function () {\n var log = document.getElementById('info');\n log.innerHTML = '';\n };\n\n var device_tests = '
Press Dump Device button to get device information
' +\n '' +\n 'Expected result: Status box will get updated with device info. (i.e. platform, version, uuid, model, etc)';\n\n contentEl.innerHTML = '' + device_tests;\n\n createActionButton('Dump device', function() {\n clearLog();\n logMessage(JSON.stringify(window.device, null, '\\t'));\n }, \"dump_device\");\n};\n"
},
{
"path": "plugins/cordova-plugin-device/www/device.js",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n*/\n\nvar argscheck = require('cordova/argscheck'),\n channel = require('cordova/channel'),\n utils = require('cordova/utils'),\n exec = require('cordova/exec'),\n cordova = require('cordova');\n\nchannel.createSticky('onCordovaInfoReady');\n// Tell cordova channel to wait on the CordovaInfoReady event\nchannel.waitForInitialization('onCordovaInfoReady');\n\n/**\n * This represents the mobile device, and provides properties for inspecting the model, version, UUID of the\n * phone, etc.\n * @constructor\n */\nfunction Device() {\n this.available = false;\n this.platform = null;\n this.version = null;\n this.uuid = null;\n this.cordova = null;\n this.model = null;\n this.manufacturer = null;\n this.isVirtual = null;\n this.serial = null;\n\n var me = this;\n\n channel.onCordovaReady.subscribe(function() {\n me.getInfo(function(info) {\n //ignoring info.cordova returning from native, we should use value from cordova.version defined in cordova.js\n //TODO: CB-5105 native implementations should not return info.cordova\n var buildLabel = cordova.version;\n me.available = true;\n me.platform = info.platform;\n me.version = info.version;\n me.uuid = info.uuid;\n me.cordova = buildLabel;\n me.model = info.model;\n me.isVirtual = info.isVirtual;\n me.manufacturer = info.manufacturer || 'unknown';\n me.serial = info.serial || 'unknown';\n channel.onCordovaInfoReady.fire();\n },function(e) {\n me.available = false;\n utils.alert(\"[ERROR] Error initializing Cordova: \" + e);\n });\n });\n}\n\n/**\n * Get device info\n *\n * @param {Function} successCallback The function to call when the heading data is available\n * @param {Function} errorCallback The function to call when there is an error getting the heading data. (OPTIONAL)\n */\nDevice.prototype.getInfo = function(successCallback, errorCallback) {\n argscheck.checkArgs('fF', 'Device.getInfo', arguments);\n exec(successCallback, errorCallback, \"Device\", \"getDeviceInfo\", []);\n};\n\nmodule.exports = new Device();\n"
},
{
"path": "plugins/cordova-plugin-dialogs/CONTRIBUTING.md",
"content": "\n\n# Contributing to Apache Cordova\n\nAnyone can contribute to Cordova. And we need your contributions.\n\nThere are multiple ways to contribute: report bugs, improve the docs, and\ncontribute code.\n\nFor instructions on this, start with the \n[contribution overview](http://cordova.apache.org/contribute/).\n\nThe details are explained there, but the important items are:\n - Sign and submit an Apache ICLA (Contributor License Agreement).\n - Have a Jira issue open that corresponds to your contribution.\n - Run the tests so your patch doesn't break existing functionality.\n\nWe look forward to your contributions!\n"
},
{
"path": "plugins/cordova-plugin-dialogs/LICENSE",
"content": "\n Apache License\n Version 2.0, January 2004\n http://www.apache.org/licenses/\n\n TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n\n 1. Definitions.\n\n \"License\" shall mean the terms and conditions for use, reproduction,\n and distribution as defined by Sections 1 through 9 of this document.\n\n \"Licensor\" shall mean the copyright owner or entity authorized by\n the copyright owner that is granting the License.\n\n \"Legal Entity\" shall mean the union of the acting entity and all\n other entities that control, are controlled by, or are under common\n control with that entity. For the purposes of this definition,\n \"control\" means (i) the power, direct or indirect, to cause the\n direction or management of such entity, whether by contract or\n otherwise, or (ii) ownership of fifty percent (50%) or more of the\n outstanding shares, or (iii) beneficial ownership of such entity.\n\n \"You\" (or \"Your\") shall mean an individual or Legal Entity\n exercising permissions granted by this License.\n\n \"Source\" form shall mean the preferred form for making modifications,\n including but not limited to software source code, documentation\n source, and configuration files.\n\n \"Object\" form shall mean any form resulting from mechanical\n transformation or translation of a Source form, including but\n not limited to compiled object code, generated documentation,\n and conversions to other media types.\n\n \"Work\" shall mean the work of authorship, whether in Source or\n Object form, made available under the License, as indicated by a\n copyright notice that is included in or attached to the work\n (an example is provided in the Appendix below).\n\n \"Derivative Works\" shall mean any work, whether in Source or Object\n form, that is based on (or derived from) the Work and for which the\n editorial revisions, annotations, elaborations, or other modifications\n represent, as a whole, an original work of authorship. For the purposes\n of this License, Derivative Works shall not include works that remain\n separable from, or merely link (or bind by name) to the interfaces of,\n the Work and Derivative Works thereof.\n\n \"Contribution\" shall mean any work of authorship, including\n the original version of the Work and any modifications or additions\n to that Work or Derivative Works thereof, that is intentionally\n submitted to Licensor for inclusion in the Work by the copyright owner\n or by an individual or Legal Entity authorized to submit on behalf of\n the copyright owner. For the purposes of this definition, \"submitted\"\n means any form of electronic, verbal, or written communication sent\n to the Licensor or its representatives, including but not limited to\n communication on electronic mailing lists, source code control systems,\n and issue tracking systems that are managed by, or on behalf of, the\n Licensor for the purpose of discussing and improving the Work, but\n excluding communication that is conspicuously marked or otherwise\n designated in writing by the copyright owner as \"Not a Contribution.\"\n\n \"Contributor\" shall mean Licensor and any individual or Legal Entity\n on behalf of whom a Contribution has been received by Licensor and\n subsequently incorporated within the Work.\n\n 2. Grant of Copyright License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n copyright license to reproduce, prepare Derivative Works of,\n publicly display, publicly perform, sublicense, and distribute the\n Work and such Derivative Works in Source or Object form.\n\n 3. Grant of Patent License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n (except as stated in this section) patent license to make, have made,\n use, offer to sell, sell, import, and otherwise transfer the Work,\n where such license applies only to those patent claims licensable\n by such Contributor that are necessarily infringed by their\n Contribution(s) alone or by combination of their Contribution(s)\n with the Work to which such Contribution(s) was submitted. If You\n institute patent litigation against any entity (including a\n cross-claim or counterclaim in a lawsuit) alleging that the Work\n or a Contribution incorporated within the Work constitutes direct\n or contributory patent infringement, then any patent licenses\n granted to You under this License for that Work shall terminate\n as of the date such litigation is filed.\n\n 4. Redistribution. You may reproduce and distribute copies of the\n Work or Derivative Works thereof in any medium, with or without\n modifications, and in Source or Object form, provided that You\n meet the following conditions:\n\n (a) You must give any other recipients of the Work or\n Derivative Works a copy of this License; and\n\n (b) You must cause any modified files to carry prominent notices\n stating that You changed the files; and\n\n (c) You must retain, in the Source form of any Derivative Works\n that You distribute, all copyright, patent, trademark, and\n attribution notices from the Source form of the Work,\n excluding those notices that do not pertain to any part of\n the Derivative Works; and\n\n (d) If the Work includes a \"NOTICE\" text file as part of its\n distribution, then any Derivative Works that You distribute must\n include a readable copy of the attribution notices contained\n within such NOTICE file, excluding those notices that do not\n pertain to any part of the Derivative Works, in at least one\n of the following places: within a NOTICE text file distributed\n as part of the Derivative Works; within the Source form or\n documentation, if provided along with the Derivative Works; or,\n within a display generated by the Derivative Works, if and\n wherever such third-party notices normally appear. The contents\n of the NOTICE file are for informational purposes only and\n do not modify the License. You may add Your own attribution\n notices within Derivative Works that You distribute, alongside\n or as an addendum to the NOTICE text from the Work, provided\n that such additional attribution notices cannot be construed\n as modifying the License.\n\n You may add Your own copyright statement to Your modifications and\n may provide additional or different license terms and conditions\n for use, reproduction, or distribution of Your modifications, or\n for any such Derivative Works as a whole, provided Your use,\n reproduction, and distribution of the Work otherwise complies with\n the conditions stated in this License.\n\n 5. Submission of Contributions. Unless You explicitly state otherwise,\n any Contribution intentionally submitted for inclusion in the Work\n by You to the Licensor shall be under the terms and conditions of\n this License, without any additional terms or conditions.\n Notwithstanding the above, nothing herein shall supersede or modify\n the terms of any separate license agreement you may have executed\n with Licensor regarding such Contributions.\n\n 6. Trademarks. This License does not grant permission to use the trade\n names, trademarks, service marks, or product names of the Licensor,\n except as required for reasonable and customary use in describing the\n origin of the Work and reproducing the content of the NOTICE file.\n\n 7. Disclaimer of Warranty. Unless required by applicable law or\n agreed to in writing, Licensor provides the Work (and each\n Contributor provides its Contributions) on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n implied, including, without limitation, any warranties or conditions\n of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A\n PARTICULAR PURPOSE. You are solely responsible for determining the\n appropriateness of using or redistributing the Work and assume any\n risks associated with Your exercise of permissions under this License.\n\n 8. Limitation of Liability. In no event and under no legal theory,\n whether in tort (including negligence), contract, or otherwise,\n unless required by applicable law (such as deliberate and grossly\n negligent acts) or agreed to in writing, shall any Contributor be\n liable to You for damages, including any direct, indirect, special,\n incidental, or consequential damages of any character arising as a\n result of this License or out of the use or inability to use the\n Work (including but not limited to damages for loss of goodwill,\n work stoppage, computer failure or malfunction, or any and all\n other commercial damages or losses), even if such Contributor\n has been advised of the possibility of such damages.\n\n 9. Accepting Warranty or Additional Liability. While redistributing\n the Work or Derivative Works thereof, You may choose to offer,\n and charge a fee for, acceptance of support, warranty, indemnity,\n or other liability obligations and/or rights consistent with this\n License. However, in accepting such obligations, You may act only\n on Your own behalf and on Your sole responsibility, not on behalf\n of any other Contributor, and only if You agree to indemnify,\n defend, and hold each Contributor harmless for any liability\n incurred by, or claims asserted against, such Contributor by reason\n of your accepting any such warranty or additional liability.\n\n END OF TERMS AND CONDITIONS\n\n APPENDIX: How to apply the Apache License to your work.\n\n To apply the Apache License to your work, attach the following\n boilerplate notice, with the fields enclosed by brackets \"[]\"\n replaced with your own identifying information. (Don't include\n the brackets!) The text should be enclosed in the appropriate\n comment syntax for the file format. We also recommend that a\n file or class name and description of purpose be included on the\n same \"printed page\" as the copyright notice for easier\n identification within third-party archives.\n\n Copyright [yyyy] [name of copyright owner]\n\n Licensed under the Apache License, Version 2.0 (the \"License\");\n you may not use this file except in compliance with the License.\n You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing, software\n distributed under the License is distributed on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n See the License for the specific language governing permissions and\n limitations under the License."
},
{
"path": "plugins/cordova-plugin-dialogs/NOTICE",
"content": "Apache Cordova\nCopyright 2012 The Apache Software Foundation\n\nThis product includes software developed at\nThe Apache Software Foundation (http://www.apache.org/).\n"
},
{
"path": "plugins/cordova-plugin-dialogs/README.md",
"content": "\n\n[](https://travis-ci.org/apache/cordova-plugin-dialogs)\n\n# cordova-plugin-dialogs\n\nThis plugin provides access to some native dialog UI elements\nvia a global `navigator.notification` object.\n\nAlthough the object is attached to the global scoped `navigator`, it is not available until after the `deviceready` event.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(navigator.notification);\n }\n\nReport issues on the [Apache Cordova issue tracker](https://issues.apache.org/jira/issues/?jql=project%20%3D%20CB%20AND%20status%20in%20%28Open%2C%20%22In%20Progress%22%2C%20Reopened%29%20AND%20resolution%20%3D%20Unresolved%20AND%20component%20%3D%20%22Plugin%20Dialogs%22%20ORDER%20BY%20priority%20DESC%2C%20summary%20ASC%2C%20updatedDate%20DESC)\n\n## Installation\n\n cordova plugin add cordova-plugin-dialogs\n\n## Methods\n\n- `navigator.notification.alert`\n- `navigator.notification.confirm`\n- `navigator.notification.prompt`\n- `navigator.notification.beep`\n\n## navigator.notification.alert\n\nShows a custom alert or dialog box. Most Cordova implementations use a native\ndialog box for this feature, but some platforms use the browser's `alert`\nfunction, which is typically less customizable.\n\n navigator.notification.alert(message, alertCallback, [title], [buttonName])\n\n- __message__: Dialog message. _(String)_\n\n- __alertCallback__: Callback to invoke when alert dialog is dismissed. _(Function)_\n\n- __title__: Dialog title. _(String)_ (Optional, defaults to `Alert`)\n\n- __buttonName__: Button name. _(String)_ (Optional, defaults to `OK`)\n\n\n### Example\n\n function alertDismissed() {\n // do something\n }\n\n navigator.notification.alert(\n 'You are the winner!', // message\n alertDismissed, // callback\n 'Game Over', // title\n 'Done' // buttonName\n );\n\n### Supported Platforms\n\n- Amazon Fire OS\n- Android\n- BlackBerry 10\n- Firefox OS\n- iOS\n- Tizen\n- Windows Phone 7 and 8\n- Windows 8\n- Windows\n\n### Windows Phone 7 and 8 Quirks\n\n- There is no built-in browser alert, but you can bind one as follows to call `alert()` in the global scope:\n\n window.alert = navigator.notification.alert;\n\n- Both `alert` and `confirm` are non-blocking calls, results of which are only available asynchronously.\n\n### Firefox OS Quirks:\n\nBoth native-blocking `window.alert()` and non-blocking `navigator.notification.alert()` are available.\n\n### BlackBerry 10 Quirks\n`navigator.notification.alert('text', callback, 'title', 'text')` callback parameter is passed the number 1.\n\n## navigator.notification.confirm\n\nDisplays a customizable confirmation dialog box.\n\n navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])\n\n- __message__: Dialog message. _(String)_\n\n- __confirmCallback__: Callback to invoke with index of button pressed (1, 2, or 3) or when the dialog is dismissed without a button press (0). _(Function)_\n\n- __title__: Dialog title. _(String)_ (Optional, defaults to `Confirm`)\n\n- __buttonLabels__: Array of strings specifying button labels. _(Array)_ (Optional, defaults to [`OK,Cancel`])\n\n\n### confirmCallback\n\nThe `confirmCallback` executes when the user presses one of the\nbuttons in the confirmation dialog box.\n\nThe callback takes the argument `buttonIndex` _(Number)_, which is the\nindex of the pressed button. Note that the index uses one-based\nindexing, so the value is `1`, `2`, `3`, etc.\n\n### Example\n\n function onConfirm(buttonIndex) {\n alert('You selected button ' + buttonIndex);\n }\n\n navigator.notification.confirm(\n 'You are the winner!', // message\n onConfirm, // callback to invoke with index of button pressed\n 'Game Over', // title\n ['Restart','Exit'] // buttonLabels\n );\n\n### Supported Platforms\n\n- Amazon Fire OS\n- Android\n- BlackBerry 10\n- Firefox OS\n- iOS\n- Tizen\n- Windows Phone 7 and 8\n- Windows 8\n- Windows\n\n### Windows Phone 7 and 8 Quirks\n\n- There is no built-in browser function for `window.confirm`, but you can bind it by assigning:\n\n window.confirm = navigator.notification.confirm;\n\n- Calls to `alert` and `confirm` are non-blocking, so the result is only available asynchronously.\n\n### Windows Quirks\n\n- On Windows8/8.1 it is not possible to add more than three buttons to MessageDialog instance.\n\n- On Windows Phone 8.1 it's not possible to show dialog with more than two buttons.\n\n### Firefox OS Quirks:\n\nBoth native-blocking `window.confirm()` and non-blocking `navigator.notification.confirm()` are available.\n\n## navigator.notification.prompt\n\nDisplays a native dialog box that is more customizable than the browser's `prompt` function.\n\n navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])\n\n- __message__: Dialog message. _(String)_\n\n- __promptCallback__: Callback to invoke with index of button pressed (1, 2, or 3) or when the dialog is dismissed without a button press (0). _(Function)_\n\n- __title__: Dialog title _(String)_ (Optional, defaults to `Prompt`)\n\n- __buttonLabels__: Array of strings specifying button labels _(Array)_ (Optional, defaults to `[\"OK\",\"Cancel\"]`)\n\n- __defaultText__: Default textbox input value (`String`) (Optional, Default: empty string)\n\n### promptCallback\n\nThe `promptCallback` executes when the user presses one of the buttons\nin the prompt dialog box. The `results` object passed to the callback\ncontains the following properties:\n\n- __buttonIndex__: The index of the pressed button. _(Number)_ Note that the index uses one-based indexing, so the value is `1`, `2`, `3`, etc.\n\n\n\n- __input1__: The text entered in the prompt dialog box. _(String)_\n\n### Example\n\n function onPrompt(results) {\n alert(\"You selected button number \" + results.buttonIndex + \" and entered \" + results.input1);\n }\n\n navigator.notification.prompt(\n 'Please enter your name', // message\n onPrompt, // callback to invoke\n 'Registration', // title\n ['Ok','Exit'], // buttonLabels\n 'Jane Doe' // defaultText\n );\n\n### Supported Platforms\n\n- Amazon Fire OS\n- Android\n- Firefox OS\n- iOS\n- Windows Phone 7 and 8\n- Windows 8\n- Windows\n\n### Android Quirks\n\n- Android supports a maximum of three buttons, and ignores any more than that.\n\n- On Android 3.0 and later, buttons are displayed in reverse order for devices that use the Holo theme.\n\n### Windows Quirks\n\n- On Windows prompt dialog is html-based due to lack of such native api.\n\n### Firefox OS Quirks:\n\nBoth native-blocking `window.prompt()` and non-blocking `navigator.notification.prompt()` are available.\n\n## navigator.notification.beep\n\nThe device plays a beep sound.\n\n navigator.notification.beep(times);\n\n- __times__: The number of times to repeat the beep. _(Number)_\n\n### Example\n\n // Beep twice!\n navigator.notification.beep(2);\n\n### Supported Platforms\n\n- Amazon Fire OS\n- Android\n- BlackBerry 10\n- iOS\n- Tizen\n- Windows Phone 7 and 8\n- Windows 8\n\n### Amazon Fire OS Quirks\n\n- Amazon Fire OS plays the default __Notification Sound__ specified under the __Settings/Display & Sound__ panel.\n\n### Android Quirks\n\n- Android plays the default __Notification ringtone__ specified under the __Settings/Sound & Display__ panel.\n\n### Windows Phone 7 and 8 Quirks\n\n- Relies on a generic beep file from the Cordova distribution.\n\n### Tizen Quirks\n\n- Tizen implements beeps by playing an audio file via the media API.\n\n- The beep file must be short, must be located in a `sounds` subdirectory of the application's root directory, and must be named `beep.wav`.\n"
},
{
"path": "plugins/cordova-plugin-dialogs/RELEASENOTES.md",
"content": "\n# Release Notes\n\n### 1.2.1 (Apr 15, 2016)\n* CB-10097 dialog doesn't show on **iOS** when called from a select list `onChange` event\n* Remove `warning` emoji, as it doesn't correctly display in the docs website: http://cordova.apache.org/docs/en/dev/cordova-plugin-dialogs/index.html\n* CB-10727 Dialogs plugin has warnings on **iOS**\n* CB-10636 Add `JSHint` for plugins\n\n### 1.2.0 (Nov 18, 2015)\n* [CB-10035](https://issues.apache.org/jira/browse/CB-10035) Updated `RELEASENOTES` to be newest to oldest\n* [CB-8549](https://issues.apache.org/jira/browse/CB-8549) Updated source to pass `Fortify` scan.\n* Fixing contribute link.\n* add `CSS class` to prompt `div` for **Windows** platform\n* [CB-9347](https://issues.apache.org/jira/browse/CB-9347) - fix to allow to stack multiple `UIAlertControllers`\n\n### 1.1.1 (Jun 17, 2015)\n* [CB-9128](https://issues.apache.org/jira/browse/CB-9128) cordova-plugin-dialogs documentation translation: cordova-plugin-dialogs\n* fix npm md\n\n### 1.1.0 (May 06, 2015)\n* [CB-8928](https://issues.apache.org/jira/browse/CB-8928): Removed direct call to `toStaticHTML`, only call it if we are sure it's present. This closes #52\n* [CB-7734](https://issues.apache.org/jira/browse/CB-7734) - `navigator.notification.alert` or `navigator.notification.confirm` seem have a \"many words\" issue. (closes #39)\n \n### 1.0.0 (Apr 15, 2015)\n* [CB-8746](https://issues.apache.org/jira/browse/CB-8746) gave plugin major version bump\n* [CB-8683](https://issues.apache.org/jira/browse/CB-8683) updated wp and bb specific references of old id to new id\n* [CB-8683](https://issues.apache.org/jira/browse/CB-8683) changed plugin-id to pacakge-name\n* [CB-8653](https://issues.apache.org/jira/browse/CB-8653) properly updated translated docs to use new id\n* [CB-8653](https://issues.apache.org/jira/browse/CB-8653) updated translated docs to use new id\n* Use TRAVIS_BUILD_DIR, install paramedic by npm\n* [CB-8653](https://issues.apache.org/jira/browse/CB-8653) Updated Readme\n* [CB-8659](https://issues.apache.org/jira/browse/CB-8659): ios: 4.0.x Compatibility: Remove use of deprecated headers\n* [CB-8565](https://issues.apache.org/jira/browse/CB-8565) Integrate TravisCI\n* [CB-8438](https://issues.apache.org/jira/browse/CB-8438) cordova-plugin-dialogs documentation translation: cordova-plugin-dialogs\n* [CB-8538](https://issues.apache.org/jira/browse/CB-8538) Added package.json file\n* [CB-8367](https://issues.apache.org/jira/browse/CB-8367) [org.apache.cordova.dialogs] Add Prompt support on Windows\n\n### 0.3.0 (Feb 04, 2015)\n* Correct way to specify Windows platform in config.xml\n* [CB-8351](https://issues.apache.org/jira/browse/CB-8351) ios: Use argumentForIndex rather than NSArray extension\n* [CB-7955](https://issues.apache.org/jira/browse/CB-7955) Add support \"browser\" platform\n\n### 0.2.11 (Dec 02, 2014)\n* [CB-7737](https://issues.apache.org/jira/browse/CB-7737) lower min height for alert\n* [CB-8038](https://issues.apache.org/jira/browse/CB-8038) backslash getting escaped twice in **BB10**\n* [CB-8029](https://issues.apache.org/jira/browse/CB-8029) test 1-based indexing for confirm\n* [CB-7639](https://issues.apache.org/jira/browse/CB-7639) Update docs + manual tests\n* [CB-7639](https://issues.apache.org/jira/browse/CB-7639) Revert back `isAlertShowing` flag in case of exception to prevent queuing of future dialogs.\n* [CB-7639](https://issues.apache.org/jira/browse/CB-7639) Handle button labels as array on windows\n* [CB-7977](https://issues.apache.org/jira/browse/CB-7977) Mention `deviceready` in plugin docs\n* Check for `setTextDirection` API level\n* **Android** Make spinner dialog to use `THEME_DEVICE_DEFAULT_LIGHT` (same as the other dialogs)\n* **Android** Unbreak `API` level < `14`\n* [CB-7414](https://issues.apache.org/jira/browse/CB-7414) **BB10** Document callback parameter for `navigator.notification.alert`\n* [CB-7700](https://issues.apache.org/jira/browse/CB-7700) cordova-plugin-dialogs documentation translation: cordova-plugin-dialogs\n* [CB-7571](https://issues.apache.org/jira/browse/CB-7571) Bump version of nested plugin to match parent plugin\n\n### 0.2.10 (Sep 17, 2014)\n* [CB-7538](https://issues.apache.org/jira/browse/CB-7538) Android beep thread fix Beep now executes in it's own thread. It was previously executing in the main UI thread which was causing the application to lock up will the beep was occurring. Closing pull request\n* Set dialog text dir to locale\n* Renamed test dir, added nested plugin.xml\n* added documentation for manual tests\n* [CB-6965](https://issues.apache.org/jira/browse/CB-6965) Added manual tests\n* [CB-6965](https://issues.apache.org/jira/browse/CB-6965) Port notification tests to test-framework\n\n### 0.2.9 (Aug 06, 2014)\n* ubuntu: pass proper arguments to prompt callback\n* ubuntu: use TextField instead of TextInput\n* ubuntu: proper message escaping before passing to qml\n* **FFOS** update notification.js\n* [CB-6127](https://issues.apache.org/jira/browse/CB-6127) Updated translations for docs\n* android: Explicitly apply default theme to dialogs\n* Fix Beep exception on Android when no argument passed\n\n### 0.2.8 (Jun 05, 2014)\n* [CB-6801](https://issues.apache.org/jira/browse/CB-6801) Add license\n* running original windows.open, inAppBrowser is overriding it no need to place CSS in every page anymore\n* [CB-5945](https://issues.apache.org/jira/browse/CB-5945) [Windows8] do not call success callbacks until dialog is dismissed\n* [CB-4616](https://issues.apache.org/jira/browse/CB-4616) Returned index 0 was not documented for notification.prompt\n* update docs to state that prompt is supported on windowsphone\n* [CB-6528](https://issues.apache.org/jira/browse/CB-6528) allow scroll on alert message content\n* [CB-6628][amazon-fireos]dialogs plugin's confirm and prompt methods dont work confirm() method was missing amazon-fireos platform check. added that. prompt() method had bug. It is executed in a worker thread that does not have a message queue(or Looper object) associated with it and hence \"can't create a handler\" exception is thrown. To fix this issue, we need to create the EditText widget from within the UI thread. This was fixed sometime ago when we added fireos platform but commit got lost somewhere. So fixing it again now.\n* [CB-6491](https://issues.apache.org/jira/browse/CB-6491) add CONTRIBUTING.md\n* Added check for isFinishing() on the parent activity to prevent crashes when trying to display dialogs when activity is in this phase of it's lifecycle\n* [CB-4966](https://issues.apache.org/jira/browse/CB-4966) Dialogs are in window now No need to add anything to manifest or index.html\n* Removing FirefoxOS Quirks * no need to add special permission (it's different API with the same name) * notification.css is added automatically\n\n### 0.2.7 (Apr 17, 2014)\n* [CB-6212](https://issues.apache.org/jira/browse/CB-6212): [iOS] fix warnings compiled under arm64 64-bit\n* [CB-6411](https://issues.apache.org/jira/browse/CB-6411): [BlackBerry10] Work around Audio playback issue\n* [CB-6411](https://issues.apache.org/jira/browse/CB-6411): [BlackBerry10] Updates to beep\n* [CB-6422](https://issues.apache.org/jira/browse/CB-6422): [windows8] use cordova/exec/proxy\n* [CB-6460](https://issues.apache.org/jira/browse/CB-6460): Update license headers\n* Add NOTICE file\n\n### 0.2.6 (Feb 05, 2014)\n* no need to recreate the manifest.webapp file after each `cordova prepare` for FFOS\n* FFOS description added\n\n### 0.2.5 (Jan 02, 2014)\n* [CB-4696](https://issues.apache.org/jira/browse/CB-4696) Fix compile error for Xcode 4.5.\n* [CB-5658](https://issues.apache.org/jira/browse/CB-5658) Add doc/index.md for Dialogs plugin\n* [CB-3762](https://issues.apache.org/jira/browse/CB-3762) Change prompt default to empty string\n* Move images from css to img\n\n### 0.2.4 (Dec 4, 2013)\n* add ubuntu platform\n* 1. Added amazon-fireos platform. 2. Change to use amazon-fireos as a platform if user agent string contains 'cordova-amazon-fireos'.\n* added beep funtionality using ms-winsoundevent:Notfication.Default\n\n### 0.2.3 (Oct 28, 2013)\n* [CB-5128](https://issues.apache.org/jira/browse/CB-5128): added repo + issue tag to plugin.xml for dialogs plugin\n* new plugin execute arguments supported\n* new plugin style\n* smaller fonts styling input\n* img files copied inside plugin\n* style added\n* prompt added\n* styling from James\n* fixed \"exec\" calls addedd css, but not working yet\n* first (blind) try\n* [CB-4915](https://issues.apache.org/jira/browse/CB-4915) Incremented plugin version on dev branch.\n\n### 0.2.2 (Sept 25, 2013)\n* [CB-4889](https://issues.apache.org/jira/browse/CB-4889) bumping&resetting version\n* [windows8] commandProxy was moved\n* [CB-4889](https://issues.apache.org/jira/browse/CB-4889) renaming reference in Notification.cs\n* [CB-4889](https://issues.apache.org/jira/browse/CB-4889) renaming org.apache.cordova.core.dialogs to org.apache.cordova.dialogs\n* Rename CHANGELOG.md -> RELEASENOTES.md\n* [CB-4592](https://issues.apache.org/jira/browse/CB-4592) [Blackberry10] Added beep support\n* [CB-4752](https://issues.apache.org/jira/browse/CB-4752) Incremented plugin version on dev branch.\n"
},
{
"path": "plugins/cordova-plugin-dialogs/doc/de/README.md",
"content": "\n\n# cordova-plugin-dialogs\n\n[](https://travis-ci.org/apache/cordova-plugin-dialogs)\n\nDieses Plugin ermöglicht den Zugriff auf einige native Dialog-UI-Elemente über eine globale `navigator.notification`-Objekt.\n\nObwohl das Objekt mit der globalen Gültigkeitsbereich `navigator` verbunden ist, steht es nicht bis nach dem `Deviceready`-Ereignis.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(navigator.notification);\n }\n \n\n## Installation\n\n cordova plugin add cordova-plugin-dialogs\n \n\n## Methoden\n\n * `navigator.notification.alert`\n * `navigator.notification.confirm`\n * `navigator.notification.prompt`\n * `navigator.notification.beep`\n\n## navigator.notification.alert\n\nZeigt eine benutzerdefinierte Warnung oder Dialogfeld Feld. Die meisten Implementierungen von Cordova ein native Dialogfeld für dieses Feature verwenden, jedoch einige Plattformen des Browsers-`alert`-Funktion, die in der Regel weniger anpassbar ist.\n\n navigator.notification.alert(message, alertCallback, [title], [buttonName])\n \n\n * **Nachricht**: Dialogfeld Nachricht. *(String)*\n\n * **AlertCallback**: Callback aufgerufen wird, wenn Warnungs-Dialogfeld geschlossen wird. *(Funktion)*\n\n * **Titel**: Dialog \"Titel\". *(String)* (Optional, Standard ist`Alert`)\n\n * **ButtonName**: Name der Schaltfläche. *(String)* (Optional, Standard ist`OK`)\n\n### Beispiel\n\n function alertDismissed() {\n // do something\n }\n \n navigator.notification.alert(\n 'You are the winner!', // message\n alertDismissed, // callback\n 'Game Over', // title\n 'Done' // buttonName\n );\n \n\n### Unterstützte Plattformen\n\n * Amazon Fire OS\n * Android\n * BlackBerry 10\n * Firefox OS\n * iOS\n * Tizen\n * Windows Phone 7 und 8\n * Windows 8\n * Windows\n\n### Windows Phone 7 und 8 Eigenarten\n\n * Es gibt keine eingebaute Datenbanksuchroutine-Warnung, aber Sie können binden, wie folgt zu nennen `alert()` im globalen Gültigkeitsbereich:\n \n window.alert = navigator.notification.alert;\n \n\n * Beide `alert` und `confirm` sind nicht blockierende Aufrufe, die Ergebnisse davon nur asynchron sind.\n\n### Firefox OS Macken:\n\nNative blockierenden `window.alert()` und nicht-blockierende `navigator.notification.alert()` zur Verfügung.\n\n### BlackBerry 10 Macken\n\n`navigator.notification.alert ('Text', Rückruf, 'Titel', 'Text')` Callback-Parameter wird die Zahl 1 übergeben.\n\n## navigator.notification.confirm\n\nZeigt das Dialogfeld anpassbare Bestätigung.\n\n navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])\n \n\n * **Nachricht**: Dialogfeld Nachricht. *(String)*\n\n * **ConfirmCallback**: Callback aufgerufen wird, mit Index gedrückt (1, 2 oder 3) oder wenn das Dialogfeld geschlossen wird, ohne einen Tastendruck (0). *(Funktion)*\n\n * **Titel**: Dialog \"Titel\". *(String)* (Optional, Standard ist`Confirm`)\n\n * **ButtonLabels**: Array von Zeichenfolgen, die Schaltflächenbezeichnungen angeben. *(Array)* (Optional, Standard ist [ `OK,Cancel` ])\n\n### confirmCallback\n\nDie `confirmCallback` wird ausgeführt, wenn der Benutzer eine der Schaltflächen im Dialogfeld zur Bestätigung drückt.\n\nDer Rückruf dauert das Argument `buttonIndex` *(Anzahl)*, die der Index der Schaltfläche gedrückt ist. Beachten Sie, dass der Index 1-basierte Indizierung, sodass der Wert `1`, `2`, `3` usw. ist.\n\n### Beispiel\n\n function onConfirm(buttonIndex) {\n alert('You selected button ' + buttonIndex);\n }\n \n navigator.notification.confirm(\n 'You are the winner!', // message\n onConfirm, // callback to invoke with index of button pressed\n 'Game Over', // title\n ['Restart','Exit'] // buttonLabels\n );\n \n\n### Unterstützte Plattformen\n\n * Amazon Fire OS\n * Android\n * BlackBerry 10\n * Firefox OS\n * iOS\n * Tizen\n * Windows Phone 7 und 8\n * Windows 8\n * Windows\n\n### Windows Phone 7 und 8 Eigenarten\n\n * Es gibt keine integrierte Browser-Funktion für `window.confirm` , aber Sie können es binden, indem Sie zuweisen:\n \n window.confirm = navigator.notification.confirm;\n \n\n * Aufrufe von `alert` und `confirm` sind nicht blockierend, so dass das Ergebnis nur asynchron zur Verfügung steht.\n\n### Windows-Eigenheiten\n\n * Auf Windows8/8.1 kann nicht mehr als drei Schaltflächen MessageDialog-Instanz hinzu.\n\n * Auf Windows Phone 8.1 ist es nicht möglich, Dialog mit mehr als zwei Knöpfen zeigen.\n\n### Firefox OS Macken:\n\nNative blockierenden `window.confirm()` und nicht-blockierende `navigator.notification.confirm()` zur Verfügung.\n\n## navigator.notification.prompt\n\nZeigt eine native Dialogfeld, das mehr als `Prompt`-Funktion des Browsers anpassbar ist.\n\n navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])\n \n\n * **Nachricht**: Dialogfeld Nachricht. *(String)*\n\n * **promptCallback**: Callback aufgerufen wird, mit Index gedrückt (1, 2 oder 3) oder wenn das Dialogfeld geschlossen wird, ohne einen Tastendruck (0). *(Funktion)*\n\n * **title**: Dialog Title *(String)* (Optional, Standard ist `Prompt`)\n\n * **buttonLabels**: Array von Zeichenfolgen angeben Schaltfläche Etiketten *(Array)* (Optional, Standard ist `[\"OK\", \"Abbrechen\"]`)\n\n * **defaultText**: Standard-Textbox Eingabewert (`String`) (Optional, Standard: leere Zeichenfolge)\n\n### promptCallback\n\nDie `promptCallback` wird ausgeführt, wenn der Benutzer eine der Schaltflächen im Eingabedialogfeld drückt. `Des Objekts an den Rückruf übergeben` enthält die folgenden Eigenschaften:\n\n * **buttonIndex**: der Index der Schaltfläche gedrückt. *(Anzahl)* Beachten Sie, dass der Index 1-basierte Indizierung, sodass der Wert `1`, `2`, `3` usw. ist.\n\n * **input1**: in Eingabedialogfeld eingegebenen Text. *(String)*\n\n### Beispiel\n\n function onPrompt(results) {\n alert(\"You selected button number \" + results.buttonIndex + \" and entered \" + results.input1);\n }\n \n navigator.notification.prompt(\n 'Please enter your name', // message\n onPrompt, // callback to invoke\n 'Registration', // title\n ['Ok','Exit'], // buttonLabels\n 'Jane Doe' // defaultText\n );\n \n\n### Unterstützte Plattformen\n\n * Amazon Fire OS\n * Android\n * Firefox OS\n * iOS\n * Windows Phone 7 und 8\n * Windows 8\n * Windows\n\n### Android Eigenarten\n\n * Android unterstützt maximal drei Schaltflächen und mehr als das ignoriert.\n\n * Auf Android 3.0 und höher, werden die Schaltflächen in umgekehrter Reihenfolge für Geräte angezeigt, die das Holo-Design verwenden.\n\n### Windows-Eigenheiten\n\n * Unter Windows ist Prompt Dialogfeld html-basierten mangels solcher native api.\n\n### Firefox OS Macken:\n\nNative blockierenden `window.prompt()` und nicht-blockierende `navigator.notification.prompt()` zur Verfügung.\n\n## navigator.notification.beep\n\nDas Gerät spielt einen Signalton sound.\n\n navigator.notification.beep(times);\n \n\n * **times**: die Anzahl der Wiederholungen des Signaltons. *(Anzahl)*\n\n### Beispiel\n\n // Beep twice!\n navigator.notification.beep(2);\n \n\n### Unterstützte Plattformen\n\n * Amazon Fire OS\n * Android\n * BlackBerry 10\n * iOS\n * Tizen\n * Windows Phone 7 und 8\n * Windows 8\n\n### Amazon Fire OS Macken\n\n * Amazon Fire OS spielt die Standardeinstellung **Akustische Benachrichtigung** unter **Einstellungen/Display & Sound** Bereich angegeben.\n\n### Android Eigenarten\n\n * Android spielt die Standardeinstellung **Benachrichtigung Klingelton** unter **Einstellungen/Sound & Display**-Panel angegeben.\n\n### Windows Phone 7 und 8 Eigenarten\n\n * Stützt sich auf eine generische Piepton-Datei aus der Cordova-Distribution.\n\n### Tizen Macken\n\n * Tizen implementiert Signaltöne durch Abspielen einer Audiodatei über die Medien API.\n\n * Die Beep-Datei muss kurz sein, in einem `sounds`-Unterverzeichnis des Stammverzeichnisses der Anwendung befinden muss und muss den Namen `beep.wav`."
},
{
"path": "plugins/cordova-plugin-dialogs/doc/de/index.md",
"content": "\n\n# cordova-plugin-dialogs\n\nDieses Plugin ermöglicht den Zugriff auf einige native Dialog-UI-Elemente über eine globale `navigator.notification`-Objekt.\n\nObwohl das Objekt mit der globalen Gültigkeitsbereich `navigator` verbunden ist, steht es nicht bis nach dem `Deviceready`-Ereignis.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(navigator.notification);\n }\n \n\n## Installation\n\n cordova plugin add cordova-plugin-dialogs\n \n\n## Methoden\n\n* `navigator.notification.alert`\n* `navigator.notification.confirm`\n* `navigator.notification.prompt`\n* `navigator.notification.beep`\n\n## navigator.notification.alert\n\nZeigt eine benutzerdefinierte Warnung oder Dialogfeld Feld. Die meisten Implementierungen von Cordova ein native Dialogfeld für dieses Feature verwenden, jedoch einige Plattformen des Browsers-`alert`-Funktion, die in der Regel weniger anpassbar ist.\n\n navigator.notification.alert(message, alertCallback, [title], [buttonName])\n \n\n* **Nachricht**: Dialogfeld Nachricht. *(String)*\n\n* **AlertCallback**: Callback aufgerufen wird, wenn Warnungs-Dialogfeld geschlossen wird. *(Funktion)*\n\n* **Titel**: Dialog \"Titel\". *(String)* (Optional, Standard ist`Alert`)\n\n* **ButtonName**: Name der Schaltfläche. *(String)* (Optional, Standard ist`OK`)\n\n### Beispiel\n\n function alertDismissed() {\n // do something\n }\n \n navigator.notification.alert(\n 'You are the winner!', // message\n alertDismissed, // callback\n 'Game Over', // title\n 'Done' // buttonName\n );\n \n\n### Unterstützte Plattformen\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 und 8\n* Windows 8\n* Windows\n\n### Windows Phone 7 und 8 Eigenarten\n\n* Es gibt keine eingebaute Datenbanksuchroutine-Warnung, aber Sie können binden, wie folgt zu nennen `alert()` im globalen Gültigkeitsbereich:\n \n window.alert = navigator.notification.alert;\n \n\n* Beide `alert` und `confirm` sind nicht blockierende Aufrufe, die Ergebnisse davon nur asynchron sind.\n\n### Firefox OS Macken:\n\nNative blockierenden `window.alert()` und nicht-blockierende `navigator.notification.alert()` zur Verfügung.\n\n### BlackBerry 10 Macken\n\n`navigator.notification.alert ('Text', Rückruf, 'Titel', 'Text')` Callback-Parameter wird die Zahl 1 übergeben.\n\n## navigator.notification.confirm\n\nZeigt das Dialogfeld anpassbare Bestätigung.\n\n navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])\n \n\n* **Nachricht**: Dialogfeld Nachricht. *(String)*\n\n* **ConfirmCallback**: Callback aufgerufen wird, mit Index gedrückt (1, 2 oder 3) oder wenn das Dialogfeld geschlossen wird, ohne einen Tastendruck (0). *(Funktion)*\n\n* **Titel**: Dialog \"Titel\". *(String)* (Optional, Standard ist`Confirm`)\n\n* **ButtonLabels**: Array von Zeichenfolgen, die Schaltflächenbezeichnungen angeben. *(Array)* (Optional, Standard ist [ `OK,Cancel` ])\n\n### confirmCallback\n\nDie `confirmCallback` wird ausgeführt, wenn der Benutzer eine der Schaltflächen im Dialogfeld zur Bestätigung drückt.\n\nDer Rückruf dauert das Argument `buttonIndex` *(Anzahl)*, die der Index der Schaltfläche gedrückt ist. Beachten Sie, dass der Index 1-basierte Indizierung, sodass der Wert `1`, `2`, `3` usw. ist.\n\n### Beispiel\n\n function onConfirm(buttonIndex) {\n alert('You selected button ' + buttonIndex);\n }\n \n navigator.notification.confirm(\n 'You are the winner!', // message\n onConfirm, // callback to invoke with index of button pressed\n 'Game Over', // title\n ['Restart','Exit'] // buttonLabels\n );\n \n\n### Unterstützte Plattformen\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 und 8\n* Windows 8\n* Windows\n\n### Windows Phone 7 und 8 Eigenarten\n\n* Es gibt keine integrierte Browser-Funktion für `window.confirm` , aber Sie können es binden, indem Sie zuweisen:\n \n window.confirm = navigator.notification.confirm;\n \n\n* Aufrufe von `alert` und `confirm` sind nicht blockierend, so dass das Ergebnis nur asynchron zur Verfügung steht.\n\n### Windows-Eigenheiten\n\n* Auf Windows8/8.1 kann nicht mehr als drei Schaltflächen MessageDialog-Instanz hinzu.\n\n* Auf Windows Phone 8.1 ist es nicht möglich, Dialog mit mehr als zwei Knöpfen zeigen.\n\n### Firefox OS Macken:\n\nNative blockierenden `window.confirm()` und nicht-blockierende `navigator.notification.confirm()` zur Verfügung.\n\n## navigator.notification.prompt\n\nZeigt eine native Dialogfeld, das mehr als `Prompt`-Funktion des Browsers anpassbar ist.\n\n navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])\n \n\n* **Nachricht**: Dialogfeld Nachricht. *(String)*\n\n* **promptCallback**: Callback aufgerufen wird, mit Index gedrückt (1, 2 oder 3) oder wenn das Dialogfeld geschlossen wird, ohne einen Tastendruck (0). *(Funktion)*\n\n* **title**: Dialog Title *(String)* (Optional, Standard ist `Prompt`)\n\n* **buttonLabels**: Array von Zeichenfolgen angeben Schaltfläche Etiketten *(Array)* (Optional, Standard ist `[\"OK\", \"Abbrechen\"]`)\n\n* **defaultText**: Standard-Textbox Eingabewert (`String`) (Optional, Standard: leere Zeichenfolge)\n\n### promptCallback\n\nDie `promptCallback` wird ausgeführt, wenn der Benutzer eine der Schaltflächen im Eingabedialogfeld drückt. `Des Objekts an den Rückruf übergeben` enthält die folgenden Eigenschaften:\n\n* **buttonIndex**: der Index der Schaltfläche gedrückt. *(Anzahl)* Beachten Sie, dass der Index 1-basierte Indizierung, sodass der Wert `1`, `2`, `3` usw. ist.\n\n* **input1**: in Eingabedialogfeld eingegebenen Text. *(String)*\n\n### Beispiel\n\n function onPrompt(results) {\n alert(\"You selected button number \" + results.buttonIndex + \" and entered \" + results.input1);\n }\n \n navigator.notification.prompt(\n 'Please enter your name', // message\n onPrompt, // callback to invoke\n 'Registration', // title\n ['Ok','Exit'], // buttonLabels\n 'Jane Doe' // defaultText\n );\n \n\n### Unterstützte Plattformen\n\n* Amazon Fire OS\n* Android\n* Firefox OS\n* iOS\n* Windows Phone 7 und 8\n* Windows 8\n* Windows\n\n### Android Eigenarten\n\n* Android unterstützt maximal drei Schaltflächen und mehr als das ignoriert.\n\n* Auf Android 3.0 und höher, werden die Schaltflächen in umgekehrter Reihenfolge für Geräte angezeigt, die das Holo-Design verwenden.\n\n### Windows-Eigenheiten\n\n* Unter Windows ist Prompt Dialogfeld html-basierten mangels solcher native api.\n\n### Firefox OS Macken:\n\nNative blockierenden `window.prompt()` und nicht-blockierende `navigator.notification.prompt()` zur Verfügung.\n\n## navigator.notification.beep\n\nDas Gerät spielt einen Signalton sound.\n\n navigator.notification.beep(times);\n \n\n* **times**: die Anzahl der Wiederholungen des Signaltons. *(Anzahl)*\n\n### Beispiel\n\n // Beep twice!\n navigator.notification.beep(2);\n \n\n### Unterstützte Plattformen\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* iOS\n* Tizen\n* Windows Phone 7 und 8\n* Windows 8\n\n### Amazon Fire OS Macken\n\n* Amazon Fire OS spielt die Standardeinstellung **Akustische Benachrichtigung** unter **Einstellungen/Display & Sound** Bereich angegeben.\n\n### Android Eigenarten\n\n* Android spielt die Standardeinstellung **Benachrichtigung Klingelton** unter **Einstellungen/Sound & Display**-Panel angegeben.\n\n### Windows Phone 7 und 8 Eigenarten\n\n* Stützt sich auf eine generische Piepton-Datei aus der Cordova-Distribution.\n\n### Tizen Macken\n\n* Tizen implementiert Signaltöne durch Abspielen einer Audiodatei über die Medien API.\n\n* Die Beep-Datei muss kurz sein, in einem `sounds`-Unterverzeichnis des Stammverzeichnisses der Anwendung befinden muss und muss den Namen `beep.wav`.\n"
},
{
"path": "plugins/cordova-plugin-dialogs/doc/es/README.md",
"content": "\n\n# cordova-plugin-dialogs\n\n[](https://travis-ci.org/apache/cordova-plugin-dialogs)\n\nEste plugin permite acceder a algunos elementos de interfaz de usuario nativa diálogo vía global `navigator.notification` objeto.\n\nAunque el objeto está unido al ámbito global `navigator` , no estará disponible hasta después de la `deviceready` evento.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(navigator.notification);\n }\n \n\n## Instalación\n\n cordova plugin add cordova-plugin-dialogs\n \n\n## Métodos\n\n * `navigator.notification.alert`\n * `navigator.notification.confirm`\n * `navigator.notification.prompt`\n * `navigator.notification.beep`\n\n## navigator.notification.alert\n\nMuestra un cuadro de alerta o cuadro de diálogo personalizado. La mayoría de las implementaciones de Cordova utilizan un cuadro de diálogo nativa para esta característica, pero algunas plataformas utilizan el navegador `alert` la función, que es típicamente menos personalizable.\n\n navigator.notification.alert(message, alertCallback, [title], [buttonName])\n \n\n * **message**: mensaje de diálogo. *(String)*\n\n * **alertCallback**: Callback para invocar al diálogo de alerta es desestimada. *(Función)*\n\n * **title**: título de diálogo. *(String)* (Opcional, el valor predeterminado de `Alert`)\n\n * **buttonName**: nombre del botón. *(String)* (Opcional, por defecto `Aceptar`)\n\n### Ejemplo\n\n function alertDismissed() {\n // do something\n }\n \n navigator.notification.alert(\n 'You are the winner!', // message\n alertDismissed, // callback\n 'Game Over', // title\n 'Done' // buttonName\n );\n \n\n### Plataformas soportadas\n\n * Amazon fire OS\n * Android\n * BlackBerry 10\n * Firefox OS\n * iOS\n * Tizen\n * Windows Phone 7 y 8\n * Windows 8\n * Windows\n\n### Windows Phone 7 y 8 rarezas\n\n * No hay ninguna alerta del navegador integrado, pero puede enlazar uno proceda a llamar `alert()` en el ámbito global:\n \n window.alert = navigator.notification.alert;\n \n\n * `alert` y `confirm` son non-blocking llamadas, cuyos resultados sólo están disponibles de forma asincrónica.\n\n### Firefox OS rarezas:\n\nDos nativos de bloqueo `window.alert()` y no-bloqueo `navigator.notification.alert()` están disponibles.\n\n### BlackBerry 10 rarezas\n\n`navigator.notification.alert('text', callback, 'title', 'text')`parámetro de devolución de llamada se pasa el número 1.\n\n## navigator.notification.confirm\n\nMuestra un cuadro de diálogo de confirmación personalizables.\n\n navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])\n \n\n * **message**: mensaje de diálogo. *(String)*\n\n * **confirmCallback**: Callback para invocar con índice de botón pulsado (1, 2 o 3) o cuando el diálogo es despedido sin la presión del botón (0). *(Función)*\n\n * **title**: título de diálogo. *(String)* (Opcional, por defecto a `confirmar`)\n\n * **buttonLabels**: matriz de cadenas especificando las etiquetas de botón. *(Matriz)* (Opcional, por defecto [`OK, cancelar`])\n\n### confirmCallback\n\nEl `confirmCallback` se ejecuta cuando el usuario presiona uno de los botones en el cuadro de diálogo de confirmación.\n\nLa devolución de llamada toma el argumento `buttonIndex` *(número)*, que es el índice del botón presionado. Observe que el índice utiliza indexación basada en uno, entonces el valor es `1` , `2` , `3` , etc..\n\n### Ejemplo\n\n function onConfirm(buttonIndex) {\n alert('You selected button ' + buttonIndex);\n }\n \n navigator.notification.confirm(\n 'You are the winner!', // message\n onConfirm, // callback to invoke with index of button pressed\n 'Game Over', // title\n ['Restart','Exit'] // buttonLabels\n );\n \n\n### Plataformas soportadas\n\n * Amazon fire OS\n * Android\n * BlackBerry 10\n * Firefox OS\n * iOS\n * Tizen\n * Windows Phone 7 y 8\n * Windows 8\n * Windows\n\n### Windows Phone 7 y 8 rarezas\n\n * No hay ninguna función de navegador incorporado para `window.confirm`, pero lo puede enlazar mediante la asignación:\n \n window.confirm = navigator.notification.confirm;\n \n\n * Llamadas de `alert` y `confirm` son non-blocking, así que el resultado sólo está disponible de forma asincrónica.\n\n### Windows rarezas\n\n * Sobre Windows8/8.1 no es posible agregar más de tres botones a instancia de MessageDialog.\n\n * En Windows Phone 8.1 no es posible Mostrar cuadro de diálogo con más de dos botones.\n\n### Firefox OS rarezas:\n\nDos nativos de bloqueo `window.confirm()` y no-bloqueo `navigator.notification.confirm()` están disponibles.\n\n## navigator.notification.prompt\n\nMuestra un cuadro de diálogo nativa que es más personalizable que del navegador `prompt` función.\n\n navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])\n \n\n * **message**: mensaje de diálogo. *(String)*\n\n * **promptCallback**: Callback para invocar con índice del botón pulsado (1, 2 ó 3) o cuando el cuadro de diálogo es despedido sin la presión del botón (0). *(Función)*\n\n * **título**: título *(String)* (opcional, por defecto de diálogo`Prompt`)\n\n * **buttonLabels**: matriz de cadenas especificando botón etiquetas *(Array)* (opcional, por defecto`[\"OK\",\"Cancel\"]`)\n\n * **defaultText**: valor de la entrada predeterminada textbox ( `String` ) (opcional, por defecto: cadena vacía)\n\n### promptCallback\n\nEl `promptCallback` se ejecuta cuando el usuario presiona uno de los botones del cuadro de diálogo pronto. El `results` objeto que se pasa a la devolución de llamada contiene las siguientes propiedades:\n\n * **buttonIndex**: el índice del botón presionado. *(Número)* Observe que el índice utiliza indexación basada en uno, entonces el valor es `1` , `2` , `3` , etc..\n\n * **INPUT1**: el texto introducido en el cuadro de diálogo pronto. *(String)*\n\n### Ejemplo\n\n function onPrompt(results) {\n alert(\"You selected button number \" + results.buttonIndex + \" and entered \" + results.input1);\n }\n \n navigator.notification.prompt(\n 'Please enter your name', // message\n onPrompt, // callback to invoke\n 'Registration', // title\n ['Ok','Exit'], // buttonLabels\n 'Jane Doe' // defaultText\n );\n \n\n### Plataformas soportadas\n\n * Amazon fire OS\n * Android\n * Firefox OS\n * iOS\n * Windows Phone 7 y 8\n * Windows 8\n * Windows\n\n### Rarezas Android\n\n * Android soporta un máximo de tres botones e ignora nada más.\n\n * En Android 3.0 y posteriores, los botones aparecen en orden inverso para dispositivos que utilizan el tema Holo.\n\n### Windows rarezas\n\n * En Windows pronto diálogo está basado en html debido a falta de tal api nativa.\n\n### Firefox OS rarezas:\n\nDos nativos de bloqueo `window.prompt()` y no-bloqueo `navigator.notification.prompt()` están disponibles.\n\n## navigator.notification.beep\n\nEl aparato reproduce un sonido sonido.\n\n navigator.notification.beep(times);\n \n\n * **tiempos**: el número de veces a repetir la señal. *(Número)*\n\n### Ejemplo\n\n // Beep twice!\n navigator.notification.beep(2);\n \n\n### Plataformas soportadas\n\n * Amazon fire OS\n * Android\n * BlackBerry 10\n * iOS\n * Tizen\n * Windows Phone 7 y 8\n * Windows 8\n\n### Amazon fuego OS rarezas\n\n * Amazon fuego OS reproduce el **Sonido de notificación** especificados en el panel de **configuración/pantalla y sonido** por defecto.\n\n### Rarezas Android\n\n * Androide reproduce el **tono de notificación** especificados en el panel **ajustes de sonido y visualización** por defecto.\n\n### Windows Phone 7 y 8 rarezas\n\n * Se basa en un archivo de sonido genérico de la distribución de Córdoba.\n\n### Rarezas Tizen\n\n * Tizen implementa pitidos por reproducir un archivo de audio a través de los medios de comunicación API.\n\n * El archivo de sonido debe ser corto, debe estar ubicado en un `sounds` subdirectorio del directorio raíz de la aplicación y deben ser nombrados`beep.wav`."
},
{
"path": "plugins/cordova-plugin-dialogs/doc/es/index.md",
"content": "\n\n# cordova-plugin-dialogs\n\nEste plugin permite acceder a algunos elementos de interfaz de usuario nativa diálogo vía global `navigator.notification` objeto.\n\nAunque el objeto está unido al ámbito global `navigator` , no estará disponible hasta después de la `deviceready` evento.\n\n document.addEventListener (\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {console.log(navigator.notification)};\n \n\n## Instalación\n\n Cordova plugin agregar cordova-plugin-dialogs\n \n\n## Métodos\n\n* `navigator.notification.alert`\n* `navigator.notification.confirm`\n* `navigator.notification.prompt`\n* `navigator.notification.beep`\n\n## navigator.notification.alert\n\nMuestra un cuadro de alerta o cuadro de diálogo personalizado. La mayoría de las implementaciones de Cordova utilizan un cuadro de diálogo nativa para esta característica, pero algunas plataformas utilizan el navegador `alert` la función, que es típicamente menos personalizable.\n\n Navigator.Notification.alert (mensaje, alertCallback, [title], [buttonName])\n \n\n* **message**: mensaje de diálogo. *(String)*\n\n* **alertCallback**: Callback para invocar al diálogo de alerta es desestimada. *(Función)*\n\n* **title**: título de diálogo. *(String)* (Opcional, el valor predeterminado de `Alert`)\n\n* **buttonName**: nombre del botón. *(String)* (Opcional, por defecto `Aceptar`)\n\n### Ejemplo\n\n function alertDismissed() {/ / hacer algo} navigator.notification.alert ('Tú eres el ganador!', / / mensaje alertDismissed, / / callback 'Game Over', / / título 'hecho' / / buttonName);\n \n\n### Plataformas soportadas\n\n* Amazon fire OS\n* Android\n* BlackBerry 10\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 y 8\n* Windows 8\n* Windows\n\n### Windows Phone 7 y 8 rarezas\n\n* No hay ninguna alerta del navegador integrado, pero puede enlazar uno proceda a llamar `alert()` en el ámbito global:\n \n window.alert = navigator.notification.alert;\n \n\n* `alert` y `confirm` son non-blocking llamadas, cuyos resultados sólo están disponibles de forma asincrónica.\n\n### Firefox OS rarezas:\n\nDos nativos de bloqueo `window.alert()` y no-bloqueo `navigator.notification.alert()` están disponibles.\n\n### BlackBerry 10 rarezas\n\n`navigator.notification.alert('text', callback, 'title', 'text')`parámetro de devolución de llamada se pasa el número 1.\n\n## navigator.notification.confirm\n\nMuestra un cuadro de diálogo de confirmación personalizables.\n\n Navigator.Notification.CONFIRM (mensaje, confirmCallback, [title], [buttonLabels])\n \n\n* **message**: mensaje de diálogo. *(String)*\n\n* **confirmCallback**: Callback para invocar con índice de botón pulsado (1, 2 o 3) o cuando el diálogo es despedido sin la presión del botón (0). *(Función)*\n\n* **title**: título de diálogo. *(String)* (Opcional, por defecto a `confirmar`)\n\n* **buttonLabels**: matriz de cadenas especificando las etiquetas de botón. *(Matriz)* (Opcional, por defecto [`OK, cancelar`])\n\n### confirmCallback\n\nEl `confirmCallback` se ejecuta cuando el usuario presiona uno de los botones en el cuadro de diálogo de confirmación.\n\nLa devolución de llamada toma el argumento `buttonIndex` *(número)*, que es el índice del botón presionado. Observe que el índice utiliza indexación basada en uno, entonces el valor es `1` , `2` , `3` , etc..\n\n### Ejemplo\n\n function onConfirm(buttonIndex) {alert ('Tu botón seleccionado' + buttonIndex);}\n \n Navigator.Notification.CONFIRM ('Tú eres el ganador!', / / mensaje onConfirm, / callback para invocar con índice del botón pulsado 'Game Over', / / / título ['reiniciar', 'Exit'] / / buttonLabels);\n \n\n### Plataformas soportadas\n\n* Amazon fire OS\n* Android\n* BlackBerry 10\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 y 8\n* Windows 8\n* Windows\n\n### Windows Phone 7 y 8 rarezas\n\n* No hay ninguna función de navegador incorporado para `window.confirm`, pero lo puede enlazar mediante la asignación:\n \n window.confirm = navigator.notification.confirm;\n \n\n* Llamadas de `alert` y `confirm` son non-blocking, así que el resultado sólo está disponible de forma asincrónica.\n\n### Windows rarezas\n\n* Sobre Windows8/8.1 no es posible agregar más de tres botones a instancia de MessageDialog.\n\n* En Windows Phone 8.1 no es posible Mostrar cuadro de diálogo con más de dos botones.\n\n### Firefox OS rarezas:\n\nDos nativos de bloqueo `window.confirm()` y no-bloqueo `navigator.notification.confirm()` están disponibles.\n\n## navigator.notification.prompt\n\nMuestra un cuadro de diálogo nativa que es más personalizable que del navegador `prompt` función.\n\n Navigator.Notification.prompt (mensaje, promptCallback, [title], [buttonLabels], [defaultText])\n \n\n* **mensaje**: mensaje de diálogo. *(String)*\n\n* **promptCallback**: Callback para invocar con índice del botón pulsado (1, 2 ó 3) o cuando el cuadro de diálogo es despedido sin la presión del botón (0). *(Función)*\n\n* **título**: título *(String)* (opcional, por defecto de diálogo`Prompt`)\n\n* **buttonLabels**: matriz de cadenas especificando botón etiquetas *(Array)* (opcional, por defecto`[\"OK\",\"Cancel\"]`)\n\n* **defaultText**: valor de la entrada predeterminada textbox ( `String` ) (opcional, por defecto: cadena vacía)\n\n### promptCallback\n\nEl `promptCallback` se ejecuta cuando el usuario presiona uno de los botones del cuadro de diálogo pronto. El `results` objeto que se pasa a la devolución de llamada contiene las siguientes propiedades:\n\n* **buttonIndex**: el índice del botón presionado. *(Número)* Observe que el índice utiliza indexación basada en uno, entonces el valor es `1` , `2` , `3` , etc..\n\n* **INPUT1**: el texto introducido en el cuadro de diálogo pronto. *(String)*\n\n### Ejemplo\n\n function onPrompt(results) {alert (\"seleccionaron botón número\" + results.buttonIndex + \"y entró en\" + results.input1);}\n \n Navigator.Notification.prompt ('Por favor introduce tu nombre', / / mensaje onPrompt, / / callback para invocar 'Registro', / / título ['Ok', 'Exit'], / / buttonLabels 'Jane Doe' / / defaultText);\n \n\n### Plataformas soportadas\n\n* Amazon fuego OS\n* Android\n* Firefox OS\n* iOS\n* Windows Phone 7 y 8\n* Windows 8\n* Windows\n\n### Rarezas Android\n\n* Android soporta un máximo de tres botones e ignora nada más.\n\n* En Android 3.0 y posteriores, los botones aparecen en orden inverso para dispositivos que utilizan el tema Holo.\n\n### Windows rarezas\n\n* En Windows pronto diálogo está basado en html debido a falta de tal api nativa.\n\n### Firefox OS rarezas:\n\nDos nativos de bloqueo `window.prompt()` y no-bloqueo `navigator.notification.prompt()` están disponibles.\n\n## navigator.notification.beep\n\nEl aparato reproduce un sonido sonido.\n\n Navigator.Notification.Beep(Times);\n \n\n* **tiempos**: el número de veces a repetir la señal. *(Número)*\n\n### Ejemplo\n\n Dos pitidos.\n Navigator.Notification.Beep(2);\n \n\n### Plataformas soportadas\n\n* Amazon fuego OS\n* Android\n* BlackBerry 10\n* iOS\n* Tizen\n* Windows Phone 7 y 8\n* Windows 8\n\n### Amazon fuego OS rarezas\n\n* Amazon fuego OS reproduce el **Sonido de notificación** especificados en el panel de **configuración/pantalla y sonido** por defecto.\n\n### Rarezas Android\n\n* Androide reproduce el **tono de notificación** especificados en el panel **ajustes de sonido y visualización** por defecto.\n\n### Windows Phone 7 y 8 rarezas\n\n* Se basa en un archivo de sonido genérico de la distribución de Córdoba.\n\n### Rarezas Tizen\n\n* Tizen implementa pitidos por reproducir un archivo de audio a través de los medios de comunicación API.\n\n* El archivo de sonido debe ser corto, debe estar ubicado en un `sounds` subdirectorio del directorio raíz de la aplicación y deben ser nombrados`beep.wav`.\n"
},
{
"path": "plugins/cordova-plugin-dialogs/doc/fr/README.md",
"content": "\n\n# cordova-plugin-dialogs\n\n[](https://travis-ci.org/apache/cordova-plugin-dialogs)\n\nCe plugin permet d'accéder à certains éléments d'interface utilisateur native de dialogue via un global `navigator.notification` objet.\n\nBien que l'objet est attaché à la portée globale `navigator` , il n'est pas disponible jusqu'après la `deviceready` événement.\n\n document.addEventListener (« deviceready », onDeviceReady, false) ;\n function onDeviceReady() {console.log(navigator.notification);}\n \n\n## Installation\n\n cordova plugin add cordova-plugin-dialogs\n \n\n## Méthodes\n\n * `navigator.notification.alert`\n * `navigator.notification.confirm`\n * `navigator.notification.prompt`\n * `navigator.notification.beep`\n\n## navigator.notification.alert\n\nAffiche une boîte de dialogue ou d'alerte personnalisé. La plupart des implémentations de Cordova utilisent une boîte de dialogue natives pour cette fonctionnalité, mais certaines plates-formes du navigateur `alert` fonction, qui est généralement moins personnalisable.\n\n Navigator.notification.Alert (message, alertCallback, [title], [buttonName])\n \n\n * **message**: message de la boîte de dialogue. *(String)*\n\n * **alertCallback**: callback à appeler lorsque la boîte de dialogue d'alerte est rejetée. *(Fonction)*\n\n * **titre**: titre de la boîte de dialogue. *(String)* (Facultatif, par défaut`Alert`)\n\n * **buttonName**: nom du bouton. *(String)* (Facultatif, par défaut`OK`)\n\n### Exemple\n\n function alertDismissed() {/ / faire quelque chose} navigator.notification.alert ('Vous êtes le gagnant!', / / message alertDismissed, / / rappel « Game Over », / / titre « Done » / / buttonName) ;\n \n\n### Plates-formes supportées\n\n * Amazon Fire OS\n * Android\n * BlackBerry 10\n * Firefox OS\n * iOS\n * Paciarelli\n * Windows Phone 7 et 8\n * Windows 8\n * Windows\n\n### Notes au sujet de Windows Phone 7 et 8\n\n * Il n'y a aucune boîte de dialogue d'alerte intégrée au navigateur, mais vous pouvez en lier une pour appeler `alert()` dans le scope global:\n \n window.alert = navigator.notification.alert;\n \n\n * Les deux appels `alert` et `confirm` sont non-blocants, leurs résultats ne sont disponibles que de façon asynchrone.\n\n### Firefox OS Quirks :\n\nLes deux indigènes bloquant `window.alert()` et non-bloquante `navigator.notification.alert()` sont disponibles.\n\n### BlackBerry 10 Quirks\n\n`navigator.notification.alert('text', callback, 'title', 'text')`paramètre callback est passé numéro 1.\n\n## navigator.notification.confirm\n\nAffiche une boîte de dialogue de confirmation personnalisable.\n\n Navigator.notification.Confirm (message, confirmCallback, [title], [buttonLabels])\n \n\n * **message**: message de la boîte de dialogue. *(String)*\n\n * **confirmCallback**: callback à appeler avec l'index du bouton pressé (1, 2 ou 3) ou lorsque la boîte de dialogue est fermée sans qu'un bouton ne soit pressé (0). *(Fonction)*\n\n * **titre**: titre de dialogue. *(String)* (Facultatif, par défaut`Confirm`)\n\n * **buttonLabels**: tableau de chaînes spécifiant les étiquettes des boutons. *(Array)* (Optionnel, par défaut, [ `OK,Cancel` ])\n\n### confirmCallback\n\nLe `confirmCallback` s'exécute lorsque l'utilisateur appuie sur un bouton dans la boîte de dialogue de confirmation.\n\nLe rappel prend l'argument `buttonIndex` *(nombre)*, qui est l'index du bouton activé. Notez que l'index utilise base d'indexation, la valeur est `1` , `2` , `3` , etc..\n\n### Exemple\n\n function onConfirm(buttonIndex) {alert (« Vous bouton sélectionné » + buttonIndex);}\n \n Navigator.notification.Confirm ('Vous êtes le gagnant!', / / message onConfirm, / / rappel d'invoquer avec l'index du bouton enfoncé « Game Over », / / title ['redémarrer', « Exit »] / / buttonLabels) ;\n \n\n### Plates-formes supportées\n\n * Amazon Fire OS\n * Android\n * BlackBerry 10\n * Firefox OS\n * iOS\n * Paciarelli\n * Windows Phone 7 et 8\n * Windows 8\n * Windows\n\n### Notes au sujet de Windows Phone 7 et 8\n\n * Il n'y a aucune fonction intégrée au navigateur pour `window.confirm`, mais vous pouvez en lier une en affectant:\n \n window.confirm = navigator.notification.confirm ;\n \n\n * Les appels à `alert` et `confirm` sont non-bloquants, donc le résultat est seulement disponible de façon asynchrone.\n\n### Bizarreries de Windows\n\n * Sur Windows8/8.1, il n'est pas possible d'ajouter plus de trois boutons à MessageDialog instance.\n\n * Sur Windows Phone 8.1, il n'est pas possible d'établir le dialogue avec plus de deux boutons.\n\n### Firefox OS Quirks :\n\nLes deux indigènes bloquant `window.confirm()` et non-bloquante `navigator.notification.confirm()` sont disponibles.\n\n## navigator.notification.prompt\n\nAffiche une boîte de dialogue natif qui est plus personnalisable que le navigateur `prompt` fonction.\n\n Navigator.notification.prompt (message, promptCallback, [title], [buttonLabels], [defaultText])\n \n\n * **message**: message de la boîte de dialogue. *(String)*\n\n * **promptCallback**: rappel d'invoquer avec l'index du bouton pressé (1, 2 ou 3) ou lorsque la boîte de dialogue est fermée sans une presse de bouton (0). *(Fonction)*\n\n * **titre**: titre *(String)* (facultatif, la valeur par défaut de dialogue`Prompt`)\n\n * **buttonLabels**: tableau de chaînes spécifiant les bouton *(Array)* (facultatif, par défaut, les étiquettes`[\"OK\",\"Cancel\"]`)\n\n * **defaultText**: zone de texte par défaut entrée valeur ( `String` ) (en option, par défaut : chaîne vide)\n\n### promptCallback\n\nLe `promptCallback` s'exécute lorsque l'utilisateur appuie sur un bouton dans la boîte de dialogue d'invite. Le `results` objet passé au rappel contient les propriétés suivantes :\n\n * **buttonIndex**: l'index du bouton activé. *(Nombre)* Notez que l'index utilise base d'indexation, la valeur est `1` , `2` , `3` , etc..\n\n * **entrée 1**: le texte entré dans la boîte de dialogue d'invite. *(String)*\n\n### Exemple\n\n function onPrompt(results) {alert (« Vous avez sélectionné le numéro du bouton » + results.buttonIndex + « et saisi » + results.input1);}\n \n Navigator.notification.prompt ('Veuillez saisir votre nom', / / message onPrompt, / / rappel à appeler « Registration », / / title ['Ok', 'Exit'], / / buttonLabels « Jane Doe » / / defaultText) ;\n \n\n### Plates-formes supportées\n\n * Amazon Fire OS\n * Android\n * Firefox OS\n * iOS\n * Windows Phone 7 et 8\n * Windows 8\n * Windows\n\n### Quirks Android\n\n * Android prend en charge un maximum de trois boutons et ignore plus que cela.\n\n * Sur Android 3.0 et versions ultérieures, les boutons sont affichés dans l'ordre inverse pour les appareils qui utilisent le thème Holo.\n\n### Bizarreries de Windows\n\n * Sous Windows, dialogue d'invite est basé sur html en raison de l'absence de ces api native.\n\n### Firefox OS Quirks :\n\nLes deux indigènes bloquant `window.prompt()` et non-bloquante `navigator.notification.prompt()` sont disponibles.\n\n## navigator.notification.beep\n\nLe dispositif joue un bip sonore.\n\n Navigator.notification.Beep(Times) ;\n \n\n * **temps**: le nombre de fois répéter le bip. *(Nombre)*\n\n### Exemple\n\n Deux bips !\n Navigator.notification.Beep(2) ;\n \n\n### Plates-formes supportées\n\n * Amazon Fire OS\n * Android\n * BlackBerry 10\n * iOS\n * Paciarelli\n * Windows Phone 7 et 8\n * Windows 8\n\n### Amazon Fire OS Quirks\n\n * Amazon Fire OS joue la valeur par défaut le **Son de Notification** spécifié sous le panneau **d'affichage des réglages/& Sound** .\n\n### Quirks Android\n\n * Android joue la **sonnerie de Notification** spécifié sous le panneau des **réglages/son et affichage** de valeur par défaut.\n\n### Notes au sujet de Windows Phone 7 et 8\n\n * S'appuie sur un fichier générique bip de la distribution de Cordova.\n\n### Bizarreries de paciarelli\n\n * Paciarelli implémente les bips en lisant un fichier audio via les médias API.\n\n * Le fichier sonore doit être court, doit se trouver dans un `sounds` sous-répertoire du répertoire racine de l'application et doit être nommé`beep.wav`."
},
{
"path": "plugins/cordova-plugin-dialogs/doc/fr/index.md",
"content": "\n\n# cordova-plugin-dialogs\n\nCe plugin permet d'accéder à certains éléments d'interface utilisateur native de dialogue via un global `navigator.notification` objet.\n\nBien que l'objet est attaché à la portée globale `navigator` , il n'est pas disponible jusqu'après la `deviceready` événement.\n\n document.addEventListener (« deviceready », onDeviceReady, false) ;\n function onDeviceReady() {console.log(navigator.notification);}\n \n\n## Installation\n\n Cordova plugin ajouter cordova-plugin-dialogs\n \n\n## Méthodes\n\n* `navigator.notification.alert`\n* `navigator.notification.confirm`\n* `navigator.notification.prompt`\n* `navigator.notification.beep`\n\n## navigator.notification.alert\n\nAffiche une boîte de dialogue ou d'alerte personnalisé. La plupart des implémentations de Cordova utilisent une boîte de dialogue natives pour cette fonctionnalité, mais certaines plates-formes du navigateur `alert` fonction, qui est généralement moins personnalisable.\n\n Navigator.notification.Alert (message, alertCallback, [title], [buttonName])\n \n\n* **message**: message de la boîte de dialogue. *(String)*\n\n* **alertCallback**: callback à appeler lorsque la boîte de dialogue d'alerte est rejetée. *(Fonction)*\n\n* **titre**: titre de la boîte de dialogue. *(String)* (Facultatif, par défaut`Alert`)\n\n* **buttonName**: nom du bouton. *(String)* (Facultatif, par défaut`OK`)\n\n### Exemple\n\n function alertDismissed() {/ / faire quelque chose} navigator.notification.alert ('Vous êtes le gagnant!', / / message alertDismissed, / / rappel « Game Over », / / titre « Done » / / buttonName) ;\n \n\n### Plates-formes prises en charge\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 et 8\n* Windows 8\n* Windows\n\n### Windows Phone 7 et 8 Quirks\n\n* Il n'y a aucune boîte de dialogue d'alerte intégrée au navigateur, mais vous pouvez en lier une pour appeler `alert()` dans le scope global:\n \n window.alert = navigator.notification.alert;\n \n\n* Les deux appels `alert` et `confirm` sont non-blocants, leurs résultats ne sont disponibles que de façon asynchrone.\n\n### Firefox OS Quirks :\n\nLes deux indigènes bloquant `window.alert()` et non-bloquante `navigator.notification.alert()` sont disponibles.\n\n### BlackBerry 10 Quirks\n\n`navigator.notification.alert('text', callback, 'title', 'text')`paramètre callback est passé numéro 1.\n\n## navigator.notification.confirm\n\nAffiche une boîte de dialogue de confirmation personnalisable.\n\n Navigator.notification.Confirm (message, confirmCallback, [title], [buttonLabels])\n \n\n* **message**: message de la boîte de dialogue. *(String)*\n\n* **confirmCallback**: callback à appeler avec l'index du bouton pressé (1, 2 ou 3) ou lorsque la boîte de dialogue est fermée sans qu'un bouton ne soit pressé (0). *(Fonction)*\n\n* **titre**: titre de dialogue. *(String)* (Facultatif, par défaut`Confirm`)\n\n* **buttonLabels**: tableau de chaînes spécifiant les étiquettes des boutons. *(Array)* (Optionnel, par défaut, [ `OK,Cancel` ])\n\n### confirmCallback\n\nLe `confirmCallback` s'exécute lorsque l'utilisateur appuie sur un bouton dans la boîte de dialogue de confirmation.\n\nLe rappel prend l'argument `buttonIndex` *(nombre)*, qui est l'index du bouton activé. Notez que l'index utilise base d'indexation, la valeur est `1` , `2` , `3` , etc..\n\n### Exemple\n\n function onConfirm(buttonIndex) {alert (« Vous bouton sélectionné » + buttonIndex);}\n \n Navigator.notification.Confirm ('Vous êtes le gagnant!', / / message onConfirm, / / rappel d'invoquer avec l'index du bouton enfoncé « Game Over », / / title ['redémarrer', « Exit »] / / buttonLabels) ;\n \n\n### Plates-formes prises en charge\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* Firefox OS\n* iOS\n* Paciarelli\n* Windows Phone 7 et 8\n* Windows 8\n* Windows\n\n### Windows Phone 7 et 8 Quirks\n\n* Il n'y a aucune fonction intégrée au navigateur pour `window.confirm`, mais vous pouvez en lier une en affectant:\n \n window.confirm = navigator.notification.confirm ;\n \n\n* Les appels à `alert` et `confirm` sont non-bloquants, donc le résultat est seulement disponible de façon asynchrone.\n\n### Bizarreries de Windows\n\n* Sur Windows8/8.1, il n'est pas possible d'ajouter plus de trois boutons à MessageDialog instance.\n\n* Sur Windows Phone 8.1, il n'est pas possible d'établir le dialogue avec plus de deux boutons.\n\n### Firefox OS Quirks :\n\nLes deux indigènes bloquant `window.confirm()` et non-bloquante `navigator.notification.confirm()` sont disponibles.\n\n## navigator.notification.prompt\n\nAffiche une boîte de dialogue natif qui est plus personnalisable que le navigateur `prompt` fonction.\n\n Navigator.notification.prompt (message, promptCallback, [title], [buttonLabels], [defaultText])\n \n\n* **message**: message de la boîte de dialogue. *(String)*\n\n* **promptCallback**: rappel d'invoquer avec l'index du bouton pressé (1, 2 ou 3) ou lorsque la boîte de dialogue est fermée sans une presse de bouton (0). *(Fonction)*\n\n* **titre**: titre *(String)* (facultatif, la valeur par défaut de dialogue`Prompt`)\n\n* **buttonLabels**: tableau de chaînes spécifiant les bouton *(Array)* (facultatif, par défaut, les étiquettes`[\"OK\",\"Cancel\"]`)\n\n* **defaultText**: zone de texte par défaut entrée valeur ( `String` ) (en option, par défaut : chaîne vide)\n\n### promptCallback\n\nLe `promptCallback` s'exécute lorsque l'utilisateur appuie sur un bouton dans la boîte de dialogue d'invite. Le `results` objet passé au rappel contient les propriétés suivantes :\n\n* **buttonIndex**: l'index du bouton activé. *(Nombre)* Notez que l'index utilise base d'indexation, la valeur est `1` , `2` , `3` , etc..\n\n* **entrée 1**: le texte entré dans la boîte de dialogue d'invite. *(String)*\n\n### Exemple\n\n function onPrompt(results) {alert (« Vous avez sélectionné le numéro du bouton » + results.buttonIndex + « et saisi » + results.input1);}\n \n Navigator.notification.prompt ('Veuillez saisir votre nom', / / message onPrompt, / / rappel à appeler « Registration », / / title ['Ok', 'Exit'], / / buttonLabels « Jane Doe » / / defaultText) ;\n \n\n### Plates-formes prises en charge\n\n* Amazon Fire OS\n* Android\n* Firefox OS\n* iOS\n* Windows Phone 7 et 8\n* Windows 8\n* Windows\n\n### Quirks Android\n\n* Android prend en charge un maximum de trois boutons et ignore plus que cela.\n\n* Sur Android 3.0 et versions ultérieures, les boutons sont affichés dans l'ordre inverse pour les appareils qui utilisent le thème Holo.\n\n### Bizarreries de Windows\n\n* Sous Windows, dialogue d'invite est basé sur html en raison de l'absence de ces api native.\n\n### Firefox OS Quirks :\n\nLes deux indigènes bloquant `window.prompt()` et non-bloquante `navigator.notification.prompt()` sont disponibles.\n\n## navigator.notification.beep\n\nLe dispositif joue un bip sonore.\n\n Navigator.notification.Beep(Times) ;\n \n\n* **temps**: le nombre de fois répéter le bip. *(Nombre)*\n\n### Exemple\n\n Deux bips !\n Navigator.notification.Beep(2) ;\n \n\n### Plates-formes prises en charge\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* iOS\n* Paciarelli\n* Windows Phone 7 et 8\n* Windows 8\n\n### Amazon Fire OS Quirks\n\n* Amazon Fire OS joue la valeur par défaut le **Son de Notification** spécifié sous le panneau **d'affichage des réglages/& Sound** .\n\n### Quirks Android\n\n* Android joue la **sonnerie de Notification** spécifié sous le panneau des **réglages/son et affichage** de valeur par défaut.\n\n### Windows Phone 7 et 8 Quirks\n\n* S'appuie sur un fichier générique bip de la distribution de Cordova.\n\n### Bizarreries de paciarelli\n\n* Paciarelli implémente les bips en lisant un fichier audio via les médias API.\n\n* Le fichier sonore doit être court, doit se trouver dans un `sounds` sous-répertoire du répertoire racine de l'application et doit être nommé`beep.wav`.\n"
},
{
"path": "plugins/cordova-plugin-dialogs/doc/it/README.md",
"content": "\n\n# cordova-plugin-dialogs\n\n[](https://travis-ci.org/apache/cordova-plugin-dialogs)\n\nQuesto plugin consente di accedere ad alcuni elementi di interfaccia utente nativa dialogo tramite un oggetto globale `navigator.notification`.\n\nAnche se l'oggetto è associato con ambito globale del `navigator`, non è disponibile fino a dopo l'evento `deviceready`.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(navigator.notification);\n }\n \n\n## Installazione\n\n cordova plugin add cordova-plugin-dialogs\n \n\n## Metodi\n\n * `navigator.notification.alert`\n * `navigator.notification.confirm`\n * `navigator.notification.prompt`\n * `navigator.notification.beep`\n\n## navigator.notification.alert\n\nMostra una finestra di avviso o la finestra di dialogo personalizzata. La maggior parte delle implementazioni di Cordova utilizzano una finestra di dialogo nativa per questa caratteristica, ma alcune piattaforme utilizzano la funzione di `alert` del browser, che è in genere meno personalizzabile.\n\n navigator.notification.alert(message, alertCallback, [title], [buttonName])\n \n\n * **message**: messaggio finestra di dialogo. *(String)*\n\n * **alertCallback**: Callback da richiamare quando viene chiusa la finestra di avviso. *(Funzione)*\n\n * **title**: titolo di dialogo. *(String)* (Opzionale, default è `Alert`)\n\n * **buttonName**: nome del pulsante. *(String)* (Opzionale, default è `OK`)\n\n### Esempio\n\n function alertDismissed() {\n // do something\n }\n \n navigator.notification.alert(\n 'You are the winner!', // message\n alertDismissed, // callback\n 'Game Over', // title\n 'Done' // buttonName\n );\n \n\n### Piattaforme supportate\n\n * Amazon fuoco OS\n * Android\n * BlackBerry 10\n * Firefox OS\n * iOS\n * Tizen\n * Windows Phone 7 e 8\n * Windows 8\n * Windows\n\n### Windows Phone 7 e 8 stranezze\n\n * Non non c'è nessun avviso del browser integrato, ma è possibile associare uno come segue per chiamare `alert()` in ambito globale:\n \n window.alert = navigator.notification.alert;\n \n\n * Entrambi `alert` e `confirm` sono non di blocco chiamate, risultati di cui sono disponibili solo in modo asincrono.\n\n### Firefox OS Stranezze:\n\nNativo di blocco `window.alert()` blocco `navigator.notification.alert()` sono disponibili sia.\n\n### BlackBerry 10 capricci\n\nparametro di callback `navigator.notification.alert ('text' callback, 'title' 'text')` viene passato il numero 1.\n\n## navigator.notification.confirm\n\nVisualizza una finestra di dialogo conferma personalizzabile.\n\n navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])\n \n\n * **message**: messaggio finestra di dialogo. *(String)*\n\n * **confirmCallback**: Callback da richiamare con l'indice del pulsante premuto (1, 2 o 3) o quando la finestra di dialogo viene chiusa senza una pressione del pulsante (0). *(Funzione)*\n\n * **titolo**: titolo di dialogo. *(String)* (Opzionale, default è`Confirm`)\n\n * **buttonLabels**: matrice di stringhe che specificano le etichette dei pulsanti. *(Matrice)* (Opzionale, default è [ `OK,Cancel` ])\n\n### confirmCallback\n\nIl `confirmCallback` viene eseguito quando l'utente preme uno dei pulsanti nella finestra di dialogo conferma.\n\nIl callback accetta l'argomento `buttonIndex` *(numero)*, che è l'indice del pulsante premuto. Si noti che l'indice utilizza l'indicizzazione base uno, quindi il valore è `1`, `2`, `3`, ecc.\n\n### Esempio\n\n function onConfirm(buttonIndex) {\n alert('You selected button ' + buttonIndex);\n }\n \n navigator.notification.confirm(\n 'You are the winner!', // message\n onConfirm, // callback to invoke with index of button pressed\n 'Game Over', // title\n ['Restart','Exit'] // buttonLabels\n );\n \n\n### Piattaforme supportate\n\n * Amazon fuoco OS\n * Android\n * BlackBerry 10\n * Firefox OS\n * iOS\n * Tizen\n * Windows Phone 7 e 8\n * Windows 8\n * Windows\n\n### Windows Phone 7 e 8 stranezze\n\n * Non non c'è nessuna funzione browser incorporato per `window.confirm` , ma è possibile associare assegnando:\n \n window.confirm = navigator.notification.confirm;\n \n\n * Chiama al `alert` e `confirm` sono non bloccante, quindi il risultato è disponibile solo in modo asincrono.\n\n### Stranezze di Windows\n\n * Su Windows8/8.1 non è possibile aggiungere più di tre pulsanti a MessageDialog istanza.\n\n * Su Windows Phone 8.1 non è possibile mostrare la finestra di dialogo con più di due pulsanti.\n\n### Firefox OS Stranezze:\n\nNativo di blocco `window.confirm()` blocco `navigator.notification.confirm()` sono disponibili sia.\n\n## navigator.notification.prompt\n\nVisualizza una finestra di dialogo nativa che è più personalizzabile di funzione `prompt` del browser.\n\n navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])\n \n\n * **message**: messaggio finestra di dialogo. *(String)*\n\n * **promptCallback**: Callback da richiamare con l'indice del pulsante premuto (1, 2 o 3) o quando la finestra di dialogo viene chiusa senza una pressione del pulsante (0). *(Funzione)*\n\n * **title**: dialogo titolo *(String)* (opzionale, default è `Prompt`)\n\n * **buttonLabels**: matrice di stringhe specificando il pulsante etichette *(Array)* (opzionale, default è `[\"OK\", \"Cancel\"]`)\n\n * **defaultText**: valore (`String`) di input predefinito textbox (opzionale, Default: empty string)\n\n### promptCallback\n\nIl `promptCallback` viene eseguito quando l'utente preme uno dei pulsanti nella finestra di dialogo richiesta. `results` oggetto passato al metodo di callback contiene le seguenti proprietà:\n\n * **buttonIndex**: l'indice del pulsante premuto. *(Numero)* Si noti che l'indice utilizza l'indicizzazione base uno, quindi il valore è `1`, `2`, `3`, ecc.\n\n * **input1**: il testo immesso nella finestra di dialogo richiesta. *(String)*\n\n### Esempio\n\n function onPrompt(results) {\n alert(\"You selected button number \" + results.buttonIndex + \" and entered \" + results.input1);\n }\n \n navigator.notification.prompt(\n 'Please enter your name', // message\n onPrompt, // callback to invoke\n 'Registration', // title\n ['Ok','Exit'], // buttonLabels\n 'Jane Doe' // defaultText\n );\n \n\n### Piattaforme supportate\n\n * Amazon fuoco OS\n * Android\n * Firefox OS\n * iOS\n * Windows Phone 7 e 8\n * Windows 8\n * Windows\n\n### Stranezze Android\n\n * Android supporta un massimo di tre pulsanti e ignora di più di quello.\n\n * Su Android 3.0 e versioni successive, i pulsanti vengono visualizzati in ordine inverso per dispositivi che utilizzano il tema Holo.\n\n### Stranezze di Windows\n\n * Su Windows finestra di dialogo richiesta è a causa di mancanza di tali api nativa basata su html.\n\n### Firefox OS Stranezze:\n\nNativo di blocco `window.prompt()` blocco `navigator.notification.prompt()` sono disponibili sia.\n\n## navigator.notification.beep\n\nIl dispositivo riproduce un bip sonoro.\n\n navigator.notification.beep(times);\n \n\n * **times**: il numero di volte per ripetere il segnale acustico. *(Numero)*\n\n### Esempio\n\n // Beep twice!\n navigator.notification.beep(2);\n \n\n### Piattaforme supportate\n\n * Amazon fuoco OS\n * Android\n * BlackBerry 10\n * iOS\n * Tizen\n * Windows Phone 7 e 8\n * Windows 8\n\n### Amazon fuoco OS stranezze\n\n * Amazon fuoco OS riproduce il **Suono di notifica** specificato sotto il pannello **Impostazioni/Display e il suono** predefinito.\n\n### Stranezze Android\n\n * Android giochi default **Notification ringtone** specificato sotto il pannello **impostazioni/audio e Display**.\n\n### Windows Phone 7 e 8 stranezze\n\n * Si basa su un file generico bip dalla distribuzione di Cordova.\n\n### Tizen stranezze\n\n * Tizen implementa bip di riproduzione di un file audio tramite i media API.\n\n * Il file beep deve essere breve, deve trovarsi in una sottodirectory di `sounds` della directory principale dell'applicazione e deve essere denominato `beep.wav`."
},
{
"path": "plugins/cordova-plugin-dialogs/doc/it/index.md",
"content": "\n\n# cordova-plugin-dialogs\n\nQuesto plugin consente di accedere ad alcuni elementi di interfaccia utente nativa dialogo tramite un oggetto globale `navigator.notification`.\n\nAnche se l'oggetto è associato con ambito globale del `navigator`, non è disponibile fino a dopo l'evento `deviceready`.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(navigator.notification);\n }\n \n\n## Installazione\n\n cordova plugin add cordova-plugin-dialogs\n \n\n## Metodi\n\n* `navigator.notification.alert`\n* `navigator.notification.confirm`\n* `navigator.notification.prompt`\n* `navigator.notification.beep`\n\n## navigator.notification.alert\n\nMostra una finestra di avviso o la finestra di dialogo personalizzata. La maggior parte delle implementazioni di Cordova utilizzano una finestra di dialogo nativa per questa caratteristica, ma alcune piattaforme utilizzano la funzione di `alert` del browser, che è in genere meno personalizzabile.\n\n navigator.notification.alert(message, alertCallback, [title], [buttonName])\n \n\n* **message**: messaggio finestra di dialogo. *(String)*\n\n* **alertCallback**: Callback da richiamare quando viene chiusa la finestra di avviso. *(Funzione)*\n\n* **title**: titolo di dialogo. *(String)* (Opzionale, default è `Alert`)\n\n* **buttonName**: nome del pulsante. *(String)* (Opzionale, default è `OK`)\n\n### Esempio\n\n function alertDismissed() {\n // do something\n }\n \n navigator.notification.alert(\n 'You are the winner!', // message\n alertDismissed, // callback\n 'Game Over', // title\n 'Done' // buttonName\n );\n \n\n### Piattaforme supportate\n\n* Amazon fuoco OS\n* Android\n* BlackBerry 10\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 e 8\n* Windows 8\n* Windows\n\n### Windows Phone 7 e 8 stranezze\n\n* Non non c'è nessun avviso del browser integrato, ma è possibile associare uno come segue per chiamare `alert()` in ambito globale:\n \n window.alert = navigator.notification.alert;\n \n\n* Entrambi `alert` e `confirm` sono non di blocco chiamate, risultati di cui sono disponibili solo in modo asincrono.\n\n### Firefox OS Stranezze:\n\nNativo di blocco `window.alert()` blocco `navigator.notification.alert()` sono disponibili sia.\n\n### BlackBerry 10 capricci\n\nparametro di callback `navigator.notification.alert ('text' callback, 'title' 'text')` viene passato il numero 1.\n\n## navigator.notification.confirm\n\nVisualizza una finestra di dialogo conferma personalizzabile.\n\n navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])\n \n\n* **messaggio**: messaggio finestra di dialogo. *(String)*\n\n* **confirmCallback**: Callback da richiamare con l'indice del pulsante premuto (1, 2 o 3) o quando la finestra di dialogo viene chiusa senza una pressione del pulsante (0). *(Funzione)*\n\n* **titolo**: titolo di dialogo. *(String)* (Opzionale, default è`Confirm`)\n\n* **buttonLabels**: matrice di stringhe che specificano le etichette dei pulsanti. *(Matrice)* (Opzionale, default è [ `OK,Cancel` ])\n\n### confirmCallback\n\nIl `confirmCallback` viene eseguito quando l'utente preme uno dei pulsanti nella finestra di dialogo conferma.\n\nIl callback accetta l'argomento `buttonIndex` *(numero)*, che è l'indice del pulsante premuto. Si noti che l'indice utilizza l'indicizzazione base uno, quindi il valore è `1`, `2`, `3`, ecc.\n\n### Esempio\n\n function onConfirm(buttonIndex) {\n alert('You selected button ' + buttonIndex);\n }\n \n navigator.notification.confirm(\n 'You are the winner!', // message\n onConfirm, // callback to invoke with index of button pressed\n 'Game Over', // title\n ['Restart','Exit'] // buttonLabels\n );\n \n\n### Piattaforme supportate\n\n* Amazon fuoco OS\n* Android\n* BlackBerry 10\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 e 8\n* Windows 8\n* Windows\n\n### Windows Phone 7 e 8 stranezze\n\n* Non non c'è nessuna funzione browser incorporato per `window.confirm` , ma è possibile associare assegnando:\n \n window.confirm = navigator.notification.confirm;\n \n\n* Chiama al `alert` e `confirm` sono non bloccante, quindi il risultato è disponibile solo in modo asincrono.\n\n### Stranezze di Windows\n\n* Su Windows8/8.1 non è possibile aggiungere più di tre pulsanti a MessageDialog istanza.\n\n* Su Windows Phone 8.1 non è possibile mostrare la finestra di dialogo con più di due pulsanti.\n\n### Firefox OS Stranezze:\n\nNativo di blocco `window.confirm()` blocco `navigator.notification.confirm()` sono disponibili sia.\n\n## navigator.notification.prompt\n\nVisualizza una finestra di dialogo nativa che è più personalizzabile di funzione `prompt` del browser.\n\n navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])\n \n\n* **message**: messaggio finestra di dialogo. *(String)*\n\n* **promptCallback**: Callback da richiamare con l'indice del pulsante premuto (1, 2 o 3) o quando la finestra di dialogo viene chiusa senza una pressione del pulsante (0). *(Funzione)*\n\n* **title**: dialogo titolo *(String)* (opzionale, default è `Prompt`)\n\n* **buttonLabels**: matrice di stringhe specificando il pulsante etichette *(Array)* (opzionale, default è `[\"OK\", \"Cancel\"]`)\n\n* **defaultText**: valore (`String`) di input predefinito textbox (opzionale, Default: empty string)\n\n### promptCallback\n\nIl `promptCallback` viene eseguito quando l'utente preme uno dei pulsanti nella finestra di dialogo richiesta. `results` oggetto passato al metodo di callback contiene le seguenti proprietà:\n\n* **buttonIndex**: l'indice del pulsante premuto. *(Numero)* Si noti che l'indice utilizza l'indicizzazione base uno, quindi il valore è `1`, `2`, `3`, ecc.\n\n* **input1**: il testo immesso nella finestra di dialogo richiesta. *(String)*\n\n### Esempio\n\n function onPrompt(results) {\n alert(\"You selected button number \" + results.buttonIndex + \" and entered \" + results.input1);\n }\n \n navigator.notification.prompt(\n 'Please enter your name', // message\n onPrompt, // callback to invoke\n 'Registration', // title\n ['Ok','Exit'], // buttonLabels\n 'Jane Doe' // defaultText\n );\n \n\n### Piattaforme supportate\n\n* Amazon fuoco OS\n* Android\n* Firefox OS\n* iOS\n* Windows Phone 7 e 8\n* Windows 8\n* Windows\n\n### Stranezze Android\n\n* Android supporta un massimo di tre pulsanti e ignora di più di quello.\n\n* Su Android 3.0 e versioni successive, i pulsanti vengono visualizzati in ordine inverso per dispositivi che utilizzano il tema Holo.\n\n### Stranezze di Windows\n\n* Su Windows finestra di dialogo richiesta è a causa di mancanza di tali api nativa basata su html.\n\n### Firefox OS Stranezze:\n\nNativo di blocco `window.prompt()` blocco `navigator.notification.prompt()` sono disponibili sia.\n\n## navigator.notification.beep\n\nIl dispositivo riproduce un bip sonoro.\n\n navigator.notification.beep(times);\n \n\n* **times**: il numero di volte per ripetere il segnale acustico. *(Numero)*\n\n### Esempio\n\n // Beep twice!\n navigator.notification.beep(2);\n \n\n### Piattaforme supportate\n\n* Amazon fuoco OS\n* Android\n* BlackBerry 10\n* iOS\n* Tizen\n* Windows Phone 7 e 8\n* Windows 8\n\n### Amazon fuoco OS stranezze\n\n* Amazon fuoco OS riproduce il **Suono di notifica** specificato sotto il pannello **Impostazioni/Display e il suono** predefinito.\n\n### Stranezze Android\n\n* Android giochi default **Notification ringtone** specificato sotto il pannello **impostazioni/audio e Display**.\n\n### Windows Phone 7 e 8 stranezze\n\n* Si basa su un file generico bip dalla distribuzione di Cordova.\n\n### Tizen stranezze\n\n* Tizen implementa bip di riproduzione di un file audio tramite i media API.\n\n* Il file beep deve essere breve, deve trovarsi in una sottodirectory di `sounds` della directory principale dell'applicazione e deve essere denominato `beep.wav`.\n"
},
{
"path": "plugins/cordova-plugin-dialogs/doc/ja/README.md",
"content": "\n\n# cordova-plugin-dialogs\n\n[](https://travis-ci.org/apache/cordova-plugin-dialogs)\n\nこのプラグインは、グローバル `navigator.notification` オブジェクトを介していくつかネイティブ ダイアログの UI 要素へのアクセスを提供します。\n\nオブジェクトは、グローバル スコープの `ナビゲーター` に添付、それがないまで `deviceready` イベントの後。\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(navigator.notification);\n }\n \n\n## インストール\n\n cordova plugin add cordova-plugin-dialogs\n \n\n## メソッド\n\n * `navigator.notification.alert`\n * `navigator.notification.confirm`\n * `navigator.notification.prompt`\n * `navigator.notification.beep`\n\n## navigator.notification.alert\n\nカスタムの警告またはダイアログ ボックスが表示されます。 ほとんどコルドバ ネイティブ] ダイアログ ボックスの使用この機能がいくつかのプラットフォームは通常小さいカスタマイズ可能なブラウザーの `警告` 機能を使用します。\n\n navigator.notification.alert(message, alertCallback, [title], [buttonName])\n \n\n * **メッセージ**: ダイアログ メッセージ。*(文字列)*\n\n * **alertCallback**: 警告ダイアログが閉じられたときに呼び出すコールバック。*(機能)*\n\n * **タイトル**: ダイアログのタイトル。*(文字列)*(省略可能、既定値は`Alert`)\n\n * **buttonName**: ボタンの名前。*(文字列)*(省略可能、既定値は`OK`)\n\n### 例\n\n function alertDismissed() {\n // do something\n }\n \n navigator.notification.alert(\n 'You are the winner!', // message\n alertDismissed, // callback\n 'Game Over', // title\n 'Done' // buttonName\n );\n \n\n### サポートされているプラットフォーム\n\n * アマゾン火 OS\n * アンドロイド\n * ブラックベリー 10\n * Firefox の OS\n * iOS\n * Tizen\n * Windows Phone 7 と 8\n * Windows 8\n * Windows\n\n### Windows Phone 7 と 8 癖\n\n * 組み込みのブラウザー警告がない呼び出しを次のように 1 つをバインドすることができます `alert()` 、グローバル スコープで。\n \n window.alert = navigator.notification.alert;\n \n\n * 両方の `alert` と `confirm` は非ブロッキング呼び出し、結果は非同期的にのみ利用できます。\n\n### Firefox OS 互換:\n\nネイティブ ブロック `window.alert()` と非ブロッキング `navigator.notification.alert()` があります。\n\n### ブラックベリー 10 癖\n\n`navigator.notification.alert ('text' コールバック 'title'、'text')` コールバック パラメーターは数 1 に渡されます。\n\n## navigator.notification.confirm\n\nカスタマイズ可能な確認のダイアログ ボックスが表示されます。\n\n navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])\n \n\n * **メッセージ**: ダイアログ メッセージ。*(文字列)*\n\n * **confirmCallback**: インデックス (1、2、または 3) を押されたボタンまたはダイアログ ボックスは、ボタンを押す （0） なしに解雇されたときに呼び出すコールバック。*(機能)*\n\n * **タイトル**: ダイアログのタイトル。*(文字列)*(省略可能、既定値は`Confirm`)\n\n * **buttonLabels**: ボタンのラベルを指定する文字列の配列。*(配列)*(省略可能、既定値は [ `OK,Cancel` ])\n\n### confirmCallback\n\n`confirmCallback` は、いずれかの確認ダイアログ ボックスでボタンを押したときに実行します。\n\nコールバックは、引数 `buttonIndex` *（番号）* は、押されたボタンのインデックス。 インデックスがインデックス 1 ベースので、値は `1`、`2`、`3` などに注意してください。\n\n### 例\n\n function onConfirm(buttonIndex) {\n alert('You selected button ' + buttonIndex);\n }\n \n navigator.notification.confirm(\n 'You are the winner!', // message\n onConfirm, // callback to invoke with index of button pressed\n 'Game Over', // title\n ['Restart','Exit'] // buttonLabels\n );\n \n\n### サポートされているプラットフォーム\n\n * アマゾン火 OS\n * アンドロイド\n * ブラックベリー 10\n * Firefox の OS\n * iOS\n * Tizen\n * Windows Phone 7 と 8\n * Windows 8\n * Windows\n\n### Windows Phone 7 と 8 癖\n\n * 組み込みブラウザーの機能はありません `window.confirm` が割り当てることによってバインドすることができます。\n \n window.confirm = navigator.notification.confirm;\n \n\n * 呼び出しを `alert` と `confirm` では非ブロッキング、結果は非同期的にのみ使用できます。\n\n### Windows の癖\n\n * Windows8/8.1 の MessageDialog インスタンスを 3 つ以上のボタンを追加することはできません。\n\n * Windows Phone 8.1 に 2 つ以上のボタンを持つダイアログを表示することはできません。\n\n### Firefox OS 互換:\n\nネイティブ ブロック `window.confirm()` と非ブロッキング `navigator.notification.confirm()` があります。\n\n## navigator.notification.prompt\n\nブラウザーの `プロンプト` 機能より詳細にカスタマイズはネイティブのダイアログ ボックスが表示されます。\n\n navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])\n \n\n * **メッセージ**: ダイアログ メッセージ。*(文字列)*\n\n * **promptCallback**: インデックス (1、2、または 3) を押されたボタンまたはダイアログ ボックスは、ボタンを押す （0） なしに解雇されたときに呼び出すコールバック。*(機能)*\n\n * **title**: タイトル *(String)* (省略可能、既定 `プロンプト` ダイアログ)\n\n * **buttonLabels**: ボタンのラベル *(配列)* (省略可能、既定値 `[\"OK\"、「キャンセル」]` を指定する文字列の配列)\n\n * **defaultText**: 既定テキスト ボックスの入力値 (`文字列`) (省略可能、既定: 空の文字列)\n\n### promptCallback\n\n`promptCallback` は、プロンプト ダイアログ ボックス内のボタンのいずれかを押したときに実行します。コールバックに渡される `results` オブジェクトには、次のプロパティが含まれています。\n\n * **buttonIndex**: 押されたボタンのインデックス。*(数)*インデックスがインデックス 1 ベースので、値は `1`、`2`、`3` などに注意してください。\n\n * **input1**: プロンプト ダイアログ ボックスに入力したテキスト。*(文字列)*\n\n### 例\n\n function onPrompt(results) {\n alert(\"You selected button number \" + results.buttonIndex + \" and entered \" + results.input1);\n }\n \n navigator.notification.prompt(\n 'Please enter your name', // message\n onPrompt, // callback to invoke\n 'Registration', // title\n ['Ok','Exit'], // buttonLabels\n 'Jane Doe' // defaultText\n );\n \n\n### サポートされているプラットフォーム\n\n * アマゾン火 OS\n * アンドロイド\n * Firefox の OS\n * iOS\n * Windows Phone 7 と 8\n * Windows 8\n * Windows\n\n### Android の癖\n\n * Android は最大 3 つのボタンをサポートしているし、それ以上無視します。\n\n * アンドロイド 3.0 と後、ホロのテーマを使用するデバイスを逆の順序でボタンが表示されます。\n\n### Windows の癖\n\n * Windows プロンプト ダイアログは html ベースのようなネイティブ api の不足のためです。\n\n### Firefox OS 互換:\n\nネイティブ ブロック `window.prompt()` と非ブロッキング `navigator.notification.prompt()` があります。\n\n## navigator.notification.beep\n\nデバイス サウンドをビープ音を再生します。\n\n navigator.notification.beep(times);\n \n\n * **times**: ビープ音を繰り返す回数。*(数)*\n\n### 例\n\n // Beep twice!\n navigator.notification.beep(2);\n \n\n### サポートされているプラットフォーム\n\n * アマゾン火 OS\n * アンドロイド\n * ブラックベリー 10\n * iOS\n * Tizen\n * Windows Phone 7 と 8\n * Windows 8\n\n### アマゾン火 OS 癖\n\n * アマゾン火 OS デフォルト **設定/表示 ＆ サウンド** パネルの下に指定した **通知音** を果たしています。\n\n### Android の癖\n\n * アンドロイド デフォルト **通知着信音** **設定/サウンド ＆ ディスプレイ** パネルの下に指定を果たしています。\n\n### Windows Phone 7 と 8 癖\n\n * コルドバ分布からジェネリック ビープ音ファイルに依存します。\n\n### Tizen の癖\n\n * Tizen は、メディア API 経由でオーディオ ファイルを再生してビープ音を実装します。\n\n * ビープ音ファイル短い、`sounds` アプリケーションのルート ディレクトリのサブディレクトリである必要があり。、`beep.wav` という名前である必要があります。."
},
{
"path": "plugins/cordova-plugin-dialogs/doc/ja/index.md",
"content": "\n\n# cordova-plugin-dialogs\n\nこのプラグインは、グローバル `navigator.notification` オブジェクトを介していくつかネイティブ ダイアログの UI 要素へのアクセスを提供します。\n\nオブジェクトは、グローバル スコープの `ナビゲーター` に添付、それがないまで `deviceready` イベントの後。\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(navigator.notification);\n }\n \n\n## インストール\n\n cordova plugin add cordova-plugin-dialogs\n \n\n## メソッド\n\n* `navigator.notification.alert`\n* `navigator.notification.confirm`\n* `navigator.notification.prompt`\n* `navigator.notification.beep`\n\n## navigator.notification.alert\n\nカスタムの警告またはダイアログ ボックスが表示されます。 ほとんどコルドバ ネイティブ] ダイアログ ボックスの使用この機能がいくつかのプラットフォームは通常小さいカスタマイズ可能なブラウザーの `警告` 機能を使用します。\n\n navigator.notification.alert(message, alertCallback, [title], [buttonName])\n \n\n* **メッセージ**: ダイアログ メッセージ。*(文字列)*\n\n* **alertCallback**: 警告ダイアログが閉じられたときに呼び出すコールバック。*(機能)*\n\n* **タイトル**: ダイアログのタイトル。*(文字列)*(省略可能、既定値は`Alert`)\n\n* **buttonName**: ボタンの名前。*(文字列)*(省略可能、既定値は`OK`)\n\n### 例\n\n function alertDismissed() {\n // do something\n }\n \n navigator.notification.alert(\n 'You are the winner!', // message\n alertDismissed, // callback\n 'Game Over', // title\n 'Done' // buttonName\n );\n \n\n### サポートされているプラットフォーム\n\n* アマゾン火 OS\n* アンドロイド\n* ブラックベリー 10\n* Firefox の OS\n* iOS\n* Tizen\n* Windows Phone 7 と 8\n* Windows 8\n* Windows\n\n### Windows Phone 7 と 8 癖\n\n* 組み込みのブラウザー警告がない呼び出しを次のように 1 つをバインドすることができます `alert()` 、グローバル スコープで。\n \n window.alert = navigator.notification.alert;\n \n\n* 両方の `alert` と `confirm` は非ブロッキング呼び出し、結果は非同期的にのみ利用できます。\n\n### Firefox OS 互換:\n\nネイティブ ブロック `window.alert()` と非ブロッキング `navigator.notification.alert()` があります。\n\n### ブラックベリー 10 癖\n\n`navigator.notification.alert ('text' コールバック 'title'、'text')` コールバック パラメーターは数 1 に渡されます。\n\n## navigator.notification.confirm\n\nカスタマイズ可能な確認のダイアログ ボックスが表示されます。\n\n navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])\n \n\n* **メッセージ**: ダイアログ メッセージ。*(文字列)*\n\n* **confirmCallback**: インデックス (1、2、または 3) を押されたボタンまたはダイアログ ボックスは、ボタンを押す （0） なしに解雇されたときに呼び出すコールバック。*(機能)*\n\n* **タイトル**: ダイアログのタイトル。*(文字列)*(省略可能、既定値は`Confirm`)\n\n* **buttonLabels**: ボタンのラベルを指定する文字列の配列。*(配列)*(省略可能、既定値は [ `OK,Cancel` ])\n\n### confirmCallback\n\n`confirmCallback` は、いずれかの確認ダイアログ ボックスでボタンを押したときに実行します。\n\nコールバックは、引数 `buttonIndex` *（番号）* は、押されたボタンのインデックス。 インデックスがインデックス 1 ベースので、値は `1`、`2`、`3` などに注意してください。\n\n### 例\n\n function onConfirm(buttonIndex) {\n alert('You selected button ' + buttonIndex);\n }\n \n navigator.notification.confirm(\n 'You are the winner!', // message\n onConfirm, // callback to invoke with index of button pressed\n 'Game Over', // title\n ['Restart','Exit'] // buttonLabels\n );\n \n\n### サポートされているプラットフォーム\n\n* アマゾン火 OS\n* アンドロイド\n* ブラックベリー 10\n* Firefox の OS\n* iOS\n* Tizen\n* Windows Phone 7 と 8\n* Windows 8\n* Windows\n\n### Windows Phone 7 と 8 癖\n\n* 組み込みブラウザーの機能はありません `window.confirm` が割り当てることによってバインドすることができます。\n \n window.confirm = navigator.notification.confirm;\n \n\n* 呼び出しを `alert` と `confirm` では非ブロッキング、結果は非同期的にのみ使用できます。\n\n### Windows の癖\n\n* Windows8/8.1 の MessageDialog インスタンスを 3 つ以上のボタンを追加することはできません。\n\n* Windows Phone 8.1 に 2 つ以上のボタンを持つダイアログを表示することはできません。\n\n### Firefox OS 互換:\n\nネイティブ ブロック `window.confirm()` と非ブロッキング `navigator.notification.confirm()` があります。\n\n## navigator.notification.prompt\n\nブラウザーの `プロンプト` 機能より詳細にカスタマイズはネイティブのダイアログ ボックスが表示されます。\n\n navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])\n \n\n* **message**: ダイアログ メッセージ。*(文字列)*\n\n* **promptCallback**: インデックス (1、2、または 3) を押されたボタンまたはダイアログ ボックスは、ボタンを押す （0） なしに解雇されたときに呼び出すコールバック。*(機能)*\n\n* **title**: タイトル *(String)* (省略可能、既定 `プロンプト` ダイアログ)\n\n* **buttonLabels**: ボタンのラベル *(配列)* (省略可能、既定値 `[\"OK\"、「キャンセル」]` を指定する文字列の配列)\n\n* **defaultText**: 既定テキスト ボックスの入力値 (`文字列`) (省略可能、既定: 空の文字列)\n\n### promptCallback\n\n`promptCallback` は、プロンプト ダイアログ ボックス内のボタンのいずれかを押したときに実行します。コールバックに渡される `results` オブジェクトには、次のプロパティが含まれています。\n\n* **buttonIndex**: 押されたボタンのインデックス。*(数)*インデックスがインデックス 1 ベースので、値は `1`、`2`、`3` などに注意してください。\n\n* **input1**: プロンプト ダイアログ ボックスに入力したテキスト。*(文字列)*\n\n### 例\n\n function onPrompt(results) {\n alert(\"You selected button number \" + results.buttonIndex + \" and entered \" + results.input1);\n }\n \n navigator.notification.prompt(\n 'Please enter your name', // message\n onPrompt, // callback to invoke\n 'Registration', // title\n ['Ok','Exit'], // buttonLabels\n 'Jane Doe' // defaultText\n );\n \n\n### サポートされているプラットフォーム\n\n* アマゾン火 OS\n* アンドロイド\n* Firefox の OS\n* iOS\n* Windows Phone 7 と 8\n* Windows 8\n* Windows\n\n### Android の癖\n\n* Android は最大 3 つのボタンをサポートしているし、それ以上無視します。\n\n* アンドロイド 3.0 と後、ホロのテーマを使用するデバイスを逆の順序でボタンが表示されます。\n\n### Windows の癖\n\n* Windows プロンプト ダイアログは html ベースのようなネイティブ api の不足のためです。\n\n### Firefox OS 互換:\n\nネイティブ ブロック `window.prompt()` と非ブロッキング `navigator.notification.prompt()` があります。\n\n## navigator.notification.beep\n\nデバイス サウンドをビープ音を再生します。\n\n navigator.notification.beep(times);\n \n\n* **times**: ビープ音を繰り返す回数。*(数)*\n\n### 例\n\n // Beep twice!\n navigator.notification.beep(2);\n \n\n### サポートされているプラットフォーム\n\n* アマゾン火 OS\n* アンドロイド\n* ブラックベリー 10\n* iOS\n* Tizen\n* Windows Phone 7 と 8\n* Windows 8\n\n### アマゾン火 OS 癖\n\n* アマゾン火 OS デフォルト **設定/表示 ＆ サウンド** パネルの下に指定した **通知音** を果たしています。\n\n### Android の癖\n\n* アンドロイド デフォルト **通知着信音** **設定/サウンド ＆ ディスプレイ** パネルの下に指定を果たしています。\n\n### Windows Phone 7 と 8 癖\n\n* コルドバ分布からジェネリック ビープ音ファイルに依存します。\n\n### Tizen の癖\n\n* Tizen は、メディア API 経由でオーディオ ファイルを再生してビープ音を実装します。\n\n* ビープ音ファイル短い、`sounds` アプリケーションのルート ディレクトリのサブディレクトリである必要があり。、`beep.wav` という名前である必要があります。.\n"
},
{
"path": "plugins/cordova-plugin-dialogs/doc/ko/README.md",
"content": "\n\n# cordova-plugin-dialogs\n\n[](https://travis-ci.org/apache/cordova-plugin-dialogs)\n\n이 플러그인 글로벌 `navigator.notification` 개체를 통해 몇 가지 기본 대화 상자 UI 요소에 액세스할 수 있습니다.\n\n개체 `navigator` 글로벌 범위 첨부 아니에요 때까지 사용할 수 있는 `deviceready` 이벤트 후.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(navigator.notification);\n }\n \n\n## 설치\n\n cordova plugin add cordova-plugin-dialogs\n \n\n## 메서드\n\n * `navigator.notification.alert`\n * `navigator.notification.confirm`\n * `navigator.notification.prompt`\n * `navigator.notification.beep`\n\n## navigator.notification.alert\n\n사용자 지정 경고 또는 대화 상자를 보여 줍니다. 이 기능에 대 한 기본 대화 상자를 사용 하는 대부분의 코르도바 구현 하지만 일부 플랫폼은 일반적으로 덜 사용자 정의할 수 있는 브라우저의 `alert` 기능을 사용 합니다.\n\n navigator.notification.alert(message, alertCallback, [title], [buttonName])\n \n\n * **message**: 대화 메시지. *(문자열)*\n\n * **alertCallback**: 콜백을 호출할 때 경고 대화 기 각. *(기능)*\n\n * **title**: 제목 대화 상자. *(문자열)* (옵션, 기본값:`Alert`)\n\n * **buttonName**: 단추 이름. *(문자열)* (옵션, 기본값:`OK`)\n\n### 예를 들어\n\n function alertDismissed() {\n // do something\n }\n \n navigator.notification.alert(\n 'You are the winner!', // message\n alertDismissed, // callback\n 'Game Over', // title\n 'Done' // buttonName\n );\n \n\n### 지원 되는 플랫폼\n\n * 아마존 화재 운영 체제\n * 안 드 로이드\n * 블랙베리 10\n * Firefox 운영 체제\n * iOS\n * Tizen\n * Windows Phone 7과 8\n * 윈도우 8\n * 윈도우\n\n### Windows Phone 7, 8 특수\n\n * 아니 내장 브라우저 경고 하지만 다음과 같이 전화를 바인딩할 수 있습니다 `alert()` 전역 범위에서:\n \n window.alert = navigator.notification.alert;\n \n\n * 둘 다 `alert` 와 `confirm` 는 비차단 호출, 결과 비동기적으로 사용할 수 있습니다.\n\n### 파이어 폭스 OS 단점:\n\n기본 차단 `window.alert()` 및 차단 되지 않은 `navigator.notification.alert()` 사용할 수 있습니다.\n\n### 블랙베리 10 단점\n\n`navigator.notification.alert ('텍스트', 콜백, '제목', '텍스트')` 콜백 매개 변수 1 번을 전달 됩니다.\n\n## navigator.notification.confirm\n\n사용자 정의 확인 대화 상자가 표시 됩니다.\n\n navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])\n \n\n * **message**: 대화 메시지. *(문자열)*\n\n * **confirmCallback**: 인덱스 버튼 (1, 2 또는 3) 또는 대화 상자 버튼을 누르면 (0) 없이 기 각 될 때 호출할 콜백 합니다. *(기능)*\n\n * **title**: 제목 대화 상자. *(문자열)* (옵션, 기본값:`Confirm`)\n\n * **buttonLabels**: 단추 레이블을 지정 하는 문자열 배열입니다. *(배열)* (옵션, 기본값은 [ `OK,Cancel` ])\n\n### confirmCallback\n\n`confirmCallback`는 사용자가 확인 대화 상자에서 단추 중 하나를 누를 때 실행 합니다.\n\n콜백이 걸립니다 인수 `buttonIndex` *(번호)를* 누르면된 버튼의 인덱스입니다. Note 인덱스에서는 인덱싱 1 시작 값은 `1`, `2`, `3`, 등등.\n\n### 예를 들어\n\n function onConfirm(buttonIndex) {\n alert('You selected button ' + buttonIndex);\n }\n \n navigator.notification.confirm(\n 'You are the winner!', // message\n onConfirm, // callback to invoke with index of button pressed\n 'Game Over', // title\n ['Restart','Exit'] // buttonLabels\n );\n \n\n### 지원 되는 플랫폼\n\n * 아마존 화재 운영 체제\n * 안 드 로이드\n * 블랙베리 10\n * Firefox 운영 체제\n * iOS\n * Tizen\n * Windows Phone 7과 8\n * 윈도우 8\n * 윈도우\n\n### Windows Phone 7, 8 특수\n\n * 에 대 한 기본 제공 브라우저 함수가 `window.confirm` , 그러나 할당 하 여 바인딩할 수 있습니다:\n \n window.confirm = navigator.notification.confirm;\n \n\n * 호출 `alert` 및 `confirm` 되므로 차단 되지 않은 결과만 비동기적으로 사용할 수 있습니다.\n\n### 윈도우 특수\n\n * Windows8/8.1에 3 개 이상 단추 MessageDialog 인스턴스를 추가할 수는 없습니다.\n\n * Windows Phone 8.1에 두 개 이상의 단추와 대화 상자 표시 수는 없습니다.\n\n### 파이어 폭스 OS 단점:\n\n기본 차단 `window.confirm()` 및 차단 되지 않은 `navigator.notification.confirm()` 사용할 수 있습니다.\n\n## navigator.notification.prompt\n\n브라우저의 `프롬프트` 함수 보다 더 많은 사용자 정의 기본 대화 상자가 표시 됩니다.\n\n navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])\n \n\n * **message**: 대화 메시지. *(문자열)*\n\n * **promptCallback**: 인덱스 버튼 (1, 2 또는 3) 또는 대화 상자 버튼을 누르면 (0) 없이 기 각 될 때 호출할 콜백 합니다. *(기능)*\n\n * **title**: 제목 대화 상자. *(문자열)* (옵션, 기본값:`Prompt`)\n\n * **buttonLabels**: 버튼 레이블 *(배열)* (옵션, 기본값 `[\"확인\", \"취소\"]을` 지정 하는 문자열의 배열)\n\n * **defaultText**: 기본 텍스트 상자에 값 (`문자열`) 입력 (옵션, 기본값: 빈 문자열)\n\n### promptCallback\n\n`promptCallback`는 사용자가 프롬프트 대화 상자에서 단추 중 하나를 누를 때 실행 합니다. 콜백에 전달 된 `results` 개체에는 다음 속성이 포함 되어 있습니다.\n\n * **buttonIndex**: 눌려진된 버튼의 인덱스. *(수)* Note 인덱스에서는 인덱싱 1 시작 값은 `1`, `2`, `3`, 등등.\n\n * **input1**: 프롬프트 대화 상자에 입력 한 텍스트. *(문자열)*\n\n### 예를 들어\n\n function onPrompt(results) {\n alert(\"You selected button number \" + results.buttonIndex + \" and entered \" + results.input1);\n }\n \n navigator.notification.prompt(\n 'Please enter your name', // message\n onPrompt, // callback to invoke\n 'Registration', // title\n ['Ok','Exit'], // buttonLabels\n 'Jane Doe' // defaultText\n );\n \n\n### 지원 되는 플랫폼\n\n * 아마존 화재 운영 체제\n * 안 드 로이드\n * Firefox 운영 체제\n * iOS\n * Windows Phone 7과 8\n * 윈도우 8\n * 윈도우\n\n### 안 드 로이드 단점\n\n * 안 드 로이드 최대 3 개의 단추를 지원 하 고 그것 보다는 더 이상 무시 합니다.\n\n * 안 드 로이드 3.0 및 나중에, 단추는 홀로 테마를 사용 하는 장치에 대 한 반대 순서로 표시 됩니다.\n\n### 윈도우 특수\n\n * 윈도우에서 프롬프트 대화 같은 네이티브 api의 부족으로 인해 html 기반 이다.\n\n### 파이어 폭스 OS 단점:\n\n기본 차단 `window.prompt()` 및 차단 되지 않은 `navigator.notification.prompt()` 사용할 수 있습니다.\n\n## navigator.notification.beep\n\n장치는 경고음 소리를 재생 합니다.\n\n navigator.notification.beep(times);\n \n\n * **times**: 경고음을 반복 하는 횟수. *(수)*\n\n### 예를 들어\n\n // Beep twice!\n navigator.notification.beep(2);\n \n\n### 지원 되는 플랫폼\n\n * 아마존 화재 운영 체제\n * 안 드 로이드\n * 블랙베리 10\n * iOS\n * Tizen\n * Windows Phone 7과 8\n * 윈도우 8\n\n### 아마존 화재 OS 단점\n\n * 아마존 화재 운영 체제 기본 **설정/디스플레이 및 사운드** 패널에 지정 된 **알림 소리** 재생 됩니다.\n\n### 안 드 로이드 단점\n\n * 안 드 로이드 기본 **알림 벨소리** **설정/사운드 및 디스플레이** 패널에서 지정 합니다.\n\n### Windows Phone 7, 8 특수\n\n * 코르 도우 바 분포에서 일반 경고음 파일에 의존합니다.\n\n### Tizen 특수\n\n * Tizen은 미디어 API 통해 오디오 파일을 재생 하 여 경고음을 구현 합니다.\n\n * 경고음 파일 짧은 되어야 합니다, 응용 프로그램의 루트 디렉터리의 `소리` 하위 디렉터리에 위치 해야 합니다 및 `beep.wav`는 명명 된."
},
{
"path": "plugins/cordova-plugin-dialogs/doc/ko/index.md",
"content": "\n\n# cordova-plugin-dialogs\n\n이 플러그인 글로벌 `navigator.notification` 개체를 통해 몇 가지 기본 대화 상자 UI 요소에 액세스할 수 있습니다.\n\n개체 `navigator` 글로벌 범위 첨부 아니에요 때까지 사용할 수 있는 `deviceready` 이벤트 후.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(navigator.notification);\n }\n \n\n## 설치\n\n cordova plugin add cordova-plugin-dialogs\n \n\n## 메서드\n\n* `navigator.notification.alert`\n* `navigator.notification.confirm`\n* `navigator.notification.prompt`\n* `navigator.notification.beep`\n\n## navigator.notification.alert\n\n사용자 지정 경고 또는 대화 상자를 보여 줍니다. 이 기능에 대 한 기본 대화 상자를 사용 하는 대부분의 코르도바 구현 하지만 일부 플랫폼은 일반적으로 덜 사용자 정의할 수 있는 브라우저의 `alert` 기능을 사용 합니다.\n\n navigator.notification.alert(message, alertCallback, [title], [buttonName])\n \n\n* **message**: 대화 메시지. *(문자열)*\n\n* **alertCallback**: 콜백을 호출할 때 경고 대화 기 각. *(기능)*\n\n* **title**: 제목 대화 상자. *(문자열)* (옵션, 기본값:`Alert`)\n\n* **buttonName**: 단추 이름. *(문자열)* (옵션, 기본값:`OK`)\n\n### 예를 들어\n\n function alertDismissed() {\n // do something\n }\n \n navigator.notification.alert(\n 'You are the winner!', // message\n alertDismissed, // callback\n 'Game Over', // title\n 'Done' // buttonName\n );\n \n\n### 지원 되는 플랫폼\n\n* 아마존 화재 운영 체제\n* 안 드 로이드\n* 블랙베리 10\n* Firefox 운영 체제\n* iOS\n* Tizen\n* Windows Phone 7과 8\n* 윈도우 8\n* 윈도우\n\n### Windows Phone 7, 8 특수\n\n* 아니 내장 브라우저 경고 하지만 다음과 같이 전화를 바인딩할 수 있습니다 `alert()` 전역 범위에서:\n \n window.alert = navigator.notification.alert;\n \n\n* 둘 다 `alert` 와 `confirm` 는 비차단 호출, 결과 비동기적으로 사용할 수 있습니다.\n\n### 파이어 폭스 OS 단점:\n\n기본 차단 `window.alert()` 및 차단 되지 않은 `navigator.notification.alert()` 사용할 수 있습니다.\n\n### 블랙베리 10 단점\n\n`navigator.notification.alert ('텍스트', 콜백, '제목', '텍스트')` 콜백 매개 변수 1 번을 전달 됩니다.\n\n## navigator.notification.confirm\n\n사용자 정의 확인 대화 상자가 표시 됩니다.\n\n navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])\n \n\n* **message**: 대화 메시지. *(문자열)*\n\n* **confirmCallback**: 인덱스 버튼 (1, 2 또는 3) 또는 대화 상자 버튼을 누르면 (0) 없이 기 각 될 때 호출할 콜백 합니다. *(기능)*\n\n* **title**: 제목 대화 상자. *(문자열)* (옵션, 기본값:`Confirm`)\n\n* **buttonLabels**: 단추 레이블을 지정 하는 문자열 배열입니다. *(배열)* (옵션, 기본값은 [ `OK,Cancel` ])\n\n### confirmCallback\n\n`confirmCallback`는 사용자가 확인 대화 상자에서 단추 중 하나를 누를 때 실행 합니다.\n\n콜백이 걸립니다 인수 `buttonIndex` *(번호)를* 누르면된 버튼의 인덱스입니다. Note 인덱스에서는 인덱싱 1 시작 값은 `1`, `2`, `3`, 등등.\n\n### 예를 들어\n\n function onConfirm(buttonIndex) {\n alert('You selected button ' + buttonIndex);\n }\n \n navigator.notification.confirm(\n 'You are the winner!', // message\n onConfirm, // callback to invoke with index of button pressed\n 'Game Over', // title\n ['Restart','Exit'] // buttonLabels\n );\n \n\n### 지원 되는 플랫폼\n\n* 아마존 화재 운영 체제\n* 안 드 로이드\n* 블랙베리 10\n* Firefox 운영 체제\n* iOS\n* Tizen\n* Windows Phone 7과 8\n* 윈도우 8\n* 윈도우\n\n### Windows Phone 7, 8 특수\n\n* 에 대 한 기본 제공 브라우저 함수가 `window.confirm` , 그러나 할당 하 여 바인딩할 수 있습니다:\n \n window.confirm = navigator.notification.confirm;\n \n\n* 호출 `alert` 및 `confirm` 되므로 차단 되지 않은 결과만 비동기적으로 사용할 수 있습니다.\n\n### 윈도우 특수\n\n* Windows8/8.1에 3 개 이상 단추 MessageDialog 인스턴스를 추가할 수는 없습니다.\n\n* Windows Phone 8.1에 두 개 이상의 단추와 대화 상자 표시 수는 없습니다.\n\n### 파이어 폭스 OS 단점:\n\n기본 차단 `window.confirm()` 및 차단 되지 않은 `navigator.notification.confirm()` 사용할 수 있습니다.\n\n## navigator.notification.prompt\n\n브라우저의 `프롬프트` 함수 보다 더 많은 사용자 정의 기본 대화 상자가 표시 됩니다.\n\n navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])\n \n\n* **message**: 대화 메시지. *(문자열)*\n\n* **promptCallback**: 인덱스 버튼 (1, 2 또는 3) 또는 대화 상자 버튼을 누르면 (0) 없이 기 각 될 때 호출할 콜백 합니다. *(기능)*\n\n* **title**: 제목 대화 상자. *(문자열)* (옵션, 기본값:`Prompt`)\n\n* **buttonLabels**: 버튼 레이블 *(배열)* (옵션, 기본값 `[\"확인\", \"취소\"]을` 지정 하는 문자열의 배열)\n\n* **defaultText**: 기본 텍스트 상자에 값 (`문자열`) 입력 (옵션, 기본값: 빈 문자열)\n\n### promptCallback\n\n`promptCallback`는 사용자가 프롬프트 대화 상자에서 단추 중 하나를 누를 때 실행 합니다. 콜백에 전달 된 `results` 개체에는 다음 속성이 포함 되어 있습니다.\n\n* **buttonIndex**: 눌려진된 버튼의 인덱스. *(수)* Note 인덱스에서는 인덱싱 1 시작 값은 `1`, `2`, `3`, 등등.\n\n* **input1**: 프롬프트 대화 상자에 입력 한 텍스트. *(문자열)*\n\n### 예를 들어\n\n function onPrompt(results) {\n alert(\"You selected button number \" + results.buttonIndex + \" and entered \" + results.input1);\n }\n \n navigator.notification.prompt(\n 'Please enter your name', // message\n onPrompt, // callback to invoke\n 'Registration', // title\n ['Ok','Exit'], // buttonLabels\n 'Jane Doe' // defaultText\n );\n \n\n### 지원 되는 플랫폼\n\n* 아마존 화재 운영 체제\n* 안 드 로이드\n* Firefox 운영 체제\n* iOS\n* Windows Phone 7과 8\n* 윈도우 8\n* 윈도우\n\n### 안 드 로이드 단점\n\n* 안 드 로이드 최대 3 개의 단추를 지원 하 고 그것 보다는 더 이상 무시 합니다.\n\n* 안 드 로이드 3.0 및 나중에, 단추는 홀로 테마를 사용 하는 장치에 대 한 반대 순서로 표시 됩니다.\n\n### 윈도우 특수\n\n* 윈도우에서 프롬프트 대화 같은 네이티브 api의 부족으로 인해 html 기반 이다.\n\n### 파이어 폭스 OS 단점:\n\n기본 차단 `window.prompt()` 및 차단 되지 않은 `navigator.notification.prompt()` 사용할 수 있습니다.\n\n## navigator.notification.beep\n\n장치는 경고음 소리를 재생 합니다.\n\n navigator.notification.beep(times);\n \n\n* **times**: 경고음을 반복 하는 횟수. *(수)*\n\n### 예를 들어\n\n // Beep twice!\n navigator.notification.beep(2);\n \n\n### 지원 되는 플랫폼\n\n* 아마존 화재 운영 체제\n* 안 드 로이드\n* 블랙베리 10\n* iOS\n* Tizen\n* Windows Phone 7과 8\n* 윈도우 8\n\n### 아마존 화재 OS 단점\n\n* 아마존 화재 운영 체제 기본 **설정/디스플레이 및 사운드** 패널에 지정 된 **알림 소리** 재생 됩니다.\n\n### 안 드 로이드 단점\n\n* 안 드 로이드 기본 **알림 벨소리** **설정/사운드 및 디스플레이** 패널에서 지정 합니다.\n\n### Windows Phone 7, 8 특수\n\n* 코르 도우 바 분포에서 일반 경고음 파일에 의존합니다.\n\n### Tizen 특수\n\n* Tizen은 미디어 API 통해 오디오 파일을 재생 하 여 경고음을 구현 합니다.\n\n* 경고음 파일 짧은 되어야 합니다, 응용 프로그램의 루트 디렉터리의 `소리` 하위 디렉터리에 위치 해야 합니다 및 `beep.wav`는 명명 된.\n"
},
{
"path": "plugins/cordova-plugin-dialogs/doc/pl/README.md",
"content": "\n\n# cordova-plugin-dialogs\n\n[](https://travis-ci.org/apache/cordova-plugin-dialogs)\n\nTen plugin umożliwia dostęp do niektórych rodzimych okna dialogowego elementy interfejsu użytkownika za pośrednictwem obiektu globalnego `navigator.notification`.\n\nMimo, że obiekt jest dołączony do globalnego zakresu `navigator`, to nie dostępne dopiero po zdarzeniu `deviceready`.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(navigator.notification);\n }\n \n\n## Instalacja\n\n cordova plugin add cordova-plugin-dialogs\n \n\n## Metody\n\n * `navigator.notification.alert`\n * `navigator.notification.confirm`\n * `navigator.notification.prompt`\n * `navigator.notification.beep`\n\n## navigator.notification.alert\n\nPokazuje niestandardowe wpisu lub okno dialogowe. Większość implementacji Cordova używać rodzimych okno dialogowe dla tej funkcji, ale niektóre platformy używać przeglądarki `alert` funkcji, która jest zazwyczaj mniej konfigurowalny.\n\n navigator.notification.alert(message, alertCallback, [title], [buttonName])\n \n\n * **wiadomość**: komunikat okna dialogowego. *(String)*\n\n * **alertCallback**: wywołanie zwrotne do wywołania, gdy okno dialogowe alert jest oddalona. *(Funkcja)*\n\n * **tytuł**: okno tytuł. *(String)* (Opcjonalna, domyślnie`Alert`)\n\n * **buttonName**: Nazwa przycisku. *(String)* (Opcjonalna, domyślnie`OK`)\n\n### Przykład\n\n function alertDismissed() {\n // do something\n }\n \n navigator.notification.alert(\n 'You are the winner!', // message\n alertDismissed, // callback\n 'Game Over', // title\n 'Done' // buttonName\n );\n \n\n### Obsługiwane platformy\n\n * Amazon Fire OS\n * Android\n * BlackBerry 10\n * Firefox OS\n * iOS\n * Tizen\n * Windows Phone 7 i 8\n * Windows 8\n * Windows\n\n### Windows Phone 7 i 8 dziwactwa\n\n * Istnieje wpis nie wbudowana przeglądarka, ale można powiązać w następujący sposób na wywołanie `alert()` w globalnym zasięgu:\n \n window.alert = navigator.notification.alert;\n \n\n * Zarówno `alert` i `confirm` są bez blokowania połączeń, których wyniki są tylko dostępne asynchronicznie.\n\n### Firefox OS dziwactwa:\n\nDostępne są zarówno rodzimych blokuje `window.alert()` i bez blokowania `navigator.notification.alert()`.\n\n### Jeżyna 10 dziwactwa\n\nparametr wywołania zwrotnego `Navigator.Notification.alert (\"tekst\", wywołanie zwrotne, 'tytuł', 'tekst')` jest przekazywana numer 1.\n\n## navigator.notification.confirm\n\nWyświetla okno dialogowe potwierdzenia konfigurowalny.\n\n navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])\n \n\n * **wiadomość**: komunikat okna dialogowego. *(String)*\n\n * **confirmCallback**: wywołanie zwrotne do wywołania z indeksu z przycisku (1, 2 lub 3), lub gdy okno jest zwolniony bez naciśnij przycisk (0). *(Funkcja)*\n\n * **tytuł**: okno tytuł. *(String)* (Opcjonalna, domyślnie`Confirm`)\n\n * **buttonLabels**: tablica ciągów, określając etykiety przycisków. *(Tablica)* (Opcjonalna, domyślnie [ `OK,Cancel` ])\n\n### confirmCallback\n\n`confirmCallback` wykonuje, gdy użytkownik naciśnie klawisz jeden z przycisków w oknie dialogowym potwierdzenia.\n\nWywołanie zwrotne wymaga argumentu `buttonIndex` *(numer)*, który jest indeksem wciśnięty przycisk. Należy zauważyć, że indeks używa, na podstawie jednego indeksowania, więc wartością jest `1`, `2`, `3` itd.\n\n### Przykład\n\n function onConfirm(buttonIndex) {\n alert('You selected button ' + buttonIndex);\n }\n \n navigator.notification.confirm(\n 'You are the winner!', // message\n onConfirm, // callback to invoke with index of button pressed\n 'Game Over', // title\n ['Restart','Exit'] // buttonLabels\n );\n \n\n### Obsługiwane platformy\n\n * Amazon Fire OS\n * Android\n * BlackBerry 10\n * Firefox OS\n * iOS\n * Tizen\n * Windows Phone 7 i 8\n * Windows 8\n * Windows\n\n### Windows Phone 7 i 8 dziwactwa\n\n * Istnieje funkcja wbudowana przeglądarka nie `window.confirm` , ale można go powiązać przypisując:\n \n window.confirm = navigator.notification.confirm;\n \n\n * Wzywa do `alert` i `confirm` są bez blokowania, więc wynik jest tylko dostępnych asynchronicznie.\n\n### Windows dziwactwa\n\n * Na Windows8/8.1 to nie można dodać więcej niż trzy przyciski do instancji MessageDialog.\n\n * Na Windows Phone 8.1 nie jest możliwe wyświetlić okno dialogowe z więcej niż dwoma przyciskami.\n\n### Firefox OS dziwactwa:\n\nDostępne są zarówno rodzimych blokuje `window.confirm()` i bez blokowania `navigator.notification.confirm()`.\n\n## navigator.notification.prompt\n\nWyświetla okno dialogowe macierzystego, który bardziej niż przeglądarki `prompt` funkcja.\n\n navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])\n \n\n * **wiadomość**: komunikat okna dialogowego. *(String)*\n\n * **promptCallback**: wywołanie zwrotne do wywołania z indeksu z przycisku (1, 2 lub 3), lub gdy okno jest zwolniony bez naciśnij przycisk (0). *(Funkcja)*\n\n * **title**: okno tytuł *(String)* (opcjonalna, domyślnie `polecenia`)\n\n * **buttonLabels**: tablica ciągów, określając przycisk etykiety *(tablica)* (opcjonalna, domyślnie `[\"OK\", \"Anuluj\"]`)\n\n * **defaultText**: domyślnie pole tekstowe wprowadzania wartości (`String`) (opcjonalna, domyślnie: pusty ciąg)\n\n### promptCallback\n\n`promptCallback` wykonuje, gdy użytkownik naciśnie klawisz jeden z przycisków w oknie dialogowym polecenia. Obiektu `results` przekazane do wywołania zwrotnego zawiera następujące właściwości:\n\n * **buttonIndex**: indeks wciśnięty przycisk. *(Liczba)* Należy zauważyć, że indeks używa, na podstawie jednego indeksowania, więc wartością jest `1`, `2`, `3` itd.\n\n * **input1**: Tekst wprowadzony w oknie polecenia. *(String)*\n\n### Przykład\n\n function onPrompt(results) {\n alert(\"You selected button number \" + results.buttonIndex + \" and entered \" + results.input1);\n }\n \n navigator.notification.prompt(\n 'Please enter your name', // message\n onPrompt, // callback to invoke\n 'Registration', // title\n ['Ok','Exit'], // buttonLabels\n 'Jane Doe' // defaultText\n );\n \n\n### Obsługiwane platformy\n\n * Amazon Fire OS\n * Android\n * Firefox OS\n * iOS\n * Windows Phone 7 i 8\n * Windows 8\n * Windows\n\n### Dziwactwa Androida\n\n * Android obsługuje maksymalnie trzy przyciski i więcej niż to ignoruje.\n\n * Android 3.0 i nowszych przyciski są wyświetlane w kolejności odwrotnej do urządzenia, które używają tematu Holo.\n\n### Windows dziwactwa\n\n * W systemie Windows wierzyciel okno jest oparte na języku html, ze względu na brak takich natywnego api.\n\n### Firefox OS dziwactwa:\n\nDostępne są zarówno rodzimych blokuje `window.prompt()` i bez blokowania `navigator.notification.prompt()`.\n\n## navigator.notification.beep\n\nUrządzenie odtwarza sygnał ciągły dźwięk.\n\n navigator.notification.beep(times);\n \n\n * **times**: liczba powtórzeń po sygnale. *(Liczba)*\n\n### Przykład\n\n // Beep twice!\n navigator.notification.beep(2);\n \n\n### Obsługiwane platformy\n\n * Amazon Fire OS\n * Android\n * BlackBerry 10\n * iOS\n * Tizen\n * Windows Phone 7 i 8\n * Windows 8\n\n### Amazon ogień OS dziwactwa\n\n * Amazon ogień OS gra domyślny **Dźwięk powiadomienia** określone w panelu **ekranu/ustawienia i dźwięk**.\n\n### Dziwactwa Androida\n\n * Android gra domyślnie **dzwonek powiadomienia** określone w panelu **ustawień/dźwięk i wyświetlacz**.\n\n### Windows Phone 7 i 8 dziwactwa\n\n * Opiera się na pliku rodzajowego sygnał z rozkładu Cordova.\n\n### Dziwactwa Tizen\n\n * Tizen implementuje dźwięków przez odtwarzania pliku audio za pośrednictwem mediów API.\n\n * Plik dźwiękowy muszą być krótkie, musi znajdować się w podkatalogu `dźwięki` w katalogu głównym aplikacji i musi być o nazwie `beep.wav`."
},
{
"path": "plugins/cordova-plugin-dialogs/doc/pl/index.md",
"content": "\n\n# cordova-plugin-dialogs\n\nTen plugin umożliwia dostęp do niektórych rodzimych okna dialogowego elementy interfejsu użytkownika za pośrednictwem obiektu globalnego `navigator.notification`.\n\nMimo, że obiekt jest dołączony do globalnego zakresu `navigator`, to nie dostępne dopiero po zdarzeniu `deviceready`.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(navigator.notification);\n }\n \n\n## Instalacja\n\n cordova plugin add cordova-plugin-dialogs\n \n\n## Metody\n\n* `navigator.notification.alert`\n* `navigator.notification.confirm`\n* `navigator.notification.prompt`\n* `navigator.notification.beep`\n\n## navigator.notification.alert\n\nPokazuje niestandardowe wpisu lub okno dialogowe. Większość implementacji Cordova używać rodzimych okno dialogowe dla tej funkcji, ale niektóre platformy używać przeglądarki `alert` funkcji, która jest zazwyczaj mniej konfigurowalny.\n\n navigator.notification.alert(message, alertCallback, [title], [buttonName])\n \n\n* **wiadomość**: komunikat okna dialogowego. *(String)*\n\n* **alertCallback**: wywołanie zwrotne do wywołania, gdy okno dialogowe alert jest oddalona. *(Funkcja)*\n\n* **tytuł**: okno tytuł. *(String)* (Opcjonalna, domyślnie`Alert`)\n\n* **buttonName**: Nazwa przycisku. *(String)* (Opcjonalna, domyślnie`OK`)\n\n### Przykład\n\n function alertDismissed() {\n // do something\n }\n \n navigator.notification.alert(\n 'You are the winner!', // message\n alertDismissed, // callback\n 'Game Over', // title\n 'Done' // buttonName\n );\n \n\n### Obsługiwane platformy\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 i 8\n* Windows 8\n* Windows\n\n### Windows Phone 7 i 8 dziwactwa\n\n* Istnieje wpis nie wbudowana przeglądarka, ale można powiązać w następujący sposób na wywołanie `alert()` w globalnym zasięgu:\n \n window.alert = navigator.notification.alert;\n \n\n* Zarówno `alert` i `confirm` są bez blokowania połączeń, których wyniki są tylko dostępne asynchronicznie.\n\n### Firefox OS dziwactwa:\n\nDostępne są zarówno rodzimych blokuje `window.alert()` i bez blokowania `navigator.notification.alert()`.\n\n### Jeżyna 10 dziwactwa\n\nparametr wywołania zwrotnego `Navigator.Notification.alert (\"tekst\", wywołanie zwrotne, 'tytuł', 'tekst')` jest przekazywana numer 1.\n\n## navigator.notification.confirm\n\nWyświetla okno dialogowe potwierdzenia konfigurowalny.\n\n navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])\n \n\n* **wiadomość**: komunikat okna dialogowego. *(String)*\n\n* **confirmCallback**: wywołanie zwrotne do wywołania z indeksu z przycisku (1, 2 lub 3), lub gdy okno jest zwolniony bez naciśnij przycisk (0). *(Funkcja)*\n\n* **tytuł**: okno tytuł. *(String)* (Opcjonalna, domyślnie`Confirm`)\n\n* **buttonLabels**: tablica ciągów, określając etykiety przycisków. *(Tablica)* (Opcjonalna, domyślnie [ `OK,Cancel` ])\n\n### confirmCallback\n\n`confirmCallback` wykonuje, gdy użytkownik naciśnie klawisz jeden z przycisków w oknie dialogowym potwierdzenia.\n\nWywołanie zwrotne wymaga argumentu `buttonIndex` *(numer)*, który jest indeksem wciśnięty przycisk. Należy zauważyć, że indeks używa, na podstawie jednego indeksowania, więc wartością jest `1`, `2`, `3` itd.\n\n### Przykład\n\n function onConfirm(buttonIndex) {\n alert('You selected button ' + buttonIndex);\n }\n \n navigator.notification.confirm(\n 'You are the winner!', // message\n onConfirm, // callback to invoke with index of button pressed\n 'Game Over', // title\n ['Restart','Exit'] // buttonLabels\n );\n \n\n### Obsługiwane platformy\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 i 8\n* Windows 8\n* Windows\n\n### Windows Phone 7 i 8 dziwactwa\n\n* Istnieje funkcja wbudowana przeglądarka nie `window.confirm` , ale można go powiązać przypisując:\n \n window.confirm = navigator.notification.confirm;\n \n\n* Wzywa do `alert` i `confirm` są bez blokowania, więc wynik jest tylko dostępnych asynchronicznie.\n\n### Windows dziwactwa\n\n* Na Windows8/8.1 to nie można dodać więcej niż trzy przyciski do instancji MessageDialog.\n\n* Na Windows Phone 8.1 nie jest możliwe wyświetlić okno dialogowe z więcej niż dwoma przyciskami.\n\n### Firefox OS dziwactwa:\n\nDostępne są zarówno rodzimych blokuje `window.confirm()` i bez blokowania `navigator.notification.confirm()`.\n\n## navigator.notification.prompt\n\nWyświetla okno dialogowe macierzystego, który bardziej niż przeglądarki `prompt` funkcja.\n\n navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])\n \n\n* **message**: komunikat okna dialogowego. *(String)*\n\n* **promptCallback**: wywołanie zwrotne do wywołania z indeksu z przycisku (1, 2 lub 3), lub gdy okno jest zwolniony bez naciśnij przycisk (0). *(Funkcja)*\n\n* **title**: okno tytuł *(String)* (opcjonalna, domyślnie `polecenia`)\n\n* **buttonLabels**: tablica ciągów, określając przycisk etykiety *(tablica)* (opcjonalna, domyślnie `[\"OK\", \"Anuluj\"]`)\n\n* **defaultText**: domyślnie pole tekstowe wprowadzania wartości (`String`) (opcjonalna, domyślnie: pusty ciąg)\n\n### promptCallback\n\n`promptCallback` wykonuje, gdy użytkownik naciśnie klawisz jeden z przycisków w oknie dialogowym polecenia. Obiektu `results` przekazane do wywołania zwrotnego zawiera następujące właściwości:\n\n* **buttonIndex**: indeks wciśnięty przycisk. *(Liczba)* Należy zauważyć, że indeks używa, na podstawie jednego indeksowania, więc wartością jest `1`, `2`, `3` itd.\n\n* **input1**: Tekst wprowadzony w oknie polecenia. *(String)*\n\n### Przykład\n\n function onPrompt(results) {\n alert(\"You selected button number \" + results.buttonIndex + \" and entered \" + results.input1);\n }\n \n navigator.notification.prompt(\n 'Please enter your name', // message\n onPrompt, // callback to invoke\n 'Registration', // title\n ['Ok','Exit'], // buttonLabels\n 'Jane Doe' // defaultText\n );\n \n\n### Obsługiwane platformy\n\n* Amazon Fire OS\n* Android\n* Firefox OS\n* iOS\n* Windows Phone 7 i 8\n* Windows 8\n* Windows\n\n### Dziwactwa Androida\n\n* Android obsługuje maksymalnie trzy przyciski i więcej niż to ignoruje.\n\n* Android 3.0 i nowszych przyciski są wyświetlane w kolejności odwrotnej do urządzenia, które używają tematu Holo.\n\n### Windows dziwactwa\n\n* W systemie Windows wierzyciel okno jest oparte na języku html, ze względu na brak takich natywnego api.\n\n### Firefox OS dziwactwa:\n\nDostępne są zarówno rodzimych blokuje `window.prompt()` i bez blokowania `navigator.notification.prompt()`.\n\n## navigator.notification.beep\n\nUrządzenie odtwarza sygnał ciągły dźwięk.\n\n navigator.notification.beep(times);\n \n\n* **times**: liczba powtórzeń po sygnale. *(Liczba)*\n\n### Przykład\n\n // Beep twice!\n navigator.notification.beep(2);\n \n\n### Obsługiwane platformy\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* iOS\n* Tizen\n* Windows Phone 7 i 8\n* Windows 8\n\n### Amazon ogień OS dziwactwa\n\n* Amazon ogień OS gra domyślny **Dźwięk powiadomienia** określone w panelu **ekranu/ustawienia i dźwięk**.\n\n### Dziwactwa Androida\n\n* Android gra domyślnie **dzwonek powiadomienia** określone w panelu **ustawień/dźwięk i wyświetlacz**.\n\n### Windows Phone 7 i 8 dziwactwa\n\n* Opiera się na pliku rodzajowego sygnał z rozkładu Cordova.\n\n### Dziwactwa Tizen\n\n* Tizen implementuje dźwięków przez odtwarzania pliku audio za pośrednictwem mediów API.\n\n* Plik dźwiękowy muszą być krótkie, musi znajdować się w podkatalogu `dźwięki` w katalogu głównym aplikacji i musi być o nazwie `beep.wav`.\n"
},
{
"path": "plugins/cordova-plugin-dialogs/doc/ru/index.md",
"content": "\n\n# cordova-plugin-dialogs\n\nЭтот плагин обеспечивает доступ к некоторым элементам собственного диалогового окна пользовательского интерфейса.\n\n## Установка\n\n cordova plugin add cordova-plugin-dialogs\n \n\n## Методы\n\n* `navigator.notification.alert`\n* `navigator.notification.confirm`\n* `navigator.notification.prompt`\n* `navigator.notification.beep`\n\n## navigator.notification.alert\n\nПоказывает окно пользовательские оповещения или диалоговое окно. Большинство реализаций Cordova использовать диалоговое окно родной для этой функции, но некоторые платформы браузера `alert` функция, которая как правило менее настраивается.\n\n Navigator.Notification.Alert (сообщение, alertCallback, [название], [buttonName])\n \n\n* **сообщение**: сообщение диалога. *(Строка)*\n\n* **alertCallback**: обратного вызова для вызова, когда закрывается диалоговое окно оповещения. *(Функция)*\n\n* **название**: диалоговое окно название. *(Строка)* (Опционально, по умолчанию`Alert`)\n\n* **buttonName**: имя кнопки. *(Строка)* (Опционально, по умолчанию`OK`)\n\n### Пример\n\n function alertDismissed() {\n // do something\n }\n \n navigator.notification.alert(\n 'You are the winner!', // message\n alertDismissed, // callback\n 'Game Over', // title\n 'Done' // buttonName\n );\n \n\n### Поддерживаемые платформы\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 и 8\n* Windows 8\n\n### Особенности Windows Phone 7 и 8\n\n* Существует предупреждение не встроенный браузер, но можно привязать один следующим позвонить `alert()` в глобальной области действия:\n \n window.alert = navigator.notification.alert;\n \n\n* Оба `alert` и `confirm` являются не блокировка звонков, результаты которых доступны только асинхронно.\n\n### Firefox OS причуды:\n\nКак родной блокировка `window.alert()` и неблокирующий `navigator.notification.alert()` доступны.\n\n## navigator.notification.confirm\n\nОтображает диалоговое окно Настраиваемый подтверждения.\n\n navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])\n \n\n* **сообщение**: сообщение диалога. *(Строка)*\n\n* **confirmCallback**: обратного вызова с индексом кнопка нажата (1, 2 или 3) или когда диалоговое окно закрывается без нажатия кнопки (0). *(Функция)*\n\n* **название**: диалоговое окно название. *(Строка)* (Опционально, по умолчанию`Confirm`)\n\n* **buttonLabels**: массив строк, указав названия кнопок. *(Массив)* (Не обязательно, по умолчанию [ `OK,Cancel` ])\n\n### confirmCallback\n\n`confirmCallback`Выполняется, когда пользователь нажимает одну из кнопок в диалоговом окне подтверждения.\n\nАргументом функции обратного вызова `buttonIndex` *(номер)*, который является индекс нажатой кнопки. Обратите внимание, что индекс использует единицы индексации, поэтому значение `1` , `2` , `3` , и т.д.\n\n### Пример\n\n function onConfirm(buttonIndex) {\n alert('You selected button ' + buttonIndex);\n }\n \n navigator.notification.confirm(\n 'You are the winner!', // message\n onConfirm, // callback to invoke with index of button pressed\n 'Game Over', // title\n ['Restart','Exit'] // buttonLabels\n );\n \n\n### Поддерживаемые платформы\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* Firefox OS\n* iOS\n* Tizen\n* Windows Phone 7 и 8\n* Windows 8\n\n### Особенности Windows Phone 7 и 8\n\n* Нет встроенного браузера функция для `window.confirm` , но его можно привязать путем присвоения:\n \n window.confirm = navigator.notification.confirm;\n \n\n* Вызовы `alert` и `confirm` являются не блокируется, поэтому результат доступен только асинхронно.\n\n### Firefox OS причуды:\n\nКак родной блокировка `window.confirm()` и неблокирующий `navigator.notification.confirm()` доступны.\n\n## navigator.notification.prompt\n\nОтображает родной диалоговое окно более настраиваемый, чем в браузере `prompt` функции.\n\n navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])\n \n\n* **сообщение**: сообщение диалога. *(Строка)*\n\n* **promptCallback**: обратного вызова с индексом кнопка нажата (1, 2 или 3) или когда диалоговое окно закрывается без нажатия кнопки (0). *(Функция)*\n\n* **название**: диалоговое окно название *(String)* (опционально, по умолчанию`Prompt`)\n\n* **buttonLabels**: массив строк, указав кнопку этикетки *(массив)* (опционально, по умолчанию`[\"OK\",\"Cancel\"]`)\n\n* **defaultText**: по умолчанию textbox входное значение ( `String` ) (опционально, по умолчанию: пустая строка)\n\n### promptCallback\n\n`promptCallback`Выполняется, когда пользователь нажимает одну из кнопок в диалоговом окне приглашения. `results`Объект, переданный в метод обратного вызова содержит следующие свойства:\n\n* **buttonIndex**: индекс нажатой кнопки. *(Число)* Обратите внимание, что индекс использует единицы индексации, поэтому значение `1` , `2` , `3` , и т.д.\n\n* **INPUT1**: текст, введенный в диалоговом окне приглашения. *(Строка)*\n\n### Пример\n\n function onPrompt(results) {\n alert(\"You selected button number \" + results.buttonIndex + \" and entered \" + results.input1);\n }\n \n navigator.notification.prompt(\n 'Please enter your name', // message\n onPrompt, // callback to invoke\n 'Registration', // title\n ['Ok','Exit'], // buttonLabels\n 'Jane Doe' // defaultText\n );\n \n\n### Поддерживаемые платформы\n\n* Amazon Fire OS\n* Android\n* Firefox OS\n* iOS\n* Windows Phone 7 и 8\n\n### Особенности Android\n\n* Android поддерживает максимум из трех кнопок и игнорирует больше, чем это.\n\n* На Android 3.0 и более поздних версиях кнопки отображаются в обратном порядке для устройств, которые используют тему холо.\n\n### Firefox OS причуды:\n\nКак родной блокировка `window.prompt()` и неблокирующий `navigator.notification.prompt()` доступны.\n\n## navigator.notification.beep\n\nУстройство воспроизводит звуковой сигнал звук.\n\n navigator.notification.beep(times);\n \n\n* **раз**: количество раз, чтобы повторить сигнал. *(Число)*\n\n### Пример\n\n // Beep twice!\n navigator.notification.beep(2);\n \n\n### Поддерживаемые платформы\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* iOS\n* Tizen\n* Windows Phone 7 и 8\n* Windows 8\n\n### Особенности Amazon Fire OS\n\n* Amazon Fire OS играет по умолчанию **Звук уведомления** , указанного на панели **параметров/дисплей и звук** .\n\n### Особенности Android\n\n* Android играет по умолчанию **уведомления рингтон** указанных в панели **настройки/звук и дисплей** .\n\n### Особенности Windows Phone 7 и 8\n\n* Опирается на общий звуковой файл из дистрибутива Кордова.\n\n### Особенности Tizen\n\n* Tizen реализует гудков, воспроизведении аудиофайла через СМИ API.\n\n* Звуковой файл должен быть коротким, должен быть расположен в `sounds` подкаталог корневого каталога приложения и должны быть названы`beep.wav`.\n"
},
{
"path": "plugins/cordova-plugin-dialogs/doc/zh/README.md",
"content": "\n\n# cordova-plugin-dialogs\n\n[](https://travis-ci.org/apache/cordova-plugin-dialogs)\n\n這個外掛程式提供對一些本機對話方塊使用者介面元素，通過全球 `navigator.notification` 物件的訪問。\n\n雖然該物件附加到全球範圍內 `導航器`，它不可用直到 `deviceready` 事件之後。\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(navigator.notification);\n }\n \n\n## 安裝\n\n cordova plugin add cordova-plugin-dialogs\n \n\n## 方法\n\n * `navigator.notification.alert`\n * `navigator.notification.confirm`\n * `navigator.notification.prompt`\n * `navigator.notification.beep`\n\n## navigator.notification.alert\n\n顯示一個自訂的警報或對話方塊框。 大多數的科爾多瓦實現使用本機的對話方塊為此功能，但某些平臺上使用瀏覽器的 `alert` 功能，這是通常不那麼可自訂。\n\n navigator.notification.alert(message, alertCallback, [title], [buttonName])\n \n\n * **message**： 消息對話方塊。*（String）*\n\n * **alertCallback**： 當警報對話方塊的被解雇時要調用的回檔。*（函數）*\n\n * **title**： 標題對話方塊。*（String）*（可選，預設值為`Alert`)\n\n * **buttonName**： 按鈕名稱。*（字串）*（可選，預設值為`OK`)\n\n### 示例\n\n function alertDismissed() {\n // do something\n }\n \n navigator.notification.alert(\n 'You are the winner!', // message\n alertDismissed, // callback\n 'Game Over', // title\n 'Done' // buttonName\n );\n \n\n### 支援的平臺\n\n * 亞馬遜火 OS\n * Android 系統\n * 黑莓 10\n * 火狐瀏覽器作業系統\n * iOS\n * Tizen\n * Windows Phone 7 和 8\n * Windows 8\n * Windows\n\n### Windows Phone 7 和 8 怪癖\n\n * 有沒有內置瀏覽器警報，但你可以綁定一個，如下所示調用 `alert()` 在全球範圍內：\n \n window.alert = navigator.notification.alert;\n \n\n * 兩個 `alert` 和 `confirm` 的非阻塞的調用，其中的結果才是可用的非同步。\n\n### 火狐瀏覽器作業系統怪癖：\n\n本機阻止 `window.alert()` 和非阻塞的 `navigator.notification.alert()` 都可。\n\n### 黑莓 10 怪癖\n\n`navigator.notification.alert ('message'、 confirmCallback、 'title'、 'buttonLabels')` 回檔參數被傳遞的數位 1。\n\n## navigator.notification.confirm\n\n顯示一個可自訂的確認對話方塊。\n\n navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])\n \n\n * **message**： 消息對話方塊。*（String）*\n\n * **confirmCallback**: 要用索引 （1、 2 或 3） 按下的按鈕，或者在沒有按下按鈕 (0) 駁回了對話方塊中時調用的回檔。*（函數）*\n\n * **title**： 標題對話方塊。*（字串）*（可選，預設值為`Confirm`)\n\n * **buttonLabels**： 指定按鈕標籤的字串陣列。*（陣列）*（可選，預設值為 [ `OK,Cancel` ])\n\n### confirmCallback\n\n當使用者按下確認對話方塊中的按鈕之一時，將執行 `confirmCallback`。\n\n回檔需要參數 `buttonIndex` *（編號）*，即按下的按鈕的索引。 請注意索引使用一個基於索引，因此值 `1`、 `2`、 `3` 等。\n\n### 示例\n\n function onConfirm(buttonIndex) {\n alert('You selected button ' + buttonIndex);\n }\n \n navigator.notification.confirm(\n 'You are the winner!', // message\n onConfirm, // callback to invoke with index of button pressed\n 'Game Over', // title\n ['Restart','Exit'] // buttonLabels\n );\n \n\n### 支援的平臺\n\n * 亞馬遜火 OS\n * Android 系統\n * 黑莓 10\n * 火狐瀏覽器作業系統\n * iOS\n * Tizen\n * Windows Phone 7 和 8\n * Windows 8\n * Windows\n\n### Windows Phone 7 和 8 怪癖\n\n * 有沒有內置的瀏覽器功能的 `window.confirm` ，但你可以將它綁定通過分配：\n \n window.confirm = navigator.notification.confirm;\n \n\n * 調用到 `alert` 和 `confirm` 的非阻塞，所以結果就是只可用以非同步方式。\n\n### Windows 的怪癖\n\n * 在 Windows8/8.1 它是不可能將超過三個按鈕添加到 MessageDialog 實例。\n\n * 在 Windows Phone 8.1 它是不可能顯示有超過兩個按鈕的對話方塊。\n\n### 火狐瀏覽器作業系統怪癖：\n\n本機阻止 `window.confirm()` 和非阻塞的 `navigator.notification.confirm()` 都可。\n\n## navigator.notification.prompt\n\n顯示本機的對話方塊，是可定制的比瀏覽器的 `prompt` 功能。\n\n navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])\n \n\n * **message**： 消息對話方塊。*（String）*\n\n * **promptCallback**： 要用指數 （1、 2 或 3） 按下的按鈕或對話方塊中解雇無 (0) 按下一個按鈕時調用的回檔。*（函數）*\n\n * **title**： 標題對話方塊。*（String）*（可選，預設值為`Alert`)\n\n * **buttonLabels**： 指定按鈕標籤 (可選，預設值為 `[\"OK\"，\"Cancel\"]` *（陣列）* 的字串陣列)\n\n * **defaultText**: 預設文字方塊中輸入值 （`字串`） (可選，預設值： 空字串）\n\n### promptCallback\n\n當使用者按下其中一個提示對話方塊中的按鈕時，將執行 `promptCallback`。傳遞給回檔的 `results` 物件包含以下屬性：\n\n * **buttonIndex**： 按下的按鈕的索引。*（數）*請注意索引使用一個基於索引，因此值 `1`、 `2`、 `3` 等。\n\n * **input1**： 在提示對話方塊中輸入的文本。*（字串）*\n\n### 示例\n\n function onPrompt(results) {\n alert(\"You selected button number \" + results.buttonIndex + \" and entered \" + results.input1);\n }\n \n navigator.notification.prompt(\n 'Please enter your name', // message\n onPrompt, // callback to invoke\n 'Registration', // title\n ['Ok','Exit'], // buttonLabels\n 'Jane Doe' // defaultText\n );\n \n\n### 支援的平臺\n\n * 亞馬遜火 OS\n * Android 系統\n * 火狐瀏覽器作業系統\n * iOS\n * Windows Phone 7 和 8\n * Windows 8\n * Windows\n\n### Android 的怪癖\n\n * Android 支援最多的三個按鈕，並忽略任何更多。\n\n * 在 Android 3.0 及更高版本，使用全息主題的設備以相反的順序顯示按鈕。\n\n### Windows 的怪癖\n\n * 在 Windows 上提示對話方塊是基於 html 的缺乏這種本機 api。\n\n### 火狐瀏覽器作業系統怪癖：\n\n本機阻止 `window.prompt()` 和非阻塞的 `navigator.notification.prompt()` 都可。\n\n## navigator.notification.beep\n\n該設備播放提示音的聲音。\n\n navigator.notification.beep(times);\n \n\n * **beep**： 次數重複在嗶嗶聲。*（數）*\n\n### 示例\n\n // Beep twice!\n navigator.notification.beep(2);\n \n\n### 支援的平臺\n\n * 亞馬遜火 OS\n * Android 系統\n * 黑莓 10\n * iOS\n * Tizen\n * Windows Phone 7 和 8\n * Windows 8\n\n### 亞馬遜火 OS 怪癖\n\n * 亞馬遜火 OS 播放預設 **設置/顯示和聲音** 板下指定的 **通知聲音**。\n\n### Android 的怪癖\n\n * 安卓系統播放預設 **通知鈴聲** **設置/聲音和顯示** 面板下指定。\n\n### Windows Phone 7 和 8 怪癖\n\n * 依賴于泛型蜂鳴音檔從科爾多瓦分佈。\n\n### Tizen 怪癖\n\n * Tizen 通過播放音訊檔通過媒體 API 實現的蜂鳴聲。\n\n * 蜂鳴音檔必須很短，必須位於應用程式的根目錄中，一個 `聲音` 子目錄和必須將命名為 `beep.wav`."
},
{
"path": "plugins/cordova-plugin-dialogs/doc/zh/index.md",
"content": "\n\n# cordova-plugin-dialogs\n\n這個外掛程式提供對一些本機對話方塊使用者介面元素，通過全球 `navigator.notification` 物件的訪問。\n\n雖然該物件附加到全球範圍內 `導航器`，它不可用直到 `deviceready` 事件之後。\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(navigator.notification);\n }\n \n\n## 安裝\n\n cordova plugin add cordova-plugin-dialogs\n \n\n## 方法\n\n* `navigator.notification.alert`\n* `navigator.notification.confirm`\n* `navigator.notification.prompt`\n* `navigator.notification.beep`\n\n## navigator.notification.alert\n\n顯示一個自訂的警報或對話方塊框。 大多數的科爾多瓦實現使用本機的對話方塊為此功能，但某些平臺上使用瀏覽器的 `alert` 功能，這是通常不那麼可自訂。\n\n navigator.notification.alert(message, alertCallback, [title], [buttonName])\n \n\n* **message**： 消息對話方塊。*（String）*\n\n* **alertCallback**： 當警報對話方塊的被解雇時要調用的回檔。*（函數）*\n\n* **title**： 標題對話方塊。*（String）*（可選，預設值為`Alert`)\n\n* **buttonName**： 按鈕名稱。*（字串）*（可選，預設值為`OK`)\n\n### 示例\n\n function alertDismissed() {\n // do something\n }\n \n navigator.notification.alert(\n 'You are the winner!', // message\n alertDismissed, // callback\n 'Game Over', // title\n 'Done' // buttonName\n );\n \n\n### 支援的平臺\n\n* 亞馬遜火 OS\n* Android 系統\n* 黑莓 10\n* 火狐瀏覽器作業系統\n* iOS\n* Tizen\n* Windows Phone 7 和 8\n* Windows 8\n* Windows\n\n### Windows Phone 7 和 8 怪癖\n\n* 有沒有內置瀏覽器警報，但你可以綁定一個，如下所示調用 `alert()` 在全球範圍內：\n \n window.alert = navigator.notification.alert;\n \n\n* 兩個 `alert` 和 `confirm` 的非阻塞的調用，其中的結果才是可用的非同步。\n\n### 火狐瀏覽器作業系統怪癖：\n\n本機阻止 `window.alert()` 和非阻塞的 `navigator.notification.alert()` 都可。\n\n### 黑莓 10 怪癖\n\n`navigator.notification.alert ('message'、 confirmCallback、 'title'、 'buttonLabels')` 回檔參數被傳遞的數位 1。\n\n## navigator.notification.confirm\n\n顯示一個可自訂的確認對話方塊。\n\n navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])\n \n\n* **message**： 消息對話方塊。*（字串）*\n\n* **confirmCallback**: 要用索引 （1、 2 或 3） 按下的按鈕，或者在沒有按下按鈕 (0) 駁回了對話方塊中時調用的回檔。*（函數）*\n\n* **title**： 標題對話方塊。*（字串）*（可選，預設值為`Confirm`)\n\n* **buttonLabels**： 指定按鈕標籤的字串陣列。*（陣列）*（可選，預設值為 [ `OK,Cancel` ])\n\n### confirmCallback\n\n當使用者按下確認對話方塊中的按鈕之一時，將執行 `confirmCallback`。\n\n回檔需要參數 `buttonIndex` *（編號）*，即按下的按鈕的索引。 請注意索引使用一個基於索引，因此值 `1`、 `2`、 `3` 等。\n\n### 示例\n\n function onConfirm(buttonIndex) {\n alert('You selected button ' + buttonIndex);\n }\n \n navigator.notification.confirm(\n 'You are the winner!', // message\n onConfirm, // callback to invoke with index of button pressed\n 'Game Over', // title\n ['Restart','Exit'] // buttonLabels\n );\n \n\n### 支援的平臺\n\n* 亞馬遜火 OS\n* Android 系統\n* 黑莓 10\n* 火狐瀏覽器作業系統\n* iOS\n* Tizen\n* Windows Phone 7 和 8\n* Windows 8\n* Windows\n\n### Windows Phone 7 和 8 怪癖\n\n* 有沒有內置的瀏覽器功能的 `window.confirm` ，但你可以將它綁定通過分配：\n \n window.confirm = navigator.notification.confirm;\n \n\n* 調用到 `alert` 和 `confirm` 的非阻塞，所以結果就是只可用以非同步方式。\n\n### Windows 的怪癖\n\n* 在 Windows8/8.1 它是不可能將超過三個按鈕添加到 MessageDialog 實例。\n\n* 在 Windows Phone 8.1 它是不可能顯示有超過兩個按鈕的對話方塊。\n\n### 火狐瀏覽器作業系統怪癖：\n\n本機阻止 `window.confirm()` 和非阻塞的 `navigator.notification.confirm()` 都可。\n\n## navigator.notification.prompt\n\n顯示本機的對話方塊，是可定制的比瀏覽器的 `prompt` 功能。\n\n navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])\n \n\n* **message**： 消息對話方塊。*（String）*\n\n* **promptCallback**： 要用指數 （1、 2 或 3） 按下的按鈕或對話方塊中解雇無 (0) 按下一個按鈕時調用的回檔。*（函數）*\n\n* **title**： 標題對話方塊。*（String）*（可選，預設值為`Alert`)\n\n* **buttonLabels**： 指定按鈕標籤 (可選，預設值為 `[\"OK\"，\"Cancel\"]` *（陣列）* 的字串陣列)\n\n* **defaultText**: 預設文字方塊中輸入值 （`字串`） (可選，預設值： 空字串）\n\n### promptCallback\n\n當使用者按下其中一個提示對話方塊中的按鈕時，將執行 `promptCallback`。傳遞給回檔的 `results` 物件包含以下屬性：\n\n* **buttonIndex**： 按下的按鈕的索引。*（數）*請注意索引使用一個基於索引，因此值 `1`、 `2`、 `3` 等。\n\n* **input1**： 在提示對話方塊中輸入的文本。*（字串）*\n\n### 示例\n\n function onPrompt(results) {\n alert(\"You selected button number \" + results.buttonIndex + \" and entered \" + results.input1);\n }\n \n navigator.notification.prompt(\n 'Please enter your name', // message\n onPrompt, // callback to invoke\n 'Registration', // title\n ['Ok','Exit'], // buttonLabels\n 'Jane Doe' // defaultText\n );\n \n\n### 支援的平臺\n\n* 亞馬遜火 OS\n* Android 系統\n* 火狐瀏覽器作業系統\n* iOS\n* Windows Phone 7 和 8\n* Windows 8\n* Windows\n\n### Android 的怪癖\n\n* Android 支援最多的三個按鈕，並忽略任何更多。\n\n* 在 Android 3.0 及更高版本，使用全息主題的設備以相反的順序顯示按鈕。\n\n### Windows 的怪癖\n\n* 在 Windows 上提示對話方塊是基於 html 的缺乏這種本機 api。\n\n### 火狐瀏覽器作業系統怪癖：\n\n本機阻止 `window.prompt()` 和非阻塞的 `navigator.notification.prompt()` 都可。\n\n## navigator.notification.beep\n\n該設備播放提示音的聲音。\n\n navigator.notification.beep(times);\n \n\n* **beep**： 次數重複在嗶嗶聲。*（數）*\n\n### 示例\n\n // Beep twice!\n navigator.notification.beep(2);\n \n\n### 支援的平臺\n\n* 亞馬遜火 OS\n* Android 系統\n* 黑莓 10\n* iOS\n* Tizen\n* Windows Phone 7 和 8\n* Windows 8\n\n### 亞馬遜火 OS 怪癖\n\n* 亞馬遜火 OS 播放預設 **設置/顯示和聲音** 板下指定的 **通知聲音**。\n\n### Android 的怪癖\n\n* 安卓系統播放預設 **通知鈴聲** **設置/聲音和顯示** 面板下指定。\n\n### Windows Phone 7 和 8 怪癖\n\n* 依賴于泛型蜂鳴音檔從科爾多瓦分佈。\n\n### Tizen 怪癖\n\n* Tizen 通過播放音訊檔通過媒體 API 實現的蜂鳴聲。\n\n* 蜂鳴音檔必須很短，必須位於應用程式的根目錄中，一個 `聲音` 子目錄和必須將命名為 `beep.wav`.\n"
},
{
"path": "plugins/cordova-plugin-dialogs/package.json",
"content": "{\n \"name\": \"cordova-plugin-dialogs\",\n \"version\": \"1.2.1\",\n \"description\": \"Cordova Notification Plugin\",\n \"cordova\": {\n \"id\": \"cordova-plugin-dialogs\",\n \"platforms\": [\n \"firefoxos\",\n \"android\",\n \"browser\",\n \"amazon-fireos\",\n \"ubuntu\",\n \"ios\",\n \"blackberry10\",\n \"wp7\",\n \"wp8\",\n \"windows8\",\n \"windows\"\n ]\n },\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/apache/cordova-plugin-dialogs\"\n },\n \"keywords\": [\n \"cordova\",\n \"notification\",\n \"ecosystem:cordova\",\n \"cordova-firefoxos\",\n \"cordova-android\",\n \"cordova-browser\",\n \"cordova-amazon-fireos\",\n \"cordova-ubuntu\",\n \"cordova-ios\",\n \"cordova-blackberry10\",\n \"cordova-wp7\",\n \"cordova-wp8\",\n \"cordova-windows8\",\n \"cordova-windows\"\n ],\n \"scripts\": {\n \"test\": \"npm run jshint\",\n \"jshint\": \"node node_modules/jshint/bin/jshint www && node node_modules/jshint/bin/jshint src && node node_modules/jshint/bin/jshint tests\"\n },\n \"author\": \"Apache Software Foundation\",\n \"license\": \"Apache-2.0\",\n \"devDependencies\": {\n \"jshint\": \"^2.6.0\"\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-dialogs/plugin.xml",
"content": "\n\n\n\n\n Notification\n Cordova Notification Plugin\n Apache 2.0\n cordova,notification\n https://git-wip-us.apache.org/repos/asf/cordova-plugin-dialogs.git\n https://issues.apache.org/jira/browse/CB/component/12320642\n\n \n \n \n\n \n \n \n \n \n \n \n \n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n \n \n \n \n\n \n \n \n \n \n \n \n\n \n\n \n \n \n \n\n \n\n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n\n \n\n \n \n \n \n\n \n\n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n\t \n\t \n\t\t\n \n\n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n\n \n \n \n \n \n\n \n \n \n \n \n \n \n\n \n \n \n \n \n\n \n \n \n \n \n \n\n \n \n \n \n \n \n\n"
},
{
"path": "plugins/cordova-plugin-dialogs/src/android/Notification.java",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n*/\npackage org.apache.cordova.dialogs;\n\nimport org.apache.cordova.CallbackContext;\nimport org.apache.cordova.CordovaInterface;\nimport org.apache.cordova.CordovaPlugin;\nimport org.apache.cordova.LOG;\nimport org.apache.cordova.PluginResult;\nimport org.json.JSONArray;\nimport org.json.JSONException;\nimport org.json.JSONObject;\n\nimport android.annotation.SuppressLint;\nimport android.app.AlertDialog;\nimport android.app.AlertDialog.Builder;\nimport android.app.ProgressDialog;\nimport android.content.DialogInterface;\nimport android.media.Ringtone;\nimport android.media.RingtoneManager;\nimport android.net.Uri;\nimport android.widget.EditText;\nimport android.widget.TextView;\n\n\n/**\n * This class provides access to notifications on the device.\n *\n * Be aware that this implementation gets called on \n * navigator.notification.{alert|confirm|prompt}, and that there is a separate\n * implementation in org.apache.cordova.CordovaChromeClient that gets\n * called on a simple window.{alert|confirm|prompt}.\n */\npublic class Notification extends CordovaPlugin {\n\n private static final String LOG_TAG = \"Notification\";\n \n public int confirmResult = -1;\n public ProgressDialog spinnerDialog = null;\n public ProgressDialog progressDialog = null;\n\n /**\n * Constructor.\n */\n public Notification() {\n }\n\n /**\n * Executes the request and returns PluginResult.\n *\n * @param action The action to execute.\n * @param args JSONArray of arguments for the plugin.\n * @param callbackContext The callback context used when calling back into JavaScript.\n * @return True when the action was valid, false otherwise.\n */\n public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException {\n \t/*\n \t * Don't run any of these if the current activity is finishing\n \t * in order to avoid android.view.WindowManager$BadTokenException\n \t * crashing the app. Just return true here since false should only\n \t * be returned in the event of an invalid action.\n \t */\n \tif(this.cordova.getActivity().isFinishing()) return true;\n \t\n if (action.equals(\"beep\")) {\n this.beep(args.getLong(0));\n }\n else if (action.equals(\"alert\")) {\n this.alert(args.getString(0), args.getString(1), args.getString(2), callbackContext);\n return true;\n }\n else if (action.equals(\"confirm\")) {\n this.confirm(args.getString(0), args.getString(1), args.getJSONArray(2), callbackContext);\n return true;\n }\n else if (action.equals(\"prompt\")) {\n this.prompt(args.getString(0), args.getString(1), args.getJSONArray(2), args.getString(3), callbackContext);\n return true;\n }\n else if (action.equals(\"activityStart\")) {\n this.activityStart(args.getString(0), args.getString(1));\n }\n else if (action.equals(\"activityStop\")) {\n this.activityStop();\n }\n else if (action.equals(\"progressStart\")) {\n this.progressStart(args.getString(0), args.getString(1));\n }\n else if (action.equals(\"progressValue\")) {\n this.progressValue(args.getInt(0));\n }\n else if (action.equals(\"progressStop\")) {\n this.progressStop();\n }\n else {\n return false;\n }\n\n // Only alert and confirm are async.\n callbackContext.success();\n return true;\n }\n\n //--------------------------------------------------------------------------\n // LOCAL METHODS\n //--------------------------------------------------------------------------\n\n /**\n * Beep plays the default notification ringtone.\n *\n * @param count Number of times to play notification\n */\n public void beep(final long count) {\n cordova.getThreadPool().execute(new Runnable() {\n public void run() {\n Uri ringtone = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION);\n Ringtone notification = RingtoneManager.getRingtone(cordova.getActivity().getBaseContext(), ringtone);\n\n // If phone is not set to silent mode\n if (notification != null) {\n for (long i = 0; i < count; ++i) {\n notification.play();\n long timeout = 5000;\n while (notification.isPlaying() && (timeout > 0)) {\n timeout = timeout - 100;\n try {\n Thread.sleep(100);\n } catch (InterruptedException e) {\n Thread.currentThread().interrupt();\n }\n }\n }\n }\n }\n });\n }\n\n /**\n * Builds and shows a native Android alert with given Strings\n * @param message The message the alert should display\n * @param title The title of the alert\n * @param buttonLabel The label of the button\n * @param callbackContext The callback context\n */\n public synchronized void alert(final String message, final String title, final String buttonLabel, final CallbackContext callbackContext) {\n \tfinal CordovaInterface cordova = this.cordova;\n\n Runnable runnable = new Runnable() {\n public void run() {\n\n AlertDialog.Builder dlg = createDialog(cordova); // new AlertDialog.Builder(cordova.getActivity(), AlertDialog.THEME_DEVICE_DEFAULT_LIGHT);\n dlg.setMessage(message);\n dlg.setTitle(title);\n dlg.setCancelable(true);\n dlg.setPositiveButton(buttonLabel,\n new AlertDialog.OnClickListener() {\n public void onClick(DialogInterface dialog, int which) {\n dialog.dismiss();\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, 0));\n }\n });\n dlg.setOnCancelListener(new AlertDialog.OnCancelListener() {\n public void onCancel(DialogInterface dialog)\n {\n dialog.dismiss();\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, 0));\n }\n });\n\n changeTextDirection(dlg);\n };\n };\n this.cordova.getActivity().runOnUiThread(runnable);\n }\n\n /**\n * Builds and shows a native Android confirm dialog with given title, message, buttons.\n * This dialog only shows up to 3 buttons. Any labels after that will be ignored.\n * The index of the button pressed will be returned to the JavaScript callback identified by callbackId.\n *\n * @param message The message the dialog should display\n * @param title The title of the dialog\n * @param buttonLabels A comma separated list of button labels (Up to 3 buttons)\n * @param callbackContext The callback context.\n */\n public synchronized void confirm(final String message, final String title, final JSONArray buttonLabels, final CallbackContext callbackContext) {\n \tfinal CordovaInterface cordova = this.cordova;\n\n Runnable runnable = new Runnable() {\n public void run() {\n AlertDialog.Builder dlg = createDialog(cordova); // new AlertDialog.Builder(cordova.getActivity(), AlertDialog.THEME_DEVICE_DEFAULT_LIGHT);\n dlg.setMessage(message);\n dlg.setTitle(title);\n dlg.setCancelable(true);\n\n // First button\n if (buttonLabels.length() > 0) {\n try {\n dlg.setNegativeButton(buttonLabels.getString(0),\n new AlertDialog.OnClickListener() {\n public void onClick(DialogInterface dialog, int which) {\n dialog.dismiss();\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, 1));\n }\n });\n } catch (JSONException e) {\n LOG.d(LOG_TAG,\"JSONException on first button.\");\n }\n }\n\n // Second button\n if (buttonLabels.length() > 1) {\n try {\n dlg.setNeutralButton(buttonLabels.getString(1),\n new AlertDialog.OnClickListener() {\n public void onClick(DialogInterface dialog, int which) {\n dialog.dismiss();\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, 2));\n }\n });\n } catch (JSONException e) {\n LOG.d(LOG_TAG,\"JSONException on second button.\");\n }\n }\n\n // Third button\n if (buttonLabels.length() > 2) {\n try {\n dlg.setPositiveButton(buttonLabels.getString(2),\n new AlertDialog.OnClickListener() {\n public void onClick(DialogInterface dialog, int which) {\n dialog.dismiss();\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, 3));\n }\n });\n } catch (JSONException e) {\n LOG.d(LOG_TAG,\"JSONException on third button.\");\n }\n }\n dlg.setOnCancelListener(new AlertDialog.OnCancelListener() {\n public void onCancel(DialogInterface dialog)\n {\n dialog.dismiss();\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, 0));\n }\n });\n\n changeTextDirection(dlg);\n };\n };\n this.cordova.getActivity().runOnUiThread(runnable);\n }\n\n /**\n * Builds and shows a native Android prompt dialog with given title, message, buttons.\n * This dialog only shows up to 3 buttons. Any labels after that will be ignored.\n * The following results are returned to the JavaScript callback identified by callbackId:\n * buttonIndex\t\t\tIndex number of the button selected\n * input1\t\t\t\tThe text entered in the prompt dialog box\n *\n * @param message The message the dialog should display\n * @param title The title of the dialog\n * @param buttonLabels A comma separated list of button labels (Up to 3 buttons)\n * @param callbackContext The callback context.\n */\n public synchronized void prompt(final String message, final String title, final JSONArray buttonLabels, final String defaultText, final CallbackContext callbackContext) {\n \t\n final CordovaInterface cordova = this.cordova;\n \n Runnable runnable = new Runnable() {\n public void run() {\n final EditText promptInput = new EditText(cordova.getActivity());\n promptInput.setHint(defaultText);\n AlertDialog.Builder dlg = createDialog(cordova); // new AlertDialog.Builder(cordova.getActivity(), AlertDialog.THEME_DEVICE_DEFAULT_LIGHT);\n dlg.setMessage(message);\n dlg.setTitle(title);\n dlg.setCancelable(true);\n \n dlg.setView(promptInput);\n \n final JSONObject result = new JSONObject();\n \n // First button\n if (buttonLabels.length() > 0) {\n try {\n dlg.setNegativeButton(buttonLabels.getString(0),\n new AlertDialog.OnClickListener() {\n public void onClick(DialogInterface dialog, int which) {\n dialog.dismiss();\n try {\n result.put(\"buttonIndex\",1);\n result.put(\"input1\", promptInput.getText().toString().trim().length()==0 ? defaultText : promptInput.getText());\t\t\t\t\t\t\t\t\t\t\t\n } catch (JSONException e) {\n LOG.d(LOG_TAG,\"JSONException on first button.\", e);\n }\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, result));\n }\n });\n } catch (JSONException e) {\n LOG.d(LOG_TAG,\"JSONException on first button.\");\n }\n }\n\n // Second button\n if (buttonLabels.length() > 1) {\n try {\n dlg.setNeutralButton(buttonLabels.getString(1),\n new AlertDialog.OnClickListener() {\n public void onClick(DialogInterface dialog, int which) {\n dialog.dismiss();\n try {\n result.put(\"buttonIndex\",2);\n result.put(\"input1\", promptInput.getText().toString().trim().length()==0 ? defaultText : promptInput.getText());\n } catch (JSONException e) {\n LOG.d(LOG_TAG,\"JSONException on second button.\", e);\n }\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, result));\n }\n });\n } catch (JSONException e) {\n LOG.d(LOG_TAG,\"JSONException on second button.\");\n }\n }\n\n // Third button\n if (buttonLabels.length() > 2) {\n try {\n dlg.setPositiveButton(buttonLabels.getString(2),\n new AlertDialog.OnClickListener() {\n public void onClick(DialogInterface dialog, int which) {\n dialog.dismiss();\n try {\n result.put(\"buttonIndex\",3);\n result.put(\"input1\", promptInput.getText().toString().trim().length()==0 ? defaultText : promptInput.getText());\n } catch (JSONException e) { \n LOG.d(LOG_TAG,\"JSONException on third button.\", e);\n }\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, result));\n }\n });\n } catch (JSONException e) {\n LOG.d(LOG_TAG,\"JSONException on third button.\");\n }\n }\n dlg.setOnCancelListener(new AlertDialog.OnCancelListener() {\n public void onCancel(DialogInterface dialog){\n dialog.dismiss();\n try {\n result.put(\"buttonIndex\",0);\n result.put(\"input1\", promptInput.getText().toString().trim().length()==0 ? defaultText : promptInput.getText());\n } catch (JSONException e) { e.printStackTrace(); }\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, result));\n }\n });\n\n changeTextDirection(dlg);\n };\n };\n this.cordova.getActivity().runOnUiThread(runnable);\n }\n\n /**\n * Show the spinner.\n *\n * @param title Title of the dialog\n * @param message The message of the dialog\n */\n public synchronized void activityStart(final String title, final String message) {\n if (this.spinnerDialog != null) {\n this.spinnerDialog.dismiss();\n this.spinnerDialog = null;\n }\n final Notification notification = this;\n final CordovaInterface cordova = this.cordova;\n Runnable runnable = new Runnable() {\n public void run() {\n notification.spinnerDialog = createProgressDialog(cordova); // new ProgressDialog(cordova.getActivity(), AlertDialog.THEME_DEVICE_DEFAULT_LIGHT);\n notification.spinnerDialog.setTitle(title);\n notification.spinnerDialog.setMessage(message);\n notification.spinnerDialog.setCancelable(true);\n notification.spinnerDialog.setIndeterminate(true);\n notification.spinnerDialog.setOnCancelListener(\n new DialogInterface.OnCancelListener() {\n public void onCancel(DialogInterface dialog) {\n notification.spinnerDialog = null;\n }\n });\n notification.spinnerDialog.show();\n }\n };\n this.cordova.getActivity().runOnUiThread(runnable);\n }\n\n /**\n * Stop spinner.\n */\n public synchronized void activityStop() {\n if (this.spinnerDialog != null) {\n this.spinnerDialog.dismiss();\n this.spinnerDialog = null;\n }\n }\n\n /**\n * Show the progress dialog.\n *\n * @param title Title of the dialog\n * @param message The message of the dialog\n */\n public synchronized void progressStart(final String title, final String message) {\n if (this.progressDialog != null) {\n this.progressDialog.dismiss();\n this.progressDialog = null;\n }\n final Notification notification = this;\n final CordovaInterface cordova = this.cordova;\n Runnable runnable = new Runnable() {\n public void run() {\n notification.progressDialog = createProgressDialog(cordova); // new ProgressDialog(cordova.getActivity(), AlertDialog.THEME_DEVICE_DEFAULT_LIGHT);\n notification.progressDialog.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL);\n notification.progressDialog.setTitle(title);\n notification.progressDialog.setMessage(message);\n notification.progressDialog.setCancelable(true);\n notification.progressDialog.setMax(100);\n notification.progressDialog.setProgress(0);\n notification.progressDialog.setOnCancelListener(\n new DialogInterface.OnCancelListener() {\n public void onCancel(DialogInterface dialog) {\n notification.progressDialog = null;\n }\n });\n notification.progressDialog.show();\n }\n };\n this.cordova.getActivity().runOnUiThread(runnable);\n }\n\n /**\n * Set value of progress bar.\n *\n * @param value 0-100\n */\n public synchronized void progressValue(int value) {\n if (this.progressDialog != null) {\n this.progressDialog.setProgress(value);\n }\n }\n\n /**\n * Stop progress dialog.\n */\n public synchronized void progressStop() {\n if (this.progressDialog != null) {\n this.progressDialog.dismiss();\n this.progressDialog = null;\n }\n }\n \n @SuppressLint(\"NewApi\")\n private AlertDialog.Builder createDialog(CordovaInterface cordova) {\n int currentapiVersion = android.os.Build.VERSION.SDK_INT;\n if (currentapiVersion >= android.os.Build.VERSION_CODES.HONEYCOMB) {\n return new AlertDialog.Builder(cordova.getActivity(), AlertDialog.THEME_DEVICE_DEFAULT_LIGHT);\n } else {\n return new AlertDialog.Builder(cordova.getActivity());\n }\n }\n\n @SuppressLint(\"InlinedApi\")\n private ProgressDialog createProgressDialog(CordovaInterface cordova) {\n int currentapiVersion = android.os.Build.VERSION.SDK_INT;\n if (currentapiVersion >= android.os.Build.VERSION_CODES.ICE_CREAM_SANDWICH) {\n return new ProgressDialog(cordova.getActivity(), AlertDialog.THEME_DEVICE_DEFAULT_LIGHT);\n } else {\n return new ProgressDialog(cordova.getActivity());\n }\n }\n \n @SuppressLint(\"NewApi\")\n private void changeTextDirection(Builder dlg){\n int currentapiVersion = android.os.Build.VERSION.SDK_INT;\n dlg.create();\n AlertDialog dialog = dlg.show();\n if (currentapiVersion >= android.os.Build.VERSION_CODES.JELLY_BEAN_MR1) {\n TextView messageview = (TextView)dialog.findViewById(android.R.id.message);\n messageview.setTextDirection(android.view.View.TEXT_DIRECTION_LOCALE);\n }\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-dialogs/src/blackberry10/index.js",
"content": "/*\n* Copyright 2013 Research In Motion Limited.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n* http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n/* global qnx, PluginResult */\n\nfunction showDialog(args, dialogType, result) {\n //Unpack and map the args\n var msg = JSON.parse(decodeURIComponent(args[0])),\n title = JSON.parse(decodeURIComponent(args[1])),\n btnLabel = JSON.parse(decodeURIComponent(args[2]));\n\n if (!Array.isArray(btnLabel)) {\n //Converts to array for (string) and (string,string, ...) cases\n btnLabel = btnLabel.split(\",\");\n }\n\n if (msg && typeof msg === \"string\") {\n msg = msg.replace(/^\"|\"$/g, \"\").replace(/\\\\\"/g, '\"');\n } else {\n result.error(\"message is undefined\");\n return;\n }\n\n var messageObj = {\n title : title,\n htmlmessage : msg,\n dialogType : dialogType,\n optionalButtons : btnLabel\n };\n\n //TODO replace with getOverlayWebview() when available in webplatform\n qnx.webplatform.getWebViews()[2].dialog.show(messageObj, function (data) {\n if (typeof data === \"number\") {\n //Confirm dialog call back needs to be called with one-based indexing [1,2,3 etc]\n result.callbackOk(++data, false);\n } else {\n //Prompt dialog callback expects object\n result.callbackOk({\n buttonIndex: data.ok ? 1 : 0,\n input1: (data.oktext) ? decodeURIComponent(data.oktext) : \"\"\n }, false);\n }\n });\n\n result.noResult(true);\n}\n\nmodule.exports = {\n alert: function (success, fail, args, env) {\n var result = new PluginResult(args, env);\n\n if (Object.keys(args).length < 3) {\n result.error(\"Notification action - alert arguments not found.\");\n } else {\n showDialog(args, \"CustomAsk\", result);\n }\n },\n confirm: function (success, fail, args, env) {\n var result = new PluginResult(args, env);\n\n if (Object.keys(args).length < 3) {\n result.error(\"Notification action - confirm arguments not found.\");\n } else {\n showDialog(args, \"CustomAsk\", result);\n }\n },\n prompt: function (success, fail, args, env) {\n var result = new PluginResult(args, env);\n\n if (Object.keys(args).length < 3) {\n result.error(\"Notification action - prompt arguments not found.\");\n } else {\n showDialog(args, \"JavaScriptPrompt\", result);\n }\n }\n};\n"
},
{
"path": "plugins/cordova-plugin-dialogs/src/firefoxos/notification.js",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n*/\n\nvar modulemapper = require('cordova/modulemapper');\n\n\nvar origOpenFunc = modulemapper.getOriginalSymbol(window, 'window.open');\n\n\nfunction _empty() {}\n\n\nfunction modal(message, callback, title, buttonLabels, domObjects) {\n var mainWindow = window;\n var modalWindow = origOpenFunc();\n var modalDocument = modalWindow.document;\n\n modalDocument.write(\n '' +\n '' +\n '' +\n '');\n\n var box = modalDocument.createElement('form');\n box.setAttribute('role', 'dialog');\n // prepare and append empty section\n var section = modalDocument.createElement('section');\n box.appendChild(section);\n // add title\n var boxtitle = modalDocument.createElement('h1');\n boxtitle.appendChild(modalDocument.createTextNode(title));\n section.appendChild(boxtitle);\n // add message\n var boxMessage = modalDocument.createElement('p');\n boxMessage.appendChild(modalDocument.createTextNode(message));\n section.appendChild(boxMessage);\n // inject what's needed\n if (domObjects) {\n section.appendChild(domObjects);\n }\n // add buttons and assign callbackButton on click\n var menu = modalDocument.createElement('menu');\n box.appendChild(menu);\n for (var index = 0; index < buttonLabels.length; index++) {\n // TODO: last button listens to the cancel key\n addButton(buttonLabels[index], (index+1), (index === 0));\n }\n modalDocument.body.appendChild(box);\n\n function addButton(label, index, recommended) {\n var thisButtonCallback = makeCallbackButton(index + 1);\n var button = modalDocument.createElement('button');\n button.appendChild(modalDocument.createTextNode(label));\n button.addEventListener('click', thisButtonCallback, false);\n if (recommended) {\n // TODO: default one listens to Enter key\n button.classList.add('recommend');\n }\n menu.appendChild(button);\n }\n\n // TODO: onUnload listens to the cancel key\n function onUnload() {\n var result = 0;\n if (modalDocument.getElementById('prompt-input')) {\n result = {\n input1: '',\n buttonIndex: 0\n };\n }\n mainWindow.setTimeout(function() {\n callback(result);\n }, 10);\n }\n modalWindow.addEventListener('unload', onUnload, false);\n\n // call callback and destroy modal\n function makeCallbackButton(labelIndex) {\n return function() {\n if (modalWindow) {\n modalWindow.removeEventListener('unload', onUnload, false);\n modalWindow.close();\n }\n // checking if prompt\n var promptInput = modalDocument.getElementById('prompt-input');\n var response;\n if (promptInput) {\n response = {\n input1: promptInput.value,\n buttonIndex: labelIndex\n };\n }\n response = response || labelIndex;\n callback(response);\n };\n }\n}\n\nvar Notification = {\n vibrate: function(milliseconds) {\n navigator.vibrate(milliseconds);\n },\n alert: function(successCallback, errorCallback, args) {\n var message = args[0];\n var title = args[1];\n var _buttonLabels = [args[2]];\n var _callback = (successCallback || _empty);\n modal(message, _callback, title, _buttonLabels);\n },\n confirm: function(successCallback, errorCallback, args) {\n var message = args[0];\n var title = args[1];\n var buttonLabels = args[2];\n var _callback = (successCallback || _empty);\n modal(message, _callback, title, buttonLabels);\n },\n prompt: function(successCallback, errorCallback, args) {\n var message = args[0];\n var title = args[1];\n var buttonLabels = args[2];\n var defaultText = args[3];\n var inputParagraph = document.createElement('p');\n inputParagraph.classList.add('input');\n var inputElement = document.createElement('input');\n inputElement.setAttribute('type', 'text');\n inputElement.id = 'prompt-input';\n if (defaultText) {\n inputElement.setAttribute('placeholder', defaultText);\n }\n inputParagraph.appendChild(inputElement);\n modal(message, successCallback, title, buttonLabels, inputParagraph);\n }\n};\n\n\nmodule.exports = Notification;\nrequire('cordova/exec/proxy').add('Notification', Notification);\n"
},
{
"path": "plugins/cordova-plugin-dialogs/src/ios/CDVNotification.h",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\n\n#import \n#import \n#import \n#import \n\n@interface CDVNotification : CDVPlugin {}\n\n- (void)alert:(CDVInvokedUrlCommand*)command;\n- (void)confirm:(CDVInvokedUrlCommand*)command;\n- (void)prompt:(CDVInvokedUrlCommand*)command;\n- (void)beep:(CDVInvokedUrlCommand*)command;\n\n@end\n\n@interface CDVAlertView : UIAlertView {}\n@property (nonatomic, copy) NSString* callbackId;\n\n@end\n"
},
{
"path": "plugins/cordova-plugin-dialogs/src/ios/CDVNotification.m",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\n\n#import \"CDVNotification.h\"\n\n#define DIALOG_TYPE_ALERT @\"alert\"\n#define DIALOG_TYPE_PROMPT @\"prompt\"\n\nstatic void soundCompletionCallback(SystemSoundID ssid, void* data);\nstatic NSMutableArray *alertList = nil;\n\n@implementation CDVNotification\n\n/*\n * showDialogWithMessage - Common method to instantiate the alert view for alert, confirm, and prompt notifications.\n * Parameters:\n * message The alert view message.\n * title The alert view title.\n * buttons The array of customized strings for the buttons.\n * defaultText The input text for the textbox (if textbox exists).\n * callbackId The commmand callback id.\n * dialogType The type of alert view [alert | prompt].\n */\n- (void)showDialogWithMessage:(NSString*)message title:(NSString*)title buttons:(NSArray*)buttons defaultText:(NSString*)defaultText callbackId:(NSString*)callbackId dialogType:(NSString*)dialogType\n{\n \n int count = (int)[buttons count];\n#ifdef __IPHONE_8_0\n if (NSClassFromString(@\"UIAlertController\")) {\n \n UIAlertController *alertController = [UIAlertController alertControllerWithTitle:title message:message preferredStyle:UIAlertControllerStyleAlert];\n \n if ([[[UIDevice currentDevice] systemVersion] floatValue] < 8.3) {\n \n CGRect alertFrame = [UIScreen mainScreen].applicationFrame;\n \n if (UIInterfaceOrientationIsLandscape([[UIApplication sharedApplication] statusBarOrientation])) {\n // swap the values for the app frame since it is now in landscape\n CGFloat temp = alertFrame.size.width;\n alertFrame.size.width = alertFrame.size.height;\n alertFrame.size.height = temp;\n }\n \n alertController.view.frame = alertFrame;\n }\n\n __weak CDVNotification* weakNotif = self;\n\n for (int n = 0; n < count; n++) {\n [alertController addAction:[UIAlertAction actionWithTitle:[buttons objectAtIndex:n]\n style:UIAlertActionStyleDefault\n handler:^(UIAlertAction * action)\n {\n CDVPluginResult* result;\n\n if ([dialogType isEqualToString:DIALOG_TYPE_PROMPT])\n {\n NSString* value0 = [[alertController.textFields objectAtIndex:0] text];\n NSDictionary* info = @{\n @\"buttonIndex\":@(n + 1),\n @\"input1\":(value0 ? value0 : [NSNull null])\n };\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:info];\n }\n else\n {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsInt:(int)(n + 1)];\n }\n\n [weakNotif.commandDelegate sendPluginResult:result callbackId:callbackId];\n }]];\n }\n \n if ([dialogType isEqualToString:DIALOG_TYPE_PROMPT]) {\n \n [alertController addTextFieldWithConfigurationHandler:^(UITextField *textField) {\n textField.text = defaultText;\n }];\n }\n \n if(!alertList)\n alertList = [[NSMutableArray alloc] init];\n [alertList addObject:alertController];\n \n if ([alertList count]==1) {\n [self presentAlertcontroller];\n }\n \n }\n else\n {\n#endif\n\n CDVAlertView* alertView = [[CDVAlertView alloc]\n initWithTitle:title\n message:message\n delegate:self\n cancelButtonTitle:nil\n otherButtonTitles:nil];\n \n alertView.callbackId = callbackId;\n \n \n \n for (int n = 0; n < count; n++) {\n [alertView addButtonWithTitle:[buttons objectAtIndex:n]];\n }\n \n if ([dialogType isEqualToString:DIALOG_TYPE_PROMPT]) {\n alertView.alertViewStyle = UIAlertViewStylePlainTextInput;\n UITextField* textField = [alertView textFieldAtIndex:0];\n textField.text = defaultText;\n }\n \n [alertView show];\n#ifdef __IPHONE_8_0\n }\n#endif\n \n}\n\n- (void)alert:(CDVInvokedUrlCommand*)command\n{\n NSString* callbackId = command.callbackId;\n NSString* message = [command argumentAtIndex:0];\n NSString* title = [command argumentAtIndex:1];\n NSString* buttons = [command argumentAtIndex:2];\n\n [self showDialogWithMessage:message title:title buttons:@[buttons] defaultText:nil callbackId:callbackId dialogType:DIALOG_TYPE_ALERT];\n}\n\n- (void)confirm:(CDVInvokedUrlCommand*)command\n{\n NSString* callbackId = command.callbackId;\n NSString* message = [command argumentAtIndex:0];\n NSString* title = [command argumentAtIndex:1];\n NSArray* buttons = [command argumentAtIndex:2];\n\n [self showDialogWithMessage:message title:title buttons:buttons defaultText:nil callbackId:callbackId dialogType:DIALOG_TYPE_ALERT];\n}\n\n- (void)prompt:(CDVInvokedUrlCommand*)command\n{\n NSString* callbackId = command.callbackId;\n NSString* message = [command argumentAtIndex:0];\n NSString* title = [command argumentAtIndex:1];\n NSArray* buttons = [command argumentAtIndex:2];\n NSString* defaultText = [command argumentAtIndex:3];\n\n [self showDialogWithMessage:message title:title buttons:buttons defaultText:defaultText callbackId:callbackId dialogType:DIALOG_TYPE_PROMPT];\n}\n\n/**\n * Callback invoked when an alert dialog's buttons are clicked.\n */\n- (void)alertView:(UIAlertView*)alertView clickedButtonAtIndex:(NSInteger)buttonIndex\n{\n CDVAlertView* cdvAlertView = (CDVAlertView*)alertView;\n CDVPluginResult* result;\n\n // Determine what gets returned to JS based on the alert view type.\n if (alertView.alertViewStyle == UIAlertViewStyleDefault) {\n // For alert and confirm, return button index as int back to JS.\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsInt:(int)(buttonIndex + 1)];\n } else {\n // For prompt, return button index and input text back to JS.\n NSString* value0 = [[alertView textFieldAtIndex:0] text];\n NSDictionary* info = @{\n @\"buttonIndex\":@(buttonIndex + 1),\n @\"input1\":(value0 ? value0 : [NSNull null])\n };\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:info];\n }\n [self.commandDelegate sendPluginResult:result callbackId:cdvAlertView.callbackId];\n}\n\nstatic void playBeep(int count) {\n SystemSoundID completeSound;\n NSInteger cbDataCount = count;\n NSURL* audioPath = [[NSBundle mainBundle] URLForResource:@\"CDVNotification.bundle/beep\" withExtension:@\"wav\"];\n #if __has_feature(objc_arc)\n AudioServicesCreateSystemSoundID((__bridge CFURLRef)audioPath, &completeSound);\n #else\n AudioServicesCreateSystemSoundID((CFURLRef)audioPath, &completeSound);\n #endif\n AudioServicesAddSystemSoundCompletion(completeSound, NULL, NULL, soundCompletionCallback, (void*)(cbDataCount-1));\n AudioServicesPlaySystemSound(completeSound);\n}\n\nstatic void soundCompletionCallback(SystemSoundID ssid, void* data) {\n int count = (int)data;\n AudioServicesRemoveSystemSoundCompletion (ssid);\n AudioServicesDisposeSystemSoundID(ssid);\n if (count > 0) {\n playBeep(count);\n }\n}\n\n- (void)beep:(CDVInvokedUrlCommand*)command\n{\n NSNumber* count = [command argumentAtIndex:0 withDefault:[NSNumber numberWithInt:1]];\n playBeep([count intValue]);\n}\n\n-(UIViewController *)getTopPresentedViewController {\n UIViewController *presentingViewController = self.viewController;\n while(presentingViewController.presentedViewController != nil && ![presentingViewController.presentedViewController isBeingDismissed])\n {\n presentingViewController = presentingViewController.presentedViewController;\n }\n return presentingViewController;\n}\n\n-(void)presentAlertcontroller {\n \n __weak CDVNotification* weakNotif = self;\n [self.getTopPresentedViewController presentViewController:[alertList firstObject] animated:YES completion:^{\n [alertList removeObject:[alertList firstObject]];\n if ([alertList count]>0) {\n [weakNotif presentAlertcontroller];\n }\n }];\n \n}\n\n@end\n\n@implementation CDVAlertView\n\n@synthesize callbackId;\n\n@end\n"
},
{
"path": "plugins/cordova-plugin-dialogs/src/ubuntu/notification.cpp",
"content": "/*\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n#include \"notification.h\"\n\n#include \n\nvoid Dialogs::beep(int scId, int ecId, int times) {\n Q_UNUSED(scId)\n Q_UNUSED(ecId)\n Q_UNUSED(times)\n\n _player.setVolume(100);\n _player.setMedia(QUrl::fromLocalFile(\"/usr/share/sounds/ubuntu/stereo/bell.ogg\"));\n _player.play();\n}\n\nvoid Dialogs::alert(int scId, int ecId, const QString &message, const QString &title, const QString &buttonLabel) {\n QStringList list;\n list.append(buttonLabel);\n\n confirm(scId, ecId, message, title, list);\n}\n\nvoid Dialogs::confirm(int scId, int ecId, const QString &message, const QString &title, const QStringList &buttonLabels) {\n Q_UNUSED(ecId);\n\n if (_alertCallback) {\n qCritical() << \"can't open second dialog\";\n return;\n }\n _alertCallback = scId;\n\n QString s1, s2, s3;\n if (buttonLabels.size() > 0)\n s1 = buttonLabels[0];\n if (buttonLabels.size() > 1)\n s2 = buttonLabels[1];\n if (buttonLabels.size() > 2)\n s3 = buttonLabels[2];\n\n QString path = m_cordova->get_app_dir() + \"/../qml/notification.qml\";\n QString qml = QString(\"PopupUtils.open(%1, root, { root: root, cordova: cordova, title: %2, text: %3, promptVisible: false, button1Text: %4, button2Text: %5, button3Text: %6 })\")\n .arg(CordovaInternal::format(path)).arg(CordovaInternal::format(title)).arg(CordovaInternal::format(message))\n .arg(CordovaInternal::format(s1)).arg(CordovaInternal::format(s2)).arg(CordovaInternal::format(s3));\n\n m_cordova->execQML(qml);\n}\n\nvoid Dialogs::prompt(int scId, int ecId, const QString &message, const QString &title, const QStringList &buttonLabels, const QString &defaultText) {\n Q_UNUSED(ecId);\n\n if (_alertCallback) {\n qCritical() << \"can't open second dialog\";\n return;\n }\n _alertCallback = scId;\n\n QString s1, s2, s3;\n if (buttonLabels.size() > 0)\n s1 = buttonLabels[0];\n if (buttonLabels.size() > 1)\n s2 = buttonLabels[1];\n if (buttonLabels.size() > 2)\n s3 = buttonLabels[2];\n QString path = m_cordova->get_app_dir() + \"/../qml/notification.qml\";\n QString qml = QString(\"PopupUtils.open(%1, root, { root: root, cordova: cordova, title: %2, text: %3, promptVisible: true, defaultPromptText: %7, button1Text: %4, button2Text: %5, button3Text: %6 })\")\n .arg(CordovaInternal::format(path)).arg(CordovaInternal::format(title)).arg(CordovaInternal::format(message))\n .arg(CordovaInternal::format(s1)).arg(CordovaInternal::format(s2))\n .arg(CordovaInternal::format(s3)).arg(CordovaInternal::format(defaultText));\n\n m_cordova->execQML(qml);\n}\n"
},
{
"path": "plugins/cordova-plugin-dialogs/src/ubuntu/notification.h",
"content": "/*\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n#ifndef NOTIFICATION_H\n#define NOTIFICATION_H\n\n#include \n#include \n#include \n#include \n\nclass Dialogs: public CPlugin {\n Q_OBJECT\npublic:\n explicit Dialogs(Cordova *cordova): CPlugin(cordova), _alertCallback(0) {\n }\n\n virtual const QString fullName() override {\n return Dialogs::fullID();\n }\n\n virtual const QString shortName() override {\n return \"Notification\";\n }\n\n static const QString fullID() {\n return \"Notification\";\n }\npublic slots:\n void beep(int scId, int ecId, int times);\n void alert(int scId, int ecId, const QString &message, const QString &title, const QString &buttonLabel);\n void confirm(int scId, int ecId, const QString &message, const QString &title, const QStringList &buttonLabels);\n void prompt(int scId, int ecId, const QString &message, const QString &title, const QStringList &buttonLabels, const QString &defaultText);\n\n void notificationDialogButtonPressed(int buttonId, const QString &text, bool prompt) {\n if (prompt) {\n QVariantMap res;\n res.insert(\"buttonIndex\", buttonId);\n res.insert(\"input1\", text);\n this->cb(_alertCallback, res);\n } else {\n this->cb(_alertCallback, buttonId);\n }\n _alertCallback = 0;\n }\n\nprivate:\n int _alertCallback;\n QMediaPlayer _player;\n};\n\n#endif\n"
},
{
"path": "plugins/cordova-plugin-dialogs/src/ubuntu/notification.qml",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n*/\n\nimport QtQuick 2.0\nimport Ubuntu.Components.Popups 0.1\nimport Ubuntu.Components 0.1\n\nDialog {\n id: dialogue\n property string button1Text\n property string button2Text\n property string button3Text\n property bool promptVisible\n property string defaultPromptText\n\n TextField {\n id: prompt\n text: defaultPromptText\n visible: promptVisible\n focus: true\n }\n Button {\n text: button1Text\n color: \"orange\"\n onClicked: {\n root.exec(\"Notification\", \"notificationDialogButtonPressed\", [1, prompt.text, promptVisible]);\n PopupUtils.close(dialogue)\n }\n }\n Button {\n text: button2Text\n visible: button2Text.length > 0\n color: \"orange\"\n onClicked: {\n root.exec(\"Notification\", \"notificationDialogButtonPressed\", [2, prompt.text, promptVisible]);\n PopupUtils.close(dialogue)\n }\n }\n Button {\n text: button3Text\n visible: button3Text.length > 0\n onClicked: {\n root.exec(\"Notification\", \"notificationDialogButtonPressed\", [3, prompt.text, promptVisible]);\n PopupUtils.close(dialogue)\n }\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-dialogs/src/windows/NotificationProxy.js",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n*/\n\n/*global Windows:true, WinJS, toStaticHTML */\n\nvar cordova = require('cordova');\n\nvar isAlertShowing = false;\nvar alertStack = [];\n\n// CB-8928: When toStaticHTML is undefined, prompt fails to run\nvar _cleanHtml = function(html) { return html; };\nif (typeof toStaticHTML !== 'undefined') {\n _cleanHtml = toStaticHTML;\n}\n\n// Windows does not provide native UI for promp dialog so we use some\n// simple html-based implementation until it is available\nfunction createPromptDialog(title, message, buttons, defaultText, callback) {\n\n var isPhone = cordova.platformId == \"windows\" && WinJS.Utilities.isPhone;\n\n var dlgWrap = document.createElement(\"div\");\n dlgWrap.style.position = \"absolute\";\n dlgWrap.style.width = \"100%\";\n dlgWrap.style.height = \"100%\";\n dlgWrap.style.backgroundColor = \"rgba(0,0,0,0.25)\";\n dlgWrap.style.zIndex = \"100000\";\n dlgWrap.className = \"dlgWrap\";\n\n var dlg = document.createElement(\"div\");\n dlg.style.width = \"100%\";\n dlg.style.minHeight = \"180px\";\n dlg.style.height = \"auto\";\n dlg.style.overflow = \"auto\";\n dlg.style.backgroundColor = \"white\";\n dlg.style.position = \"relative\";\n dlg.style.lineHeight = \"2\";\n\n if (isPhone) {\n dlg.style.padding = \"0px 5%\";\n } else {\n dlg.style.top = \"50%\"; // center vertically\n dlg.style.transform = \"translateY(-50%)\";\n dlg.style.padding = \"0px 30%\";\n }\n\n // dialog layout template\n dlg.innerHTML = _cleanHtml(\" \" + // title\n \" \" + // message\n \" \"); // input fields\n\n dlg.querySelector('#lbl-title').appendChild(document.createTextNode(title));\n dlg.querySelector('#lbl-message').appendChild(document.createTextNode(message));\n dlg.querySelector('#prompt-input').setAttribute('placeholder', defaultText);\n\n function makeButtonCallback(idx) {\n return function () {\n var value = dlg.querySelector('#prompt-input').value;\n dlgWrap.parentNode.removeChild(dlgWrap);\n\n if (callback) {\n callback({ input1: value, buttonIndex: idx });\n }\n };\n }\n\n function addButton(idx, label) {\n var button = document.createElement('button');\n button.style.margin = \"8px 0 8px 16px\";\n button.style.float = \"right\";\n button.style.fontSize = \"12pt\";\n button.tabIndex = idx;\n button.onclick = makeButtonCallback(idx + 1);\n if (idx === 0) {\n button.style.color = \"white\";\n button.style.backgroundColor = \"#464646\";\n } else {\n button.style.backgroundColor = \"#cccccc\";\n }\n button.style.border = \"none\";\n button.appendChild(document.createTextNode(label));\n dlg.appendChild(button);\n }\n\n // reverse order is used since we align buttons to the right\n for (var idx = buttons.length - 1; idx >= 0; idx--) {\n addButton(idx, buttons[idx]);\n }\n\n dlgWrap.appendChild(dlg);\n document.body.appendChild(dlgWrap);\n\n // make sure input field is under focus\n dlg.querySelector('#prompt-input').focus();\n\n return dlgWrap;\n}\n\nmodule.exports = {\n alert:function(win, loseX, args) {\n\n if (isAlertShowing) {\n var later = function () {\n module.exports.alert(win, loseX, args);\n };\n alertStack.push(later);\n return;\n }\n isAlertShowing = true;\n\n var message = args[0];\n var _title = args[1];\n var _buttonLabel = args[2];\n\n var md = new Windows.UI.Popups.MessageDialog(message, _title);\n md.commands.append(new Windows.UI.Popups.UICommand(_buttonLabel));\n md.showAsync().then(function() {\n isAlertShowing = false;\n if (win) {\n win();\n }\n\n if (alertStack.length) {\n setTimeout(alertStack.shift(), 0);\n }\n\n });\n },\n\n prompt: function (win, lose, args) {\n if (isAlertShowing) {\n var later = function () {\n module.exports.prompt(win, lose, args);\n };\n alertStack.push(later);\n return;\n }\n\n isAlertShowing = true;\n\n var message = args[0],\n title = args[1],\n buttons = args[2],\n defaultText = args[3];\n\n try {\n createPromptDialog(title, message, buttons, defaultText, function (evt) {\n isAlertShowing = false;\n if (win) {\n win(evt);\n }\n });\n\n } catch (e) {\n // set isAlertShowing flag back to false in case of exception\n isAlertShowing = false;\n if (alertStack.length) {\n setTimeout(alertStack.shift(), 0);\n }\n // rethrow exception\n throw e;\n }\n },\n\n confirm:function(win, loseX, args) {\n\n if (isAlertShowing) {\n var later = function () {\n module.exports.confirm(win, loseX, args);\n };\n alertStack.push(later);\n return;\n }\n\n isAlertShowing = true;\n\n try {\n var message = args[0];\n var _title = args[1];\n var buttons = args[2];\n\n var md = new Windows.UI.Popups.MessageDialog(message, _title);\n\n buttons.forEach(function(buttonLabel) {\n md.commands.append(new Windows.UI.Popups.UICommand(buttonLabel));\n });\n\n md.showAsync().then(function(res) {\n isAlertShowing = false;\n var result = res ? buttons.indexOf(res.label) + 1 : 0;\n if (win) {\n win(result);\n }\n if (alertStack.length) {\n setTimeout(alertStack.shift(), 0);\n }\n\n });\n } catch (e) {\n // set isAlertShowing flag back to false in case of exception\n isAlertShowing = false;\n if (alertStack.length) {\n setTimeout(alertStack.shift(), 0);\n }\n // rethrow exception\n throw e;\n }\n },\n\n beep:function(winX, loseX, args) {\n\n // set a default args if it is not set\n args = args && args.length ? args : [\"1\"];\n\n var snd = new Audio('ms-winsoundevent:Notification.Default');\n var count = parseInt(args[0]) || 1;\n snd.msAudioCategory = \"Alerts\";\n\n var onEvent = function () {\n if (count > 0) {\n snd.play();\n } else {\n snd.removeEventListener(\"ended\", onEvent);\n snd = null;\n if (winX) {\n winX(); // notification.js just sends null, but this is future friendly\n }\n }\n count--;\n };\n snd.addEventListener(\"ended\", onEvent);\n onEvent();\n\n }\n};\n\nrequire(\"cordova/exec/proxy\").add(\"Notification\",module.exports);\n"
},
{
"path": "plugins/cordova-plugin-dialogs/src/wp/Notification.cs",
"content": "/* \n\tLicensed under the Apache License, Version 2.0 (the \"License\");\n\tyou may not use this file except in compliance with the License.\n\tYou may obtain a copy of the License at\n\t\n\thttp://www.apache.org/licenses/LICENSE-2.0\n\t\n\tUnless required by applicable law or agreed to in writing, software\n\tdistributed under the License is distributed on an \"AS IS\" BASIS,\n\tWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n\tSee the License for the specific language governing permissions and\n\tlimitations under the License.\n*/\n\nusing System;\nusing System.Windows;\nusing System.Windows.Controls;\nusing Microsoft.Devices;\nusing System.Runtime.Serialization;\nusing System.Threading;\nusing System.Windows.Resources;\nusing Microsoft.Phone.Controls;\nusing Microsoft.Xna.Framework.Audio;\nusing WPCordovaClassLib.Cordova.UI;\nusing System.Diagnostics;\n\n\nnamespace WPCordovaClassLib.Cordova.Commands\n{\n public class Notification : BaseCommand\n {\n static ProgressBar progressBar = null;\n const int DEFAULT_DURATION = 5;\n\n private NotificationBox notifyBox;\n\n private class NotifBoxData\n {\n public NotificationBox previous {get;set;}\n public string callbackId { get; set; }\n }\n\n private PhoneApplicationPage Page\n {\n get\n {\n PhoneApplicationPage page = null;\n PhoneApplicationFrame frame = Application.Current.RootVisual as PhoneApplicationFrame;\n if (frame != null)\n {\n page = frame.Content as PhoneApplicationPage;\n }\n return page;\n }\n }\n\n // blink api - doesn't look like there is an equivalent api we can use...\n\n [DataContract]\n public class AlertOptions\n {\n [OnDeserializing]\n public void OnDeserializing(StreamingContext context)\n {\n // set defaults\n this.message = \"message\";\n this.title = \"Alert\";\n this.buttonLabel = \"ok\";\n }\n\n /// \n /// message to display in the alert box\n /// \n [DataMember]\n public string message;\n\n /// \n /// title displayed on the alert window\n /// \n [DataMember]\n public string title;\n\n /// \n /// text to display on the button\n /// \n [DataMember]\n public string buttonLabel;\n }\n\n [DataContract]\n public class PromptResult\n {\n [DataMember]\n public int buttonIndex;\n\n [DataMember]\n public string input1;\n\n public PromptResult(int index, string text)\n {\n this.buttonIndex = index;\n this.input1 = text;\n }\n }\n\n public void alert(string options)\n {\n string[] args = JSON.JsonHelper.Deserialize(options);\n AlertOptions alertOpts = new AlertOptions();\n alertOpts.message = args[0];\n alertOpts.title = args[1];\n alertOpts.buttonLabel = args[2];\n string aliasCurrentCommandCallbackId = args[3];\n\n Deployment.Current.Dispatcher.BeginInvoke(() =>\n {\n PhoneApplicationPage page = Page;\n if (page != null)\n {\n Grid grid = page.FindName(\"LayoutRoot\") as Grid;\n if (grid != null)\n {\n var previous = notifyBox;\n notifyBox = new NotificationBox();\n notifyBox.Tag = new NotifBoxData { previous = previous, callbackId = aliasCurrentCommandCallbackId };\n notifyBox.PageTitle.Text = alertOpts.title;\n notifyBox.SubTitle.Text = alertOpts.message;\n Button btnOK = new Button();\n btnOK.Content = alertOpts.buttonLabel;\n btnOK.Click += new RoutedEventHandler(btnOK_Click);\n btnOK.Tag = 1;\n notifyBox.ButtonPanel.Children.Add(btnOK);\n grid.Children.Add(notifyBox);\n\n if (previous == null)\n {\n page.BackKeyPress += page_BackKeyPress;\n }\n }\n }\n else\n {\n DispatchCommandResult(new PluginResult(PluginResult.Status.INSTANTIATION_EXCEPTION));\n }\n });\n }\n\n public void prompt(string options)\n {\n string[] args = JSON.JsonHelper.Deserialize(options);\n string message = args[0];\n string title = args[1];\n string buttonLabelsArray = args[2];\n string[] buttonLabels = JSON.JsonHelper.Deserialize(buttonLabelsArray);\n string defaultText = args[3];\n string aliasCurrentCommandCallbackId = args[4];\n\n Deployment.Current.Dispatcher.BeginInvoke(() =>\n {\n PhoneApplicationPage page = Page;\n if (page != null)\n {\n Grid grid = page.FindName(\"LayoutRoot\") as Grid;\n if (grid != null)\n {\n var previous = notifyBox;\n notifyBox = new NotificationBox();\n notifyBox.Tag = new NotifBoxData { previous = previous, callbackId = aliasCurrentCommandCallbackId };\n notifyBox.PageTitle.Text = title;\n notifyBox.SubTitle.Text = message;\n\n //TextBox textBox = new TextBox();\n //textBox.Text = defaultText;\n //textBox.AcceptsReturn = true;\n //notifyBox.ContentScroller.Content = textBox;\n\n notifyBox.InputText.Text = defaultText;\n notifyBox.InputText.Visibility = Visibility.Visible;\n\n for (int i = 0; i < buttonLabels.Length; ++i)\n {\n Button button = new Button();\n button.Content = buttonLabels[i];\n button.Tag = i + 1;\n button.Click += promptBoxbutton_Click;\n notifyBox.ButtonPanel.Orientation = Orientation.Vertical;\n notifyBox.ButtonPanel.Children.Add(button);\n }\n\n grid.Children.Add(notifyBox);\n if (previous != null)\n {\n page.BackKeyPress += page_BackKeyPress;\n }\n }\n }\n else\n {\n DispatchCommandResult(new PluginResult(PluginResult.Status.INSTANTIATION_EXCEPTION));\n }\n });\n }\n\n public void confirm(string options)\n {\n string[] args = JSON.JsonHelper.Deserialize(options);\n AlertOptions alertOpts = new AlertOptions();\n alertOpts.message = args[0];\n alertOpts.title = args[1];\n alertOpts.buttonLabel = args[2];\n string aliasCurrentCommandCallbackId = args[3];\n\n Deployment.Current.Dispatcher.BeginInvoke(() =>\n {\n PhoneApplicationPage page = Page;\n if (page != null)\n {\n Grid grid = page.FindName(\"LayoutRoot\") as Grid;\n if (grid != null)\n {\n var previous = notifyBox;\n notifyBox = new NotificationBox();\n notifyBox.Tag = new NotifBoxData { previous = previous, callbackId = aliasCurrentCommandCallbackId };\n notifyBox.PageTitle.Text = alertOpts.title;\n notifyBox.SubTitle.Text = alertOpts.message;\n\n string[] labels = JSON.JsonHelper.Deserialize(alertOpts.buttonLabel);\n\n if (labels == null)\n {\n labels = alertOpts.buttonLabel.Split(',');\n }\n\n for (int n = 0; n < labels.Length; n++)\n {\n Button btn = new Button();\n btn.Content = labels[n];\n btn.Tag = n;\n btn.Click += new RoutedEventHandler(btnOK_Click);\n notifyBox.ButtonPanel.Children.Add(btn);\n }\n\n grid.Children.Add(notifyBox);\n if (previous == null)\n {\n page.BackKeyPress += page_BackKeyPress;\n }\n }\n }\n else\n {\n DispatchCommandResult(new PluginResult(PluginResult.Status.INSTANTIATION_EXCEPTION));\n }\n });\n }\n\n void promptBoxbutton_Click(object sender, RoutedEventArgs e)\n {\n Button button = sender as Button;\n FrameworkElement promptBox = null;\n int buttonIndex = 0;\n string callbackId = string.Empty;\n string text = string.Empty;\n if (button != null)\n {\n buttonIndex = (int)button.Tag;\n promptBox = button.Parent as FrameworkElement;\n while ((promptBox = promptBox.Parent as FrameworkElement) != null &&\n !(promptBox is NotificationBox)) ;\n }\n\n if (promptBox != null)\n {\n NotificationBox box = promptBox as NotificationBox;\n\n text = box.InputText.Text;\n\n PhoneApplicationPage page = Page;\n if (page != null)\n {\n Grid grid = page.FindName(\"LayoutRoot\") as Grid;\n if (grid != null)\n {\n grid.Children.Remove(promptBox);\n }\n\n NotifBoxData data = promptBox.Tag as NotifBoxData;\n promptBox = data.previous as NotificationBox;\n callbackId = data.callbackId as string;\n\n if (promptBox == null)\n {\n page.BackKeyPress -= page_BackKeyPress;\n }\n }\n }\n DispatchCommandResult(new PluginResult(PluginResult.Status.OK, new PromptResult(buttonIndex, text)), callbackId);\n }\n\n void page_BackKeyPress(object sender, System.ComponentModel.CancelEventArgs e)\n {\n PhoneApplicationPage page = sender as PhoneApplicationPage;\n string callbackId = \"\";\n if (page != null && notifyBox != null)\n {\n Grid grid = page.FindName(\"LayoutRoot\") as Grid;\n if (grid != null)\n {\n grid.Children.Remove(notifyBox);\n NotifBoxData notifBoxData = notifyBox.Tag as NotifBoxData;\n notifyBox = notifBoxData.previous as NotificationBox;\n callbackId = notifBoxData.callbackId as string;\n }\n if (notifyBox == null)\n {\n page.BackKeyPress -= page_BackKeyPress;\n }\n e.Cancel = true;\n }\n\n DispatchCommandResult(new PluginResult(PluginResult.Status.OK, 0), callbackId);\n }\n\n void btnOK_Click(object sender, RoutedEventArgs e)\n {\n Button btn = sender as Button;\n FrameworkElement notifBoxParent = null;\n int retVal = 0;\n string callbackId = \"\";\n if (btn != null)\n {\n retVal = (int)btn.Tag + 1;\n\n notifBoxParent = btn.Parent as FrameworkElement;\n while ((notifBoxParent = notifBoxParent.Parent as FrameworkElement) != null &&\n !(notifBoxParent is NotificationBox)) ;\n }\n if (notifBoxParent != null)\n {\n PhoneApplicationPage page = Page;\n if (page != null)\n {\n Grid grid = page.FindName(\"LayoutRoot\") as Grid;\n if (grid != null)\n {\n grid.Children.Remove(notifBoxParent);\n }\n\n NotifBoxData notifBoxData = notifBoxParent.Tag as NotifBoxData;\n notifyBox = notifBoxData.previous as NotificationBox;\n callbackId = notifBoxData.callbackId as string;\n\n if (notifyBox == null)\n {\n page.BackKeyPress -= page_BackKeyPress;\n }\n }\n\n }\n DispatchCommandResult(new PluginResult(PluginResult.Status.OK, retVal), callbackId);\n }\n\n\n\n public void beep(string options)\n {\n string[] args = JSON.JsonHelper.Deserialize(options);\n int times = int.Parse(args[0]);\n\n string resourcePath = BaseCommand.GetBaseURL() + \"Plugins/cordova-plugin-dialogs/notification-beep.wav\";\n\n StreamResourceInfo sri = Application.GetResourceStream(new Uri(resourcePath, UriKind.Relative));\n\n if (sri != null)\n {\n SoundEffect effect = SoundEffect.FromStream(sri.Stream);\n SoundEffectInstance inst = effect.CreateInstance();\n ThreadPool.QueueUserWorkItem((o) =>\n {\n // cannot interact with UI !!\n do\n {\n inst.Play();\n Thread.Sleep(effect.Duration + TimeSpan.FromMilliseconds(100));\n }\n while (--times > 0);\n\n });\n\n }\n\n // TODO: may need a listener to trigger DispatchCommandResult after the alarm has finished executing...\n DispatchCommandResult();\n }\n\n // Display an indeterminate progress indicator\n public void activityStart(string unused)\n {\n\n Deployment.Current.Dispatcher.BeginInvoke(() =>\n {\n PhoneApplicationFrame frame = Application.Current.RootVisual as PhoneApplicationFrame;\n\n if (frame != null)\n {\n PhoneApplicationPage page = frame.Content as PhoneApplicationPage;\n\n if (page != null)\n {\n var temp = page.FindName(\"LayoutRoot\");\n Grid grid = temp as Grid;\n if (grid != null)\n {\n if (progressBar != null)\n {\n grid.Children.Remove(progressBar);\n }\n progressBar = new ProgressBar();\n progressBar.IsIndeterminate = true;\n progressBar.IsEnabled = true;\n\n grid.Children.Add(progressBar);\n }\n }\n }\n });\n }\n\n\n // Remove our indeterminate progress indicator\n public void activityStop(string unused)\n {\n Deployment.Current.Dispatcher.BeginInvoke(() =>\n {\n if (progressBar != null)\n {\n progressBar.IsEnabled = false;\n PhoneApplicationFrame frame = Application.Current.RootVisual as PhoneApplicationFrame;\n if (frame != null)\n {\n PhoneApplicationPage page = frame.Content as PhoneApplicationPage;\n if (page != null)\n {\n Grid grid = page.FindName(\"LayoutRoot\") as Grid;\n if (grid != null)\n {\n grid.Children.Remove(progressBar);\n }\n }\n }\n progressBar = null;\n }\n });\n }\n\n public void vibrate(string vibrateDuration)\n {\n\n int msecs = 200; // set default\n\n try\n {\n string[] args = JSON.JsonHelper.Deserialize(vibrateDuration);\n\n msecs = int.Parse(args[0]);\n if (msecs < 1)\n {\n msecs = 1;\n }\n }\n catch (FormatException)\n {\n\n }\n\n VibrateController.Default.Start(TimeSpan.FromMilliseconds(msecs));\n\n // TODO: may need to add listener to trigger DispatchCommandResult when the vibration ends...\n DispatchCommandResult();\n }\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-dialogs/src/wp/NotificationBox.xaml",
"content": "\n\n\n \n \n \n \n \n\n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n\n \n \n \n\n \n \n\n\n"
},
{
"path": "plugins/cordova-plugin-dialogs/src/wp/NotificationBox.xaml.cs",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License. \n*/\n\nusing System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing System.Net;\nusing System.Windows;\nusing System.Windows.Controls;\nusing System.Windows.Documents;\nusing System.Windows.Input;\nusing System.Windows.Media;\nusing System.Windows.Media.Animation;\nusing System.Windows.Shapes;\n\nnamespace WPCordovaClassLib.Cordova.UI\n{\n public partial class NotificationBox : UserControl\n {\n public NotificationBox()\n {\n InitializeComponent();\n }\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-dialogs/tests/plugin.xml",
"content": "\n\n\n\n Cordova Notification Plugin Tests\n Apache 2.0\n\n \n \n\n"
},
{
"path": "plugins/cordova-plugin-dialogs/tests/tests.js",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n*/\n\n/* jshint jasmine: true */\n/* global cordova */\n\nexports.defineAutoTests = function () {\n describe('Notification (navigator.notification)', function () {\n it(\"should exist\", function () {\n expect(navigator.notification).toBeDefined();\n });\n\n it(\"should contain a beep function\", function () {\n expect(typeof navigator.notification.beep).toBeDefined();\n expect(typeof navigator.notification.beep).toBe(\"function\");\n });\n\n it(\"should contain an alert function\", function () {\n expect(typeof navigator.notification.alert).toBeDefined();\n expect(typeof navigator.notification.alert).toBe(\"function\");\n });\n\n it(\"should contain a confirm function\", function () {\n expect(typeof navigator.notification.confirm).toBeDefined();\n expect(typeof navigator.notification.confirm).toBe(\"function\");\n });\n\n it(\"should contain a prompt function\", function () {\n expect(typeof navigator.notification.prompt).toBeDefined();\n expect(typeof navigator.notification.prompt).toBe(\"function\");\n });\n });\n};\n\n/******************************************************************************/\n/******************************************************************************/\n/******************************************************************************/\n\nexports.defineManualTests = function (contentEl, createActionButton) {\n var logMessage = function (message) {\n var log = document.getElementById('info');\n var logLine = document.createElement('div');\n logLine.innerHTML = message;\n log.appendChild(logLine);\n };\n\n var clearLog = function () {\n var log = document.getElementById('info');\n log.innerHTML = '';\n };\n\n var beep = function () {\n console.log(\"beep()\");\n navigator.notification.beep(3);\n };\n\n var alertDialog = function (message, title, button) {\n console.log(\"alertDialog()\");\n navigator.notification.alert(message,\n function () {\n console.log(\"Alert dismissed.\");\n },\n title, button);\n console.log(\"After alert\");\n };\n\n var confirmDialogA = function (message, title, buttons) {\n clearLog();\n navigator.notification.confirm(message,\n function (r) {\n if (r === 0) {\n logMessage(\"Dismissed dialog without making a selection.\");\n console.log(\"Dismissed dialog without making a selection.\");\n } else {\n console.log(\"You selected \" + r);\n logMessage(\"You selected \" + (buttons.split(\",\"))[r - 1]);\n }\n },\n title,\n buttons);\n };\n\n var confirmDialogB = function (message, title, buttons) {\n clearLog();\n navigator.notification.confirm(message,\n function (r) {\n if (r === 0) {\n logMessage(\"Dismissed dialog without making a selection.\");\n console.log(\"Dismissed dialog without making a selection.\");\n } else {\n console.log(\"You selected \" + r);\n logMessage(\"You selected \" + buttons[r - 1]);\n }\n },\n title,\n buttons);\n };\n\n var promptDialog = function (message, title, buttons) {\n clearLog();\n navigator.notification.prompt(message,\n function (r) {\n if (r && r.buttonIndex === 0) {\n var msg = \"Dismissed dialog\";\n if (r.input1) {\n msg += \" with input: \" + r.input1;\n }\n logMessage(msg);\n console.log(msg);\n } else {\n console.log(\"You selected \" + r.buttonIndex + \" and entered: \" + r.input1);\n logMessage(\"You selected \" + buttons[r.buttonIndex - 1] + \" and entered: \" + r.input1);\n }\n },\n title,\n buttons);\n };\n\n /******************************************************************************/\n\n var dialogs_tests = '' +\n 'Expected result: Device will beep (unless device is on silent). Nothing will get updated in status box.' +\n '
Dialog Tests
' +\n '
Dialog boxes will pop up for each of the following tests
' +\n ' ' +\n 'Expected result: Dialog will say \"You pressed alert\". Press continue to close dialog. Nothing will get updated in status box.' +\n ' ' +\n 'Expected result: Dialog will say \"You pressed confirm\". Press Yes, No, or Maybe to close dialog. Status box will tell you what option you selected.' +\n ' ' +\n 'Expected result: Dialog will say \"You pressed confirm\". Press Yes, No, or Maybe, Not Sure to close dialog. Status box will tell you what option you selected, and should use 1-based indexing.' +\n ' ' +\n 'Expected result: Dialog will say \"You pressed prompt\". Enter any message and press Yes, No, or Maybe, Not Sure to close dialog. Status box will tell you what option you selected and message you entered, and should use 1-based indexing.' +\n ' ' +\n 'Expected result: Dialog will have title \"index.html\" and say \"You pressed alert\" Press OK to close dialog. Nothing will get updated in status box.' +\n ' ' +\n 'Expected result: Dialog will have title \"index.html\" and say \"You selected confirm\". Press Cancel or OK to close dialog. Nothing will get updated in status box.' +\n ' ' +\n 'Expected result: Dialog will have title \"index.html\" and say \"This is a prompt\". \"Default value\" will be in text box. Press Cancel or OK to close dialog. Nothing will get updated in status box.';\n\n contentEl.innerHTML = '' +\n dialogs_tests;\n\n createActionButton('Beep', function () {\n beep();\n }, 'beep');\n\n createActionButton('Alert Dialog', function () {\n alertDialog('You pressed alert.', 'Alert Dialog', 'Continue');\n }, 'alert');\n\n // WP8.1 detection is necessary since it doesn't support confirm dialogs with more than 2 buttons\n var isRunningOnWP81 = cordova.platformId == \"windows\" && navigator.userAgent.indexOf('Windows Phone') > -1;\n\n createActionButton('Confirm Dialog - Deprecated', function () {\n var buttons = isRunningOnWP81 ? 'Yes,No' : 'Yes,No,Maybe';\n confirmDialogA('You pressed confirm.', 'Confirm Dialog', buttons);\n }, 'confirm_deprecated');\n\n createActionButton('Confirm Dialog', function () {\n var buttons = isRunningOnWP81 ? ['Yes', 'Actually, No'] : ['Yes', 'No', 'Maybe, Not Sure'];\n confirmDialogB('You pressed confirm.', 'Confirm Dialog', buttons);\n }, 'confirm');\n\n createActionButton('Prompt Dialog', function () {\n promptDialog('You pressed prompt.', 'Prompt Dialog', ['Yes', 'No', 'Maybe, Not Sure']);\n }, 'prompt');\n\n createActionButton('Built-in Alert Dialog', function () {\n if (typeof alert === 'function') {\n alert('You pressed alert');\n }\n }, 'built_in_alert');\n\n createActionButton('Built-in Confirm Dialog', function () {\n if (typeof confirm === 'function') {\n confirm('You selected confirm');\n }\n }, 'built_in_confirm');\n\n createActionButton('Built-in Prompt Dialog', function () {\n if (typeof prompt === 'function') {\n prompt('This is a prompt', 'Default value');\n }\n }, 'built_in_prompt');\n};\n"
},
{
"path": "plugins/cordova-plugin-dialogs/www/android/notification.js",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n*/\n\nvar exec = require('cordova/exec');\n\n/**\n * Provides Android enhanced notification API.\n */\nmodule.exports = {\n activityStart : function(title, message) {\n // If title and message not specified then mimic Android behavior of\n // using default strings.\n if (typeof title === \"undefined\" && typeof message == \"undefined\") {\n title = \"Busy\";\n message = 'Please wait...';\n }\n\n exec(null, null, 'Notification', 'activityStart', [ title, message ]);\n },\n\n /**\n * Close an activity dialog\n */\n activityStop : function() {\n exec(null, null, 'Notification', 'activityStop', []);\n },\n\n /**\n * Display a progress dialog with progress bar that goes from 0 to 100.\n *\n * @param {String}\n * title Title of the progress dialog.\n * @param {String}\n * message Message to display in the dialog.\n */\n progressStart : function(title, message) {\n exec(null, null, 'Notification', 'progressStart', [ title, message ]);\n },\n\n /**\n * Close the progress dialog.\n */\n progressStop : function() {\n exec(null, null, 'Notification', 'progressStop', []);\n },\n\n /**\n * Set the progress dialog value.\n *\n * @param {Number}\n * value 0-100\n */\n progressValue : function(value) {\n exec(null, null, 'Notification', 'progressValue', [ value ]);\n }\n};\n"
},
{
"path": "plugins/cordova-plugin-dialogs/www/blackberry10/beep.js",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n*/\n\nmodule.exports = function (quantity) {\n var count = 0,\n beepObj;\n\n function callback() {\n if (--count > 0) {\n play();\n } else {\n beepObj.removeEventListener(\"ended\", callback);\n beepObj = null;\n }\n }\n\n function play() { \n //create new object every time due to strage playback behaviour\n beepObj = new Audio('local:///chrome/plugin/cordova-plugin-dialogs/notification-beep.wav');\n beepObj.addEventListener(\"ended\", callback);\n beepObj.play();\n }\n\n count += quantity || 1;\n if (count > 0) {\n play();\n }\n};\n"
},
{
"path": "plugins/cordova-plugin-dialogs/www/browser/notification.js",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n*/\n\n// Platform: browser\nwindow.navigator.notification = window.navigator.notification || {};\n\nmodule.exports.alert = window.navigator.notification.alert = function(message, callback) {\n // `notification.alert` executes asynchronously\n setTimeout(function() {\n window.alert(message);\n if (callback) {\n callback();\n }\n }, 0);\n};\n\n\nmodule.exports.confirm = window.navigator.notification.confirm = function(message, callback) {\n // `notification.confirm` executes asynchronously\n setTimeout(function() {\n var result = window.confirm(message);\n if (callback) {\n if (result) {\n callback(1); // OK\n }\n else {\n callback(2); // Cancel\n }\n }\n }, 0);\n};\n\n\nmodule.exports.prompt = window.navigator.notification.prompt = function(message, callback, title, buttonLabels, defaultText) {\n // `notification.prompt` executes asynchronously\n setTimeout(function() {\n var result = window.prompt(message, defaultText || '');\n if (callback) {\n if (result === null) {\n callback({ buttonIndex: 2, input1: '' }); // Cancel\n }\n else {\n callback({ buttonIndex: 1, input1: result }); // OK\n }\n }\n }, 0);\n};\n\n\nvar audioContext = (function() {\n // Determine if the Audio API is supported by this browser\n var AudioApi = window.AudioContext;\n if (!AudioApi) {\n AudioApi = window.webkitAudioContext;\n }\n\n if (AudioApi) {\n // The Audio API is supported, so create a singleton instance of the AudioContext\n return new AudioApi();\n }\n\n return undefined;\n}());\n\nmodule.exports.beep = window.navigator.notification.beep = function(times) {\n if (times > 0) {\n var BEEP_DURATION = 700;\n var BEEP_INTERVAL = 300;\n\n if (audioContext) {\n // Start a beep, using the Audio API\n var osc = audioContext.createOscillator();\n osc.type = 0; // sounds like a \"beep\"\n osc.connect(audioContext.destination);\n osc.start(0);\n\n setTimeout(function() {\n // Stop the beep after the BEEP_DURATION\n osc.stop(0);\n\n if (--times > 0) {\n // Beep again, after a pause\n setTimeout(function() {\n navigator.notification.beep(times);\n }, BEEP_INTERVAL);\n }\n\n }, BEEP_DURATION);\n }\n else if (typeof(console) !== 'undefined' && typeof(console.log) === 'function') {\n // Audio API isn't supported, so just write `beep` to the console\n for (var i = 0; i < times; i++) {\n console.log('Beep!');\n }\n }\n }\n};\n"
},
{
"path": "plugins/cordova-plugin-dialogs/www/firefoxos/notification.css",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n*/\n\n/* Main dialog setup */\nform[role=\"dialog\"] {\n background:\n url(../img/pattern.png) repeat left top,\n url(../img/gradient.png) no-repeat left top / 100% 100%;\n overflow: hidden;\n position: absolute;\n z-index: 100;\n top: 0;\n left: 0;\n right: 0;\n bottom: 0;\n padding: 1.5rem 0 7rem;\n font-family: \"MozTT\", Sans-serif;\n font-size: 0;\n /* Using font-size: 0; we avoid the unwanted visual space (about 3px)\n created by white-spaces and break lines in the code betewen inline-block elements */\n color: #fff;\n text-align: left;\n}\n\nform[role=\"dialog\"]:before {\n content: \"\";\n display: inline-block;\n vertical-align: middle;\n width: 0.1rem;\n height: 100%;\n margin-left: -0.1rem;\n}\n\nform[role=\"dialog\"] > section {\n font-weight: lighter;\n font-size: 1.8rem;\n color: #FAFAFA;\n padding: 0 1.5rem;\n -moz-box-sizing: padding-box;\n width: 100%;\n display: inline-block;\n overflow-y: scroll;\n max-height: 100%;\n vertical-align: middle;\n white-space: normal;\n}\n\nform[role=\"dialog\"] h1 {\n font-weight: normal;\n font-size: 1.6rem;\n line-height: 1.5em;\n color: #fff;\n margin: 0;\n padding: 0 1.5rem 1rem;\n border-bottom: 0.1rem solid #686868;\n}\n\n/* Menu & buttons setup */\nform[role=\"dialog\"] menu {\n margin: 0;\n padding: 1.5rem;\n padding-bottom: 0.5rem;\n border-top: solid 0.1rem rgba(255, 255, 255, 0.1);\n background: #2d2d2d url(../img/pattern.png) repeat left top;\n display: block;\n overflow: hidden;\n position: absolute;\n left: 0;\n right: 0;\n bottom: 0;\n text-align: center;\n}\n\nform[role=\"dialog\"] menu button::-moz-focus-inner {\n border: none;\n outline: none;\n}\nform[role=\"dialog\"] menu button {\n width: 100%;\n height: 2.4rem;\n margin: 0 0 1rem;\n padding: 0 1.5rem;\n -moz-box-sizing: border-box;\n display: inline-block;\n vertical-align: middle;\n text-overflow: ellipsis;\n white-space: nowrap;\n overflow: hidden;\n background: #fafafa url(../img/default.png) repeat-x left bottom/ auto 100%;\n border: 0.1rem solid #a6a6a6;\n border-radius: 0.3rem;\n font: 500 1.2rem/2.4rem 'MozTT', Sans-serif;\n color: #333;\n text-align: center;\n text-shadow: 0.1rem 0.1rem 0 rgba(255,255,255,0.3);\n text-decoration: none;\n outline: none;\n}\n\n/* Press (default & recommend) */\nform[role=\"dialog\"] menu button:active,\nform[role=\"dialog\"] menu button.recommend:active,\na.recommend[role=\"button\"]:active {\n border-color: #008aaa;\n color: #333;\n}\n\n/* Recommend */\nform[role=\"dialog\"] menu button.recommend {\n background-image: url(../img/recommend.png);\n background-color: #00caf2;\n border-color: #008eab;\n}\n\n/* Danger */\nform[role=\"dialog\"] menu button.danger,\na.danger[role=\"button\"] {\n background-image: url(../img/danger.png);\n background-color: #b70404;\n color: #fff;\n text-shadow: none;\n border-color: #820000;\n}\n\n/* Danger Press */\nform[role=\"dialog\"] menu button.danger:active {\n background-image: url(../img/danger-press.png);\n background-color: #890707;\n}\n\n/* Disabled */\nform[role=\"dialog\"] > menu > button[disabled] {\n background: #5f5f5f;\n color: #4d4d4d;\n text-shadow: none;\n border-color: #4d4d4d;\n pointer-events: none;\n}\n\n\nform[role=\"dialog\"] menu button:nth-child(even) {\n margin-left: 1rem;\n}\n\nform[role=\"dialog\"] menu button,\nform[role=\"dialog\"] menu button:nth-child(odd) {\n margin: 0 0 1rem 0;\n}\n\nform[role=\"dialog\"] menu button {\n width: calc((100% - 1rem) / 2);\n}\n\nform[role=\"dialog\"] menu button.full {\n width: 100%;\n}\n\n/* Specific component code */\nform[role=\"dialog\"] p {\n word-wrap: break-word;\n margin: 1rem 0 0;\n padding: 0 1.5rem 1rem;\n line-height: 3rem;\n}\n\nform[role=\"dialog\"] p img {\n float: left;\n margin-right: 2rem;\n}\n\nform[role=\"dialog\"] p strong {\n font-weight: lighter;\n}\n\nform[role=\"dialog\"] p small {\n font-size: 1.4rem;\n font-weight: normal;\n color: #cbcbcb;\n display: block;\n}\n\nform[role=\"dialog\"] dl {\n border-top: 0.1rem solid #686868;\n margin: 1rem 0 0;\n overflow: hidden;\n padding-top: 1rem;\n font-size: 1.6rem;\n line-height: 2.2rem;\n}\n\nform[role=\"dialog\"] dl > dt {\n clear: both;\n float: left;\n width: 7rem;\n padding-left: 1.5rem;\n font-weight: 500;\n text-align: left;\n}\n\nform[role=\"dialog\"] dl > dd {\n padding-right: 1.5rem;\n font-weight: 300;\n text-overflow: ellipsis;\n vertical-align: top;\n overflow: hidden;\n}\n\n/* input areas */\ninput[type=\"text\"],\ninput[type=\"password\"],\ninput[type=\"email\"],\ninput[type=\"tel\"],\ninput[type=\"search\"],\ninput[type=\"url\"],\ninput[type=\"number\"],\ntextarea {\n -moz-box-sizing: border-box;\n display: block;\n overflow: hidden;\n width: 100%;\n height: 3rem;\n resize: none;\n padding: 0 1rem;\n font-size: 1.6rem;\n line-height: 3rem;\n border: 0.1rem solid #ccc;\n border-radius: 0.3rem;\n box-shadow: none; /* override the box-shadow from the system (performance issue) */\n background: #fff url(input_areas/images/ui/shadow.png) repeat-x;\n}\n"
},
{
"path": "plugins/cordova-plugin-dialogs/www/notification.js",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n*/\n\nvar exec = require('cordova/exec');\nvar platform = require('cordova/platform');\n\n/**\n * Provides access to notifications on the device.\n */\n\nmodule.exports = {\n\n /**\n * Open a native alert dialog, with a customizable title and button text.\n *\n * @param {String} message Message to print in the body of the alert\n * @param {Function} completeCallback The callback that is called when user clicks on a button.\n * @param {String} title Title of the alert dialog (default: Alert)\n * @param {String} buttonLabel Label of the close button (default: OK)\n */\n alert: function(message, completeCallback, title, buttonLabel) {\n var _title = (typeof title === \"string\" ? title : \"Alert\");\n var _buttonLabel = (buttonLabel || \"OK\");\n exec(completeCallback, null, \"Notification\", \"alert\", [message, _title, _buttonLabel]);\n },\n\n /**\n * Open a native confirm dialog, with a customizable title and button text.\n * The result that the user selects is returned to the result callback.\n *\n * @param {String} message Message to print in the body of the alert\n * @param {Function} resultCallback The callback that is called when user clicks on a button.\n * @param {String} title Title of the alert dialog (default: Confirm)\n * @param {Array} buttonLabels Array of the labels of the buttons (default: ['OK', 'Cancel'])\n */\n confirm: function(message, resultCallback, title, buttonLabels) {\n var _title = (typeof title === \"string\" ? title : \"Confirm\");\n var _buttonLabels = (buttonLabels || [\"OK\", \"Cancel\"]);\n\n // Strings are deprecated!\n if (typeof _buttonLabels === 'string') {\n console.log(\"Notification.confirm(string, function, string, string) is deprecated. Use Notification.confirm(string, function, string, array).\");\n }\n\n // Some platforms take an array of button label names.\n // Other platforms take a comma separated list.\n // For compatibility, we convert to the desired type based on the platform.\n if (platform.id == \"amazon-fireos\" || platform.id == \"android\" || platform.id == \"ios\" ||\n platform.id == \"windowsphone\" || platform.id == \"firefoxos\" || platform.id == \"ubuntu\" ||\n platform.id == \"windows8\" || platform.id == \"windows\") {\n\n if (typeof _buttonLabels === 'string') {\n _buttonLabels = _buttonLabels.split(\",\"); // not crazy about changing the var type here\n }\n } else {\n if (Array.isArray(_buttonLabels)) {\n var buttonLabelArray = _buttonLabels;\n _buttonLabels = buttonLabelArray.toString();\n }\n }\n exec(resultCallback, null, \"Notification\", \"confirm\", [message, _title, _buttonLabels]);\n },\n\n /**\n * Open a native prompt dialog, with a customizable title and button text.\n * The following results are returned to the result callback:\n * buttonIndex Index number of the button selected.\n * input1 The text entered in the prompt dialog box.\n *\n * @param {String} message Dialog message to display (default: \"Prompt message\")\n * @param {Function} resultCallback The callback that is called when user clicks on a button.\n * @param {String} title Title of the dialog (default: \"Prompt\")\n * @param {Array} buttonLabels Array of strings for the button labels (default: [\"OK\",\"Cancel\"])\n * @param {String} defaultText Textbox input value (default: empty string)\n */\n prompt: function(message, resultCallback, title, buttonLabels, defaultText) {\n var _message = (typeof message === \"string\" ? message : \"Prompt message\");\n var _title = (typeof title === \"string\" ? title : \"Prompt\");\n var _buttonLabels = (buttonLabels || [\"OK\",\"Cancel\"]);\n var _defaultText = (defaultText || \"\");\n exec(resultCallback, null, \"Notification\", \"prompt\", [_message, _title, _buttonLabels, _defaultText]);\n },\n\n /**\n * Causes the device to beep.\n * On Android, the default notification ringtone is played \"count\" times.\n *\n * @param {Integer} count The number of beeps.\n */\n beep: function(count) {\n var defaultedCount = count || 1;\n exec(null, null, \"Notification\", \"beep\", [ defaultedCount ]);\n }\n};\n"
},
{
"path": "plugins/cordova-plugin-file/CONTRIBUTING.md",
"content": "\n\n# Contributing to Apache Cordova\n\nAnyone can contribute to Cordova. And we need your contributions.\n\nThere are multiple ways to contribute: report bugs, improve the docs, and\ncontribute code.\n\nFor instructions on this, start with the \n[contribution overview](http://cordova.apache.org/contribute/).\n\nThe details are explained there, but the important items are:\n - Sign and submit an Apache ICLA (Contributor License Agreement).\n - Have a Jira issue open that corresponds to your contribution.\n - Run the tests so your patch doesn't break existing functionality.\n\nWe look forward to your contributions!\n"
},
{
"path": "plugins/cordova-plugin-file/LICENSE",
"content": "\n Apache License\n Version 2.0, January 2004\n http://www.apache.org/licenses/\n\n TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n\n 1. Definitions.\n\n \"License\" shall mean the terms and conditions for use, reproduction,\n and distribution as defined by Sections 1 through 9 of this document.\n\n \"Licensor\" shall mean the copyright owner or entity authorized by\n the copyright owner that is granting the License.\n\n \"Legal Entity\" shall mean the union of the acting entity and all\n other entities that control, are controlled by, or are under common\n control with that entity. For the purposes of this definition,\n \"control\" means (i) the power, direct or indirect, to cause the\n direction or management of such entity, whether by contract or\n otherwise, or (ii) ownership of fifty percent (50%) or more of the\n outstanding shares, or (iii) beneficial ownership of such entity.\n\n \"You\" (or \"Your\") shall mean an individual or Legal Entity\n exercising permissions granted by this License.\n\n \"Source\" form shall mean the preferred form for making modifications,\n including but not limited to software source code, documentation\n source, and configuration files.\n\n \"Object\" form shall mean any form resulting from mechanical\n transformation or translation of a Source form, including but\n not limited to compiled object code, generated documentation,\n and conversions to other media types.\n\n \"Work\" shall mean the work of authorship, whether in Source or\n Object form, made available under the License, as indicated by a\n copyright notice that is included in or attached to the work\n (an example is provided in the Appendix below).\n\n \"Derivative Works\" shall mean any work, whether in Source or Object\n form, that is based on (or derived from) the Work and for which the\n editorial revisions, annotations, elaborations, or other modifications\n represent, as a whole, an original work of authorship. For the purposes\n of this License, Derivative Works shall not include works that remain\n separable from, or merely link (or bind by name) to the interfaces of,\n the Work and Derivative Works thereof.\n\n \"Contribution\" shall mean any work of authorship, including\n the original version of the Work and any modifications or additions\n to that Work or Derivative Works thereof, that is intentionally\n submitted to Licensor for inclusion in the Work by the copyright owner\n or by an individual or Legal Entity authorized to submit on behalf of\n the copyright owner. For the purposes of this definition, \"submitted\"\n means any form of electronic, verbal, or written communication sent\n to the Licensor or its representatives, including but not limited to\n communication on electronic mailing lists, source code control systems,\n and issue tracking systems that are managed by, or on behalf of, the\n Licensor for the purpose of discussing and improving the Work, but\n excluding communication that is conspicuously marked or otherwise\n designated in writing by the copyright owner as \"Not a Contribution.\"\n\n \"Contributor\" shall mean Licensor and any individual or Legal Entity\n on behalf of whom a Contribution has been received by Licensor and\n subsequently incorporated within the Work.\n\n 2. Grant of Copyright License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n copyright license to reproduce, prepare Derivative Works of,\n publicly display, publicly perform, sublicense, and distribute the\n Work and such Derivative Works in Source or Object form.\n\n 3. Grant of Patent License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n (except as stated in this section) patent license to make, have made,\n use, offer to sell, sell, import, and otherwise transfer the Work,\n where such license applies only to those patent claims licensable\n by such Contributor that are necessarily infringed by their\n Contribution(s) alone or by combination of their Contribution(s)\n with the Work to which such Contribution(s) was submitted. If You\n institute patent litigation against any entity (including a\n cross-claim or counterclaim in a lawsuit) alleging that the Work\n or a Contribution incorporated within the Work constitutes direct\n or contributory patent infringement, then any patent licenses\n granted to You under this License for that Work shall terminate\n as of the date such litigation is filed.\n\n 4. Redistribution. You may reproduce and distribute copies of the\n Work or Derivative Works thereof in any medium, with or without\n modifications, and in Source or Object form, provided that You\n meet the following conditions:\n\n (a) You must give any other recipients of the Work or\n Derivative Works a copy of this License; and\n\n (b) You must cause any modified files to carry prominent notices\n stating that You changed the files; and\n\n (c) You must retain, in the Source form of any Derivative Works\n that You distribute, all copyright, patent, trademark, and\n attribution notices from the Source form of the Work,\n excluding those notices that do not pertain to any part of\n the Derivative Works; and\n\n (d) If the Work includes a \"NOTICE\" text file as part of its\n distribution, then any Derivative Works that You distribute must\n include a readable copy of the attribution notices contained\n within such NOTICE file, excluding those notices that do not\n pertain to any part of the Derivative Works, in at least one\n of the following places: within a NOTICE text file distributed\n as part of the Derivative Works; within the Source form or\n documentation, if provided along with the Derivative Works; or,\n within a display generated by the Derivative Works, if and\n wherever such third-party notices normally appear. The contents\n of the NOTICE file are for informational purposes only and\n do not modify the License. You may add Your own attribution\n notices within Derivative Works that You distribute, alongside\n or as an addendum to the NOTICE text from the Work, provided\n that such additional attribution notices cannot be construed\n as modifying the License.\n\n You may add Your own copyright statement to Your modifications and\n may provide additional or different license terms and conditions\n for use, reproduction, or distribution of Your modifications, or\n for any such Derivative Works as a whole, provided Your use,\n reproduction, and distribution of the Work otherwise complies with\n the conditions stated in this License.\n\n 5. Submission of Contributions. Unless You explicitly state otherwise,\n any Contribution intentionally submitted for inclusion in the Work\n by You to the Licensor shall be under the terms and conditions of\n this License, without any additional terms or conditions.\n Notwithstanding the above, nothing herein shall supersede or modify\n the terms of any separate license agreement you may have executed\n with Licensor regarding such Contributions.\n\n 6. Trademarks. This License does not grant permission to use the trade\n names, trademarks, service marks, or product names of the Licensor,\n except as required for reasonable and customary use in describing the\n origin of the Work and reproducing the content of the NOTICE file.\n\n 7. Disclaimer of Warranty. Unless required by applicable law or\n agreed to in writing, Licensor provides the Work (and each\n Contributor provides its Contributions) on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n implied, including, without limitation, any warranties or conditions\n of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A\n PARTICULAR PURPOSE. You are solely responsible for determining the\n appropriateness of using or redistributing the Work and assume any\n risks associated with Your exercise of permissions under this License.\n\n 8. Limitation of Liability. In no event and under no legal theory,\n whether in tort (including negligence), contract, or otherwise,\n unless required by applicable law (such as deliberate and grossly\n negligent acts) or agreed to in writing, shall any Contributor be\n liable to You for damages, including any direct, indirect, special,\n incidental, or consequential damages of any character arising as a\n result of this License or out of the use or inability to use the\n Work (including but not limited to damages for loss of goodwill,\n work stoppage, computer failure or malfunction, or any and all\n other commercial damages or losses), even if such Contributor\n has been advised of the possibility of such damages.\n\n 9. Accepting Warranty or Additional Liability. While redistributing\n the Work or Derivative Works thereof, You may choose to offer,\n and charge a fee for, acceptance of support, warranty, indemnity,\n or other liability obligations and/or rights consistent with this\n License. However, in accepting such obligations, You may act only\n on Your own behalf and on Your sole responsibility, not on behalf\n of any other Contributor, and only if You agree to indemnify,\n defend, and hold each Contributor harmless for any liability\n incurred by, or claims asserted against, such Contributor by reason\n of your accepting any such warranty or additional liability.\n\n END OF TERMS AND CONDITIONS\n\n APPENDIX: How to apply the Apache License to your work.\n\n To apply the Apache License to your work, attach the following\n boilerplate notice, with the fields enclosed by brackets \"[]\"\n replaced with your own identifying information. (Don't include\n the brackets!) The text should be enclosed in the appropriate\n comment syntax for the file format. We also recommend that a\n file or class name and description of purpose be included on the\n same \"printed page\" as the copyright notice for easier\n identification within third-party archives.\n\n Copyright [yyyy] [name of copyright owner]\n\n Licensed under the Apache License, Version 2.0 (the \"License\");\n you may not use this file except in compliance with the License.\n You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing, software\n distributed under the License is distributed on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n See the License for the specific language governing permissions and\n limitations under the License."
},
{
"path": "plugins/cordova-plugin-file/NOTICE",
"content": "Apache Cordova\nCopyright 2012 The Apache Software Foundation\n\nThis product includes software developed at\nThe Apache Software Foundation (http://www.apache.org/).\n"
},
{
"path": "plugins/cordova-plugin-file/README.md",
"content": "\n\n[](https://travis-ci.org/apache/cordova-plugin-file)\n\n# cordova-plugin-file\n\nThis plugin implements a File API allowing read/write access to files residing on the device.\n\nThis plugin is based on several specs, including :\nThe HTML5 File API\n[http://www.w3.org/TR/FileAPI/](http://www.w3.org/TR/FileAPI/)\n\nThe (now-defunct) Directories and System extensions\nLatest:\n[http://www.w3.org/TR/2012/WD-file-system-api-20120417/](http://www.w3.org/TR/2012/WD-file-system-api-20120417/)\nAlthough most of the plugin code was written when an earlier spec was current:\n[http://www.w3.org/TR/2011/WD-file-system-api-20110419/](http://www.w3.org/TR/2011/WD-file-system-api-20110419/)\n\nIt also implements the FileWriter spec :\n[http://dev.w3.org/2009/dap/file-system/file-writer.html](http://dev.w3.org/2009/dap/file-system/file-writer.html)\n\nFor usage, please refer to HTML5 Rocks' excellent [FileSystem article.](http://www.html5rocks.com/en/tutorials/file/filesystem/)\n\nFor an overview of other storage options, refer to Cordova's\n[storage guide](http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html).\n\nThis plugin defines global `cordova.file` object.\n\nAlthough in the global scope, it is not available until after the `deviceready` event.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(cordova.file);\n }\n\nReport issues on the [Apache Cordova issue tracker](https://issues.apache.org/jira/issues/?jql=project%20%3D%20CB%20AND%20status%20in%20%28Open%2C%20%22In%20Progress%22%2C%20Reopened%29%20AND%20resolution%20%3D%20Unresolved%20AND%20component%20%3D%20%22Plugin%20File%22%20ORDER%20BY%20priority%20DESC%2C%20summary%20ASC%2C%20updatedDate%20DESC)\n\n## Installation\n\n cordova plugin add cordova-plugin-file\n\n## Supported Platforms\n\n- Amazon Fire OS\n- Android\n- BlackBerry 10\n- Firefox OS\n- iOS\n- OS X\n- Windows Phone 7 and 8*\n- Windows 8*\n- Windows*\n- Browser\n\n\\* _These platforms do not support `FileReader.readAsArrayBuffer` nor `FileWriter.write(blob)`._\n\n## Where to Store Files\n\nAs of v1.2.0, URLs to important file-system directories are provided.\nEach URL is in the form _file:///path/to/spot/_, and can be converted to a\n`DirectoryEntry` using `window.resolveLocalFileSystemURL()`.\n\n* `cordova.file.applicationDirectory` - Read-only directory where the application\n is installed. (_iOS_, _Android_, _BlackBerry 10_, _OSX_, _windows_)\n\n* `cordova.file.applicationStorageDirectory` - Root directory of the application's\n sandbox; on iOS & windows this location is read-only (but specific subdirectories [like\n `/Documents` on iOS or `/localState` on windows] are read-write). All data contained within\n is private to the app. (_iOS_, _Android_, _BlackBerry 10_, _OSX_)\n\n* `cordova.file.dataDirectory` - Persistent and private data storage within the\n application's sandbox using internal memory (on Android, if you need to use\n external memory, use `.externalDataDirectory`). On iOS, this directory is not\n synced with iCloud (use `.syncedDataDirectory`). (_iOS_, _Android_, _BlackBerry 10_, _windows_)\n\n* `cordova.file.cacheDirectory` - Directory for cached data files or any files\n that your app can re-create easily. The OS may delete these files when the device\n runs low on storage, nevertheless, apps should not rely on the OS to delete files\n in here. (_iOS_, _Android_, _BlackBerry 10_, _OSX_, _windows_)\n\n* `cordova.file.externalApplicationStorageDirectory` - Application space on\n external storage. (_Android_)\n\n* `cordova.file.externalDataDirectory` - Where to put app-specific data files on\n external storage. (_Android_)\n\n* `cordova.file.externalCacheDirectory` - Application cache on external storage.\n (_Android_)\n\n* `cordova.file.externalRootDirectory` - External storage (SD card) root. (_Android_, _BlackBerry 10_)\n\n* `cordova.file.tempDirectory` - Temp directory that the OS can clear at will. Do not\n rely on the OS to clear this directory; your app should always remove files as\n applicable. (_iOS_, _OSX_, _windows_)\n\n* `cordova.file.syncedDataDirectory` - Holds app-specific files that should be synced\n (e.g. to iCloud). (_iOS_, _windows_)\n\n* `cordova.file.documentsDirectory` - Files private to the app, but that are meaningful\n to other application (e.g. Office files). Note that for _OSX_ this is the user's `~/Documents` directory. (_iOS_, _OSX_)\n\n* `cordova.file.sharedDirectory` - Files globally available to all applications (_BlackBerry 10_)\n\n## File System Layouts\n\nAlthough technically an implementation detail, it can be very useful to know how\nthe `cordova.file.*` properties map to physical paths on a real device.\n\n### iOS File System Layout\n\n| Device Path | `cordova.file.*` | `iosExtraFileSystems` | r/w? | persistent? | OS clears | sync | private |\n|:-----------------------------------------------|:----------------------------|:----------------------|:----:|:-----------:|:---------:|:----:|:-------:|\n| `/var/mobile/Applications//` | applicationStorageDirectory | - | r | N/A | N/A | N/A | Yes |\n| `appname.app/` | applicationDirectory | bundle | r | N/A | N/A | N/A | Yes |\n| `www/` | - | - | r | N/A | N/A | N/A | Yes |\n| `Documents/` | documentsDirectory | documents | r/w | Yes | No | Yes | Yes |\n| `NoCloud/` | - | documents-nosync | r/w | Yes | No | No | Yes |\n| `Library` | - | library | r/w | Yes | No | Yes? | Yes |\n| `NoCloud/` | dataDirectory | library-nosync | r/w | Yes | No | No | Yes |\n| `Cloud/` | syncedDataDirectory | - | r/w | Yes | No | Yes | Yes |\n| `Caches/` | cacheDirectory | cache | r/w | Yes* | Yes\\*\\*\\*| No | Yes |\n| `tmp/` | tempDirectory | - | r/w | No\\*\\* | Yes\\*\\*\\*| No | Yes |\n\n\n \\* Files persist across app restarts and upgrades, but this directory can\n be cleared whenever the OS desires. Your app should be able to recreate any\n content that might be deleted.\n\n\\*\\* Files may persist across app restarts, but do not rely on this behavior. Files\n are not guaranteed to persist across updates. Your app should remove files from\n this directory when it is applicable, as the OS does not guarantee when (or even\n if) these files are removed.\n\n\\*\\*\\* The OS may clear the contents of this directory whenever it feels it is\n necessary, but do not rely on this. You should clear this directory as\n appropriate for your application.\n\n### Android File System Layout\n\n| Device Path | `cordova.file.*` | `AndroidExtraFileSystems` | r/w? | persistent? | OS clears | private |\n|:------------------------------------------------|:----------------------------|:--------------------------|:----:|:-----------:|:---------:|:-------:|\n| `file:///android_asset/` | applicationDirectory | | r | N/A | N/A | Yes |\n| `/data/data//` | applicationStorageDirectory | - | r/w | N/A | N/A | Yes |\n| `cache` | cacheDirectory | cache | r/w | Yes | Yes\\* | Yes |\n| `files` | dataDirectory | files | r/w | Yes | No | Yes |\n| `Documents` | | documents | r/w | Yes | No | Yes |\n| `/` | externalRootDirectory | sdcard | r/w | Yes | No | No |\n| `Android/data//` | externalApplicationStorageDirectory | - | r/w | Yes | No | No |\n| `cache` | externalCacheDirectry | cache-external | r/w | Yes | No\\*\\*| No |\n| `files` | externalDataDirectory | files-external | r/w | Yes | No | No |\n\n\\* The OS may periodically clear this directory, but do not rely on this behavior. Clear\n the contents of this directory as appropriate for your application. Should a user\n purge the cache manually, the contents of this directory are removed.\n\n\\*\\* The OS does not clear this directory automatically; you are responsible for managing\n the contents yourself. Should the user purge the cache manually, the contents of the\n directory are removed.\n\n**Note**: If external storage can't be mounted, the `cordova.file.external*`\nproperties are `null`.\n\n### BlackBerry 10 File System Layout\n\n| Device Path | `cordova.file.*` | r/w? | persistent? | OS clears | private |\n|:-------------------------------------------------------------|:----------------------------|:----:|:-----------:|:---------:|:-------:|\n| `file:///accounts/1000/appdata//` | applicationStorageDirectory | r | N/A | N/A | Yes |\n| `app/native` | applicationDirectory | r | N/A | N/A | Yes |\n| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | No | Yes | Yes |\n| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | Yes | No | Yes |\n| `file:///accounts/1000/removable/sdcard` | externalRemovableDirectory | r/w | Yes | No | No |\n| `file:///accounts/1000/shared` | sharedDirectory | r/w | Yes | No | No |\n\n*Note*: When application is deployed to work perimeter, all paths are relative to /accounts/1000-enterprise.\n\n### OS X File System Layout\n\n| Device Path | `cordova.file.*` | `iosExtraFileSystems` | r/w? | OS clears | private |\n|:-------------------------------------------------|:----------------------------|:----------------------|:----:|:---------:|:-------:|\n| `/Applications/.app/` | - | bundle | r | N/A | Yes |\n| `Content/Resources/` | applicationDirectory | - | r | N/A | Yes |\n| `~/Library/Application Support//` | applicationStorageDirectory | - | r/w | No | Yes |\n| `files/` | dataDirectory | - | r/w | No | Yes |\n| `~/Documents/` | documentsDirectory | documents | r/w | No | No |\n| `~/Library/Caches//` | cacheDirectory | cache | r/w | No | Yes |\n| `/tmp/` | tempDirectory | - | r/w | Yes\\* | Yes |\n| `/` | rootDirectory | root | r/w | No\\*\\* | No |\n\n**Note**: This is the layout for non sandboxed applications. I you enable sandboxing, the `applicationStorageDirectory` will be below ` ~/Library/Containers//Data/Library/Application Support`.\n\n\\* Files persist across app restarts and upgrades, but this directory can\n be cleared whenever the OS desires. Your app should be able to recreate any\n content that might be deleted. You should clear this directory as\n appropriate for your application.\n\n\\*\\* Allows access to the entire file system. This is only available for non sandboxed apps.\n\n### Windows File System Layout\n\n| Device Path | `cordova.file.*` | r/w? | persistent? | OS clears | private |\n|:------------------------------------------------------|:----------------------------|:----:|:-----------:|:---------:|:-------:|\n| `ms-appdata:///` | applicationDirectory | r | N/A | N/A | Yes |\n| `local/` | dataDirectory | r/w | Yes | No | Yes |\n| `temp/` | cacheDirectory | r/w | No | Yes\\* | Yes |\n| `temp/` | tempDirectory | r/w | No | Yes\\* | Yes |\n| `roaming/` | syncedDataDirectory | r/w | Yes | No | Yes |\n\n\\* The OS may periodically clear this directory\n\n\n## Android Quirks\n\n### Android Persistent storage location\n\nThere are multiple valid locations to store persistent files on an Android\ndevice. See [this page](http://developer.android.com/guide/topics/data/data-storage.html)\nfor an extensive discussion of the various possibilities.\n\nPrevious versions of the plugin would choose the location of the temporary and\npersistent files on startup, based on whether the device claimed that the SD\nCard (or equivalent storage partition) was mounted. If the SD Card was mounted,\nor if a large internal storage partition was available (such as on Nexus\ndevices,) then the persistent files would be stored in the root of that space.\nThis meant that all Cordova apps could see all of the files available on the\ncard.\n\nIf the SD card was not available, then previous versions would store data under\n`/data/data/`, which isolates apps from each other, but may still\ncause data to be shared between users.\n\nIt is now possible to choose whether to store files in the internal file\nstorage location, or using the previous logic, with a preference in your\napplication's `config.xml` file. To do this, add one of these two lines to\n`config.xml`:\n\n \n\n \n\nWithout this line, the File plugin will use `Internal` as the default. If\na preference tag is present, and is not one of these values, the application\nwill not start.\n\nIf your application has previously been shipped to users, using an older (pre-\n3.0.0) version of this plugin, and has stored files in the persistent filesystem,\nthen you should set the preference to `Compatibility` if your config.xml does not specify a location for the persistent filesystem. Switching the location to\n\"Internal\" would mean that existing users who upgrade their application may be\nunable to access their previously-stored files, depending on their device.\n\nIf your application is new, or has never previously stored files in the\npersistent filesystem, then the `Internal` setting is generally recommended.\n\n### Slow recursive operations for /android_asset\n\nListing asset directories is really slow on Android. You can speed it up though, by\nadding `src/android/build-extras.gradle` to the root of your android project (also\nrequires cordova-android@4.0.0 or greater).\n\n## iOS Quirks\n\n- `cordova.file.applicationStorageDirectory` is read-only; attempting to store\n files within the root directory will fail. Use one of the other `cordova.file.*`\n properties defined for iOS (only `applicationDirectory` and `applicationStorageDirectory` are\n read-only).\n- `FileReader.readAsText(blob, encoding)`\n - The `encoding` parameter is not supported, and UTF-8 encoding is always in effect.\n\n### iOS Persistent storage location\n\nThere are two valid locations to store persistent files on an iOS device: the\nDocuments directory and the Library directory. Previous versions of the plugin\nonly ever stored persistent files in the Documents directory. This had the\nside-effect of making all of an application's files visible in iTunes, which\nwas often unintended, especially for applications which handle lots of small\nfiles, rather than producing complete documents for export, which is the\nintended purpose of the directory.\n\nIt is now possible to choose whether to store files in the documents or library\ndirectory, with a preference in your application's `config.xml` file. To do this,\nadd one of these two lines to `config.xml`:\n\n \n\n \n\nWithout this line, the File plugin will use `Compatibility` as the default. If\na preference tag is present, and is not one of these values, the application\nwill not start.\n\nIf your application has previously been shipped to users, using an older (pre-\n1.0) version of this plugin, and has stored files in the persistent filesystem,\nthen you should set the preference to `Compatibility`. Switching the location to\n`Library` would mean that existing users who upgrade their application would be\nunable to access their previously-stored files.\n\nIf your application is new, or has never previously stored files in the\npersistent filesystem, then the `Library` setting is generally recommended.\n\n## Firefox OS Quirks\n\nThe File System API is not natively supported by Firefox OS and is implemented\nas a shim on top of indexedDB.\n\n* Does not fail when removing non-empty directories\n* Does not support metadata for directories\n* Methods `copyTo` and `moveTo` do not support directories\n\nThe following data paths are supported:\n* `applicationDirectory` - Uses `xhr` to get local files that are packaged with the app.\n* `dataDirectory` - For persistent app-specific data files.\n* `cacheDirectory` - Cached files that should survive app restarts (Apps should not rely\non the OS to delete files in here).\n\n## Browser Quirks\n\n### Common quirks and remarks\n- Each browser uses its own sandboxed filesystem. IE and Firefox use IndexedDB as a base.\nAll browsers use forward slash as directory separator in a path.\n- Directory entries have to be created successively.\nFor example, the call `fs.root.getDirectory('dir1/dir2', {create:true}, successCallback, errorCallback)`\nwill fail if dir1 did not exist.\n- The plugin requests user permission to use persistent storage at the application first start.\n- Plugin supports `cdvfile://localhost` (local resources) only. I.e. external resources are not supported via `cdvfile`.\n- The plugin does not follow [\"File System API 8.3 Naming restrictions\"](http://www.w3.org/TR/2011/WD-file-system-api-20110419/#naming-restrictions).\n- Blob and File' `close` function is not supported.\n- `FileSaver` and `BlobBuilder` are not supported by this plugin and don't have stubs.\n- The plugin does not support `requestAllFileSystems`. This function is also missing in the specifications.\n- Entries in directory will not be removed if you use `create: true` flag for existing directory.\n- Files created via constructor are not supported. You should use entry.file method instead.\n- Each browser uses its own form for blob URL references.\n- `readAsDataURL` function is supported, but the mediatype in Chrome depends on entry name extension,\nmediatype in IE is always empty (which is the same as `text-plain` according the specification),\nthe mediatype in Firefox is always `application/octet-stream`.\nFor example, if the content is `abcdefg` then Firefox returns `data:application/octet-stream;base64,YWJjZGVmZw==`,\nIE returns `data:;base64,YWJjZGVmZw==`, Chrome returns `data:;base64,YWJjZGVmZw==`.\n- `toInternalURL` returns the path in the form `file:///persistent/path/to/entry` (Firefox, IE).\nChrome returns the path in the form `cdvfile://localhost/persistent/file`.\n\n### Chrome quirks\n- Chrome filesystem is not immediately ready after device ready event. As a workaround you can subscribe to `filePluginIsReady` event.\nExample:\n```javascript\nwindow.addEventListener('filePluginIsReady', function(){ console.log('File plugin is ready');}, false);\n```\nYou can use `window.isFilePluginReadyRaised` function to check whether event was already raised.\n- window.requestFileSystem TEMPORARY and PERSISTENT filesystem quotas are not limited in Chrome.\n- To increase persistent storage in Chrome you need to call `window.initPersistentFileSystem` method. Persistent storage quota is 5 MB by default.\n- Chrome requires `--allow-file-access-from-files` run argument to support API via `file:///` protocol.\n- `File` object will be not changed if you use flag `{create:true}` when getting an existing `Entry`.\n- events `cancelable` property is set to true in Chrome. This is contrary to the [specification](http://dev.w3.org/2009/dap/file-system/file-writer.html).\n- `toURL` function in Chrome returns `filesystem:`-prefixed path depending on application host.\nFor example, `filesystem:file:///persistent/somefile.txt`, `filesystem:http://localhost:8080/persistent/somefile.txt`.\n- `toURL` function result does not contain trailing slash in case of directory entry.\nChrome resolves directories with slash-trailed urls correctly though.\n- `resolveLocalFileSystemURL` method requires the inbound `url` to have `filesystem` prefix. For example, `url` parameter for `resolveLocalFileSystemURL`\nshould be in the form `filesystem:file:///persistent/somefile.txt` as opposed to the form `file:///persistent/somefile.txt` in Android.\n- Deprecated `toNativeURL` function is not supported and does not have a stub.\n- `setMetadata` function is not stated in the specifications and not supported.\n- INVALID_MODIFICATION_ERR (code: 9) is thrown instead of SYNTAX_ERR(code: 8) on requesting of a non-existant filesystem.\n- INVALID_MODIFICATION_ERR (code: 9) is thrown instead of PATH_EXISTS_ERR(code: 12) on trying to exclusively create a file or directory, which already exists.\n- INVALID_MODIFICATION_ERR (code: 9) is thrown instead of NO_MODIFICATION_ALLOWED_ERR(code: 6) on trying to call removeRecursively on the root file system.\n- INVALID_MODIFICATION_ERR (code: 9) is thrown instead of NOT_FOUND_ERR(code: 1) on trying to moveTo directory that does not exist.\n\n### IndexedDB-based impl quirks (Firefox and IE)\n- `.` and `..` are not supported.\n- IE does not support `file:///`-mode; only hosted mode is supported (http://localhost:xxxx).\n- Firefox filesystem size is not limited but each 50MB extension will request a user permission.\nIE10 allows up to 10mb of combined AppCache and IndexedDB used in implementation of filesystem without prompting,\nonce you hit that level you will be asked if you want to allow it to be increased up to a max of 250mb per site.\nSo `size` parameter for `requestFileSystem` function does not affect filesystem in Firefox and IE.\n- `readAsBinaryString` function is not stated in the Specs and not supported in IE and does not have a stub.\n- `file.type` is always null.\n- You should not create entry using DirectoryEntry instance callback result which was deleted.\nOtherwise, you will get a 'hanging entry'.\n- Before you can read a file, which was just written you need to get a new instance of this file.\n- `setMetadata` function, which is not stated in the Specs supports `modificationTime` field change only.\n- `copyTo` and `moveTo` functions do not support directories.\n- Directories metadata is not supported.\n- Both Entry.remove and directoryEntry.removeRecursively don't fail when removing\nnon-empty directories - directories being removed are cleaned along with contents instead.\n- `abort` and `truncate` functions are not supported.\n- progress events are not fired. For example, this handler will be not executed:\n```javascript\nwriter.onprogress = function() { /*commands*/ };\n```\n\n## Upgrading Notes\n\nIn v1.0.0 of this plugin, the `FileEntry` and `DirectoryEntry` structures have changed,\nto be more in line with the published specification.\n\nPrevious (pre-1.0.0) versions of the plugin stored the device-absolute-file-location\nin the `fullPath` property of `Entry` objects. These paths would typically look like\n\n /var/mobile/Applications//Documents/path/to/file (iOS)\n /storage/emulated/0/path/to/file (Android)\n\nThese paths were also returned by the `toURL()` method of the `Entry` objects.\n\nWith v1.0.0, the `fullPath` attribute is the path to the file, _relative to the root of\nthe HTML filesystem_. So, the above paths would now both be represented by a `FileEntry`\nobject with a `fullPath` of\n\n /path/to/file\n\nIf your application works with device-absolute-paths, and you previously retrieved those\npaths through the `fullPath` property of `Entry` objects, then you should update your code\nto use `entry.toURL()` instead.\n\nFor backwards compatibility, the `resolveLocalFileSystemURL()` method will accept a\ndevice-absolute-path, and will return an `Entry` object corresponding to it, as long as that\nfile exists within either the `TEMPORARY` or `PERSISTENT` filesystems.\n\nThis has particularly been an issue with the File-Transfer plugin, which previously used\ndevice-absolute-paths (and can still accept them). It has been updated to work correctly\nwith FileSystem URLs, so replacing `entry.fullPath` with `entry.toURL()` should resolve any\nissues getting that plugin to work with files on the device.\n\nIn v1.1.0 the return value of `toURL()` was changed (see [CB-6394](https://issues.apache.org/jira/browse/CB-6394))\nto return an absolute 'file://' URL. wherever possible. To ensure a 'cdvfile:'-URL you can use `toInternalURL()` now.\nThis method will now return filesystem URLs of the form\n\n cdvfile://localhost/persistent/path/to/file\n\nwhich can be used to identify the file uniquely.\n\n## cdvfile protocol\n**Purpose**\n\n`cdvfile://localhost/persistent|temporary|another-fs-root*/path/to/file` can be used for platform-independent file paths.\ncdvfile paths are supported by core plugins - for example you can download an mp3 file to cdvfile-path via `cordova-plugin-file-transfer` and play it via `cordova-plugin-media`.\n\n__*Note__: See [Where to Store Files](#where-to-store-files), [File System Layouts](#file-system-layouts) and [Configuring the Plugin](#configuring-the-plugin-optional) for more details about available fs roots.\n\nTo use `cdvfile` as a tag' `src` you can convert it to native path via `toURL()` method of the resolved fileEntry, which you can get via `resolveLocalFileSystemURL` - see examples below.\n\nYou can also use `cdvfile://` paths directly in the DOM, for example:\n```HTML\n\n```\n\n__Note__: This method requires following Content Security rules updates:\n* Add `cdvfile:` scheme to `Content-Security-Policy` meta tag of the index page, e.g.:\n - ``\n* Add `` to `config.xml`.\n\n**Converting cdvfile:// to native path**\n\n```javascript\nresolveLocalFileSystemURL('cdvfile://localhost/temporary/path/to/file.mp4', function(entry) {\n var nativePath = entry.toURL();\n console.log('Native URI: ' + nativePath);\n document.getElementById('video').src = nativePath;\n```\n\n**Converting native path to cdvfile://**\n\n```javascript\nresolveLocalFileSystemURL(nativePath, function(entry) {\n console.log('cdvfile URI: ' + entry.toInternalURL());\n```\n\n**Using cdvfile in core plugins**\n\n```javascript\nfileTransfer.download(uri, 'cdvfile://localhost/temporary/path/to/file.mp3', function (entry) { ...\n```\n```javascript\nvar my_media = new Media('cdvfile://localhost/temporary/path/to/file.mp3', ...);\nmy_media.play();\n```\n\n#### cdvfile quirks\n- Using `cdvfile://` paths in the DOM is not supported on Windows platform (a path can be converted to native instead).\n\n\n## List of Error Codes and Meanings\nWhen an error is thrown, one of the following codes will be used.\n\n| Code | Constant |\n|-----:|:------------------------------|\n| 1 | `NOT_FOUND_ERR` |\n| 2 | `SECURITY_ERR` |\n| 3 | `ABORT_ERR` |\n| 4 | `NOT_READABLE_ERR` |\n| 5 | `ENCODING_ERR` |\n| 6 | `NO_MODIFICATION_ALLOWED_ERR` |\n| 7 | `INVALID_STATE_ERR` |\n| 8 | `SYNTAX_ERR` |\n| 9 | `INVALID_MODIFICATION_ERR` |\n| 10 | `QUOTA_EXCEEDED_ERR` |\n| 11 | `TYPE_MISMATCH_ERR` |\n| 12 | `PATH_EXISTS_ERR` |\n\n## Configuring the Plugin (Optional)\n\nThe set of available filesystems can be configured per-platform. Both iOS and\nAndroid recognize a tag in `config.xml` which names the\nfilesystems to be installed. By default, all file-system roots are enabled.\n\n \n \n\n### Android\n\n* `files`: The application's internal file storage directory\n* `files-external`: The application's external file storage directory\n* `sdcard`: The global external file storage directory (this is the root of the SD card, if one is installed). You must have the `android.permission.WRITE_EXTERNAL_STORAGE` permission to use this.\n* `cache`: The application's internal cache directory\n* `cache-external`: The application's external cache directory\n* `root`: The entire device filesystem\n\nAndroid also supports a special filesystem named \"documents\", which represents a \"/Documents/\" subdirectory within the \"files\" filesystem.\n\n### iOS\n\n* `library`: The application's Library directory\n* `documents`: The application's Documents directory\n* `cache`: The application's Cache directory\n* `bundle`: The application's bundle; the location of the app itself on disk (read-only)\n* `root`: The entire device filesystem\n\nBy default, the library and documents directories can be synced to iCloud. You can also request two additional filesystems, `library-nosync` and `documents-nosync`, which represent a special non-synced directory within the `/Library` or `/Documents` filesystem.\n"
},
{
"path": "plugins/cordova-plugin-file/RELEASENOTES.md",
"content": "\n# Release Notes\n\n### 4.2.0 (Apr 15, 2016)\n* CB-10960 Uncaught `#` in `write()` when `readyState != WRITING ?`\n* Replace `PermissionHelper.java` with `cordova-plugin-compat`\n* CB-10977 **Android** Removing global state used for permission requests\n* CB-10798, CB-10384 Fixing permissions for **Marshmallow**.\n* Fix test failure on **WP 8.1**\n* CB-10577 **Windows** `resolveLocalFileSystemURL` should omit trailing slash for file\n* CB-7862 `FileReader` reads large files in chunks with progress.\n* CB-10577 **Android** `resolveLocalFileSystemURL` should detect directory vs file.\n* CB-9753 index out of bounds on `requestFileSystem`.\n* Remove `warning` emoji, as it doesn't correctly display in the docs website: cordova.apache.org/docs/en/dev/cordova-plugin-file/index.html. This closes #166\n* CB-10636 Add `JSHint` for plugins\n* CB-10411 Error in `file.spec.129` of `cordova-plugin-file`\n\n### 4.1.1 (Feb 09, 2016)\n* Edit package.json license to match SPDX id\n* [CB-10419](https://issues.apache.org/jira/browse/CB-10419) cordova-plugin-file 4.0.0 error with browserify workflow\n\n### 4.1.0 (Jan 15, 2016)\n* added `.ratignore` file\n* CB-10319 **android** Adding reflective helper methods for permission requests\n* CB-10023 Fix `proxy not found error` on Chrome.\n* CB-8863 **ios** Fix block usage of self\n\n### 4.0.0 (Nov 18, 2015)\n* [CB-10035](https://issues.apache.org/jira/browse/CB-10035) Updated `RELEASENOTES` to be newest to oldest\n* [CB-8497](https://issues.apache.org/jira/browse/CB-8497) Fix handling of file paths with `#` character\n* Do not inject default `AndroidPersistentFileLocation` into `config.xml`\n* [CB-9891](https://issues.apache.org/jira/browse/CB-9891): Fix permission errors due to `URI encoding` inconsistency on **Android**\n* Fixed `NullPointer Exception` in **Android 5** and above due to invalid column name on cursor\n* Fix default persistent file location\n* fix `applicationDirectory` to use `ms-appx:///`\n* Add **Windows** paths to `cordova.file` object\n* [CB-9851](https://issues.apache.org/jira/browse/CB-9851) Document `cdvfile` protocol quirk - using `cdvfile://` in the `DOM` is not supported on **Windows**\n* [CB-9752](https://issues.apache.org/jira/browse/CB-9752) `getDirectory` fails on valid directory with assets filesystem\n* [CB-7253](https://issues.apache.org/jira/browse/CB-7253) `requestFileSystem` fails when no external storage is present\n* Adding permissions for **Marshmallow**. Now supports **Anrdoid 6.0**\n* Fixing contribute link.\n* always use setters to fix memory issues without `ARC` for **iOS**\n* [CB-9331](https://issues.apache.org/jira/browse/CB-9331) `getFreeDiskSpace` **iOS**.\n* override `resolveLocalFileSystemURL` by `webkitResolveLocalFileSystemURL` for **browser** platform add `.project` into git ignore list\n* Fail with `FileError.ENCODING_ERR` on encoding exception.\n* [CB-9544](https://issues.apache.org/jira/browse/CB-9544) Add file plugin for **OSX**\n* [CB-9539](https://issues.apache.org/jira/browse/CB-9539) Fixed test failure on **Android** emulator\n* Added docs on `CSP` rules needed for using `cdvfile` in DOM src. This closes #120\n* Added `cdvfile` protocol purpose description and examples\n\n### 3.0.0 (Aug 18, 2015)\n* Make Android default persistent file location internal\n* Fixed issue with file paths not existing when using browserify\n* [CB-9251](https://issues.apache.org/jira/browse/CB-9251): Changed from Intents to Preferences object as per the issue\n* [CB-9215](https://issues.apache.org/jira/browse/CB-9215) Add cordova-plugin-file manual test for windows platform\n\n### 2.1.0 (Jun 17, 2015)\n* added missing license header\n* [CB-9128](https://issues.apache.org/jira/browse/CB-9128) cordova-plugin-file documentation translation: cordova-plugin-file\n* fix npm md\n* [CB-8844](https://issues.apache.org/jira/browse/CB-8844) Increased timeout for asset tests\n* Updated resolveFileSystem.js so it can be parsed by uglifyJS\n* [CB-8860](https://issues.apache.org/jira/browse/CB-8860) cordova-plugin-file documentation translation: cordova-plugin-file\n* [CB-8792](https://issues.apache.org/jira/browse/CB-8792) Fixes reading of json files using readAsText\n\n### 2.0.0 (Apr 15, 2015)\n* [CB-8849](https://issues.apache.org/jira/browse/CB-8849) Fixed ReadAsArrayBuffer to return ArrayBuffer and not Array on WP8\n* [CB-8819](https://issues.apache.org/jira/browse/CB-8819) Fixed FileReader's readAsBinaryString on wp8\n* [CB-8746](https://issues.apache.org/jira/browse/CB-8746) gave plugin major version bump\n* [CB-8683](https://issues.apache.org/jira/browse/CB-8683) android: Fix broken unit tests from plugin rename\n* [CB-8683](https://issues.apache.org/jira/browse/CB-8683) changed plugin-id to pacakge-name\n* [CB-8653](https://issues.apache.org/jira/browse/CB-8653) properly updated translated docs to use new id\n* [CB-8653](https://issues.apache.org/jira/browse/CB-8653) updated translated docs to use new id\n* Use TRAVIS_BUILD_DIR, install paramedic by npm\n* docs: added Windows to supported platforms\n* [CB-8699](https://issues.apache.org/jira/browse/CB-8699) [CB-6428](https://issues.apache.org/jira/browse/CB-6428) Fix uncompressed assets being copied as zero length files\n* [CB-6428](https://issues.apache.org/jira/browse/CB-6428) android: Fix assets FileEntry having size of -1\n* android: Move URLforFullPath into base class (and rename to localUrlforFullPath)\n* [CB-6428](https://issues.apache.org/jira/browse/CB-6428) Mention build-extras.gradle in README\n* [CB-7109](https://issues.apache.org/jira/browse/CB-7109) android: Parse arguments off of the main thread (close #97)\n* [CB-8695](https://issues.apache.org/jira/browse/CB-8695) ios: Fix `blob.slice()` for `asset-library` URLs (close #105)\n* Tweak build-extras.gradle to just read/write to main `assets/` instead of `build/`\n* [CB-8689](https://issues.apache.org/jira/browse/CB-8689) Fix NPE in makeEntryForNativeUri (was affecting file-transfer)\n* [CB-8675](https://issues.apache.org/jira/browse/CB-8675) Revert \"CB-8351 ios: Use base64EncodedStringWithOptions instead of CordovaLib's class extension\"\n* [CB-8653](https://issues.apache.org/jira/browse/CB-8653) Updated Readme\n* [CB-8659](https://issues.apache.org/jira/browse/CB-8659): ios: 4.0.x Compatibility: Remove use of initWebView method\n* Add a cache to speed up AssetFilesystem directory listings\n* [CB-8663](https://issues.apache.org/jira/browse/CB-8663) android: Don't notify MediaScanner of private files\n* Don't log stacktrace for normal exceptions (e.g. file not found)\n* android: Don't use LimitedInputStream when reading entire file (optimization)\n* [CB-6428](https://issues.apache.org/jira/browse/CB-6428) android: Add support for directory copies from assets -> filesystem\n* android: Add `listChildren()`: Java-consumable version of `readEntriesAtLocalURL()`\n* [CB-6428](https://issues.apache.org/jira/browse/CB-6428) android: Add support for file:///android_asset URLs\n* [CB-8642](https://issues.apache.org/jira/browse/CB-8642) android: Fix content URIs not working with resolve / copy\n* Tweak tests to fail if deleteEntry fails (rather than time out)\n* android: Ensure LocalFilesystemURL can only be created with \"cdvfile\" URLs\n* android: Move CordovaResourceApi into Filesystem base class\n* android: Use `CordovaResourceApi.mapUriToFile()` rather than own custom logic in ContentFilesystem\n* android: Use Uri.parse rather than manual parsing in resolveLocalFileSystemURI\n* Tweak test case that failed twice on error rather than just once\n* android: Delete invalid JavaDoc (lint errors)\n* android: Use CordovaResourceApi rather than FileHelper\n* [CB-8032](https://issues.apache.org/jira/browse/CB-8032) - File Plugin - Add nativeURL external method support for CDVFileSystem->makeEntryForPath:isDirectory: (closes #96)\n* [CB-8567](https://issues.apache.org/jira/browse/CB-8567) Integrate TravisCI\n* [CB-8438](https://issues.apache.org/jira/browse/CB-8438) cordova-plugin-file documentation translation: cordova-plugin-file\n* [CB-8538](https://issues.apache.org/jira/browse/CB-8538) Added package.json file\n* [CB-7956](https://issues.apache.org/jira/browse/CB-7956) Add cordova-plugin-file support for browser platform\n* [CB-8423](https://issues.apache.org/jira/browse/CB-8423) Corrected usage of done() in async tests\n* [CB-8459](https://issues.apache.org/jira/browse/CB-8459) Fixes spec 111 failure due to incorrect relative paths handling\n* Code cleanup, whitespace\n* Added nativeURL property to FileEntry, implemented readAsArrayBuffer and readAsBinaryString\n\n### 1.3.3 (Feb 04, 2015)\n* [CB-7927](https://issues.apache.org/jira/browse/CB-7927) Encoding data to bytes instead of chars when writing a file.\n* ios: Fix compile warning about implicit int conversion\n* [CB-8351](https://issues.apache.org/jira/browse/CB-8351) ios: Use base64EncodedStringWithOptions instead of CordovaLib's class extension\n* [CB-8351](https://issues.apache.org/jira/browse/CB-8351) ios: Use argumentForIndex rather than NSArray extension\n* [CB-8351](https://issues.apache.org/jira/browse/CB-8351) ios: Use a local copy of valueForKeyIsNumber rather than CordovaLib's version\n* windows: Handle url's containing absolute windows path starting with drive letter and colon (encoded as %3A) through root FS\n* windows: Rework to use normal url form\n* android: refactor: Make Filesystem base class store its own name, rootUri, and rootEntry\n* android: Simplify code a bit by making makeEntryForPath not throw JSONException\n* [CB-6431](https://issues.apache.org/jira/browse/CB-6431) android: Fix plugin breaking content: URLs\n* [CB-7375](https://issues.apache.org/jira/browse/CB-7375) Never create new FileSystem instances (except on windows since they don't implement requestAllFileSystems())\n\n### 1.3.2 (Dec 02, 2014)\n* Gets rid of thread block error in File plugin\n* [CB-7917](https://issues.apache.org/jira/browse/CB-7917) Made tests file.spec.114 - 116 pass for **Windows** platform\n* [CB-7977](https://issues.apache.org/jira/browse/CB-7977) Mention `deviceready` in plugin docs\n* [CB-7602](https://issues.apache.org/jira/browse/CB-7602): Fix `isCopyOnItself` logic\n* [CB-7700](https://issues.apache.org/jira/browse/CB-7700) cordova-plugin-file documentation translation: cordova-plugin-file\n* Use one proxy for both **Windows** and **Windows8** platforms\n* [CB-6994](https://issues.apache.org/jira/browse/CB-6994) Fixes result, returned by proxy's write method\n* [fxos] update `__format__` to match `pathsPrefix`\n* [CB-6994](https://issues.apache.org/jira/browse/CB-6994) Improves merged code to be able to write a File\n* Optimize `FileProxy` for **Windows** platforms\n* Synchronize changes with **Windows** platform\n* Fix function write for big files on **Windows 8**\n* Write file in background\n* [CB-7487](https://issues.apache.org/jira/browse/CB-7487) **Android** Broadcast file write This allows MTP USB shares to show the file immediately without reboot/manual refresh using 3rd party app.\n* [CB-7700](https://issues.apache.org/jira/browse/CB-7700) cordova-plugin-file documentation translation: cordova-plugin-file\n* [CB-7571](https://issues.apache.org/jira/browse/CB-7571) Bump version of nested plugin to match parent plugin\n\n### 1.3.1 (Sep 17, 2014)\n* [CB-7471](https://issues.apache.org/jira/browse/CB-7471) cordova-plugin-file documentation translation\n* [CB-7272](https://issues.apache.org/jira/browse/CB-7272) Replace confusing \"r/o\" abbreviation with just \"r\"\n* [CB-7423](https://issues.apache.org/jira/browse/CB-7423) encode path before attempting to resolve\n* [CB-7375](https://issues.apache.org/jira/browse/CB-7375) Fix the filesystem name in resolveLocalFileSystemUri\n* [CB-7445](https://issues.apache.org/jira/browse/CB-7445) [BlackBerry10] resolveLocalFileSystemURI - change DEFAULT_SIZE to MAX_SIZE\n* [CB-7458](https://issues.apache.org/jira/browse/CB-7458) [BlackBerry10] resolveLocalFileSystemURL - add filesystem property\n* [CB-7445](https://issues.apache.org/jira/browse/CB-7445) [BlackBerry10] Add default file system size to prevent quota exceeded error on initial install\n* [CB-7431](https://issues.apache.org/jira/browse/CB-7431) Avoid calling done() twice in file.spec.109 test\n* [CB-7413](https://issues.apache.org/jira/browse/CB-7413) Adds support of 'ms-appdata://' URIs\n* [CB-7422](https://issues.apache.org/jira/browse/CB-7422) [File Tests] Use proper fileSystem to create fullPath\n* [CB-7375](https://issues.apache.org/jira/browse/CB-7375) [Entry] get proper filesystem in Entry\n* Amazon related changes.\n* [CB-7375](https://issues.apache.org/jira/browse/CB-7375) Remove leading slash statement from condition\n* Refactored much of the logic in FileMetadata constructor. Directory.size will return 0\n* [CB-7419](https://issues.apache.org/jira/browse/CB-7419) [WP8] Added support to get metada from dir\n* [CB-7418](https://issues.apache.org/jira/browse/CB-7418) [DirectoryEntry] Added fullPath variable as part of condition\n* [CB-7417](https://issues.apache.org/jira/browse/CB-7417) [File tests] added proper matcher to compare fullPath property\n* [CB-7375](https://issues.apache.org/jira/browse/CB-7375) Partial revert to resolve WP8 failures\n* Overwrite existing file on getFile when create is true\n* [CB-7375](https://issues.apache.org/jira/browse/CB-7375) [CB-6148](https://issues.apache.org/jira/browse/CB-6148): Ensure that return values from copy and move operations reference the correct filesystem\n* [CB-6724](https://issues.apache.org/jira/browse/CB-6724) changed style detail on documentation\n* Added new js files to amazon-fireos platform.\n* Adds Windows platform\n* Fixes multiple mobilespec tests errors\n* Removed test/tests.js module from main plugin.xml\n* [CB-7094](https://issues.apache.org/jira/browse/CB-7094) renamed folder to tests + added nested plugin.xml\n* added documentation for manual tests\n* [CB-6923](https://issues.apache.org/jira/browse/CB-6923) Adding support to handle relative paths\n* Style improvements on Manual tests\n* [CB-7094](https://issues.apache.org/jira/browse/CB-7094) Ported File manual tests\n\n### 1.3.0 (Aug 06, 2014)\n* **FFOS** Remove unsupported paths from requestAllPaths\n* **FFOS** Support for resolve URI, request all paths and local app directory.\n* [CB-4263](https://issues.apache.org/jira/browse/CB-4263) set ready state to done before onload\n* [CB-7167](https://issues.apache.org/jira/browse/CB-7167) [BlackBerry10] copyTo - return wrapped entry rather than native\n* [CB-7167](https://issues.apache.org/jira/browse/CB-7167) [BlackBerry10] Add directory support to getFileMetadata\n* [CB-7167](https://issues.apache.org/jira/browse/CB-7167) [BlackBerry10] Fix tests detection of blob support (window.Blob is BlobConstructor object)\n* [CB-7161](https://issues.apache.org/jira/browse/CB-7161) [BlackBerry10] Add file system directory paths\n* [CB-7093](https://issues.apache.org/jira/browse/CB-7093) Create separate plugin.xml for new-style tests\n* [CB-7057](https://issues.apache.org/jira/browse/CB-7057) Docs update: elaborate on what directories are for\n* [CB-7093](https://issues.apache.org/jira/browse/CB-7093): Undo the effects of an old bad S&R command\n* [CB-7093](https://issues.apache.org/jira/browse/CB-7093): Remove a bunch of unneeded log messages\n* [CB-7093](https://issues.apache.org/jira/browse/CB-7093): Add JS module to plugin.xml file for auto-tests\n* [CB-7093](https://issues.apache.org/jira/browse/CB-7093) Ported automated file tests\n* **WINDOWS** remove extra function closure, not needed\n* **WINDOWS** remove check for undefined fail(), it is defined by the proxy and always exists\n* **WINDOWS** re-apply readAsBinaryString and readAsArrayBuffer\n* **WINDOWS** Moved similar calls to be the same calls, aliased long namespaced functions\n* [CB-6127](https://issues.apache.org/jira/browse/CB-6127) Updated translations for docs.\n* [CB-6571](https://issues.apache.org/jira/browse/CB-6571) Fix getParentForLocalURL to work correctly with directories with trailing '/' (This closes #58)\n* UTTypeCopyPreferredTagWithClass returns nil mimetype for css when there is no network\n* updated spec links in docs ( en only )\n* [CB-6571](https://issues.apache.org/jira/browse/CB-6571) add trailing space it is missing in DirectoryEnty constructor.\n* [CB-6980](https://issues.apache.org/jira/browse/CB-6980) Fixing filesystem:null property in Entry\n* Add win8 support for readAsBinaryString and readAsArrayBuffer\n* [FFOS] Update FileProxy.js\n* [CB-6940](https://issues.apache.org/jira/browse/CB-6940): Fixing up commit from dzeims\n* [CB-6940](https://issues.apache.org/jira/browse/CB-6940): Android: cleanup try/catch exception handling\n* [CB-6940](https://issues.apache.org/jira/browse/CB-6940): `context.getExternal*` methods return null if sdcard isn't in mounted state, causing exceptions that prevent startup from reaching readystate\n* Fix mis-handling of filesystem reference in Entry.moveTo ('this' used in closure).\n* [CB-6902](https://issues.apache.org/jira/browse/CB-6902): Use File.lastModified rather than .lastModifiedDate\n* [CB-6922](https://issues.apache.org/jira/browse/CB-6922): Remove unused getMetadata native code\n* [CB-6922](https://issues.apache.org/jira/browse/CB-6922): Use getFileMetadata consistently to get metadata\n* changed fullPath to self.rootDocsPath\n* [CB-6890](https://issues.apache.org/jira/browse/CB-6890): Fix pluginManager access for 4.0.x branch\n\n### 1.2.1\n* [CB-6922](https://issues.apache.org/jira/browse/CB-6922) Fix inconsistent handling of lastModifiedDate and modificationTime\n* [CB-285](https://issues.apache.org/jira/browse/CB-285): Document filesystem root properties\n\n### 1.2.0 (Jun 05, 2014)\n* [CB-6127](https://issues.apache.org/jira/browse/CB-6127) Spanish and French Translations added. Github close #31\n* updated this reference to window\n* Add missing semicolon (copy & paste error)\n* Fix compiler warning about symbol in interface not matching implementation\n* Fix sorting order in supported platforms\n* ubuntu: increase quota value\n* ubuntu: Change FS URL scheme to 'cdvfile'\n* ubuntu: Return size with Entry.getMetadata() method\n* [CB-6803](https://issues.apache.org/jira/browse/CB-6803) Add license\n* Initial implementation for Firefox OS\n* Small wording tweaks\n* Fixed toURL() toInternalURL() information in the doku\n* ios: Don't fail a write of zero-length payload.\n* [CB-285](https://issues.apache.org/jira/browse/CB-285) Docs for cordova.file.\\*Directory properties\n* [CB-285](https://issues.apache.org/jira/browse/CB-285) Add cordova.file.\\*Directory properties for iOS & Android\n* [CB-3440](https://issues.apache.org/jira/browse/CB-3440) [BlackBerry10] Proxy based implementation\n* Fix typo in docs \"app-bundle\" -> \"bundle\"\n* [CB-6583](https://issues.apache.org/jira/browse/CB-6583) ios: Fix failing to create entry when space in parent path\n* [CB-6571](https://issues.apache.org/jira/browse/CB-6571) android: Make DirectoryEntry.toURL() have a trailing /\n* [CB-6491](https://issues.apache.org/jira/browse/CB-6491) add CONTRIBUTING.md\n* [CB-6525](https://issues.apache.org/jira/browse/CB-6525) android, ios: Allow file: URLs in all APIs. Fixes FileTransfer.download not being called.\n* fix the Windows 8 implementation of the getFile method\n* Update File.js for typo: lastModifiedData --> lastModifiedDate (closes #38)\n* Add error codes.\n* [CB-5980](https://issues.apache.org/jira/browse/CB-5980) Updated version and RELEASENOTES.md for release 1.0.0\n* Add NOTICE file\n* [CB-6114](https://issues.apache.org/jira/browse/CB-6114) Updated version and RELEASENOTES.md for release 1.0.1\n* [CB-5980](https://issues.apache.org/jira/browse/CB-5980) Updated version and RELEASENOTES.md for release 1.0.0\n\n### 1.1.0 (Apr 17, 2014)\n* [CB-4965](https://issues.apache.org/jira/browse/CB-4965): Remove tests from file plugin\n* Android: Allow file:/ URLs\n* [CB-6422](https://issues.apache.org/jira/browse/CB-6422): [windows8] use cordova/exec/proxy\n* [CB-6249](https://issues.apache.org/jira/browse/CB-6249): [android] Opportunistically resolve content urls to file\n* [CB-6394](https://issues.apache.org/jira/browse/CB-6394): [ios, android] Add extra filesystem roots\n* [CB-6394](https://issues.apache.org/jira/browse/CB-6394): [ios, android] Fix file resolution for the device root case\n* [CB-6394](https://issues.apache.org/jira/browse/CB-6394): [ios] Return ENCODING_ERR when fs name is not valid\n* [CB-6393](https://issues.apache.org/jira/browse/CB-6393): Change behaviour of toURL and toNativeURL\n* ios: Style: plugin initialization\n* ios: Fix handling of file URLs with encoded spaces\n* Always use Android's recommended temp file location for temporary file system\n* [CB-6352](https://issues.apache.org/jira/browse/CB-6352): Allow FileSystem objects to be serialized to JSON\n* [CB-5959](https://issues.apache.org/jira/browse/CB-5959): size is explicitly 0 if not set, file.spec.46&47 are testing the type of size\n* [CB-6242](https://issues.apache.org/jira/browse/CB-6242): [BlackBerry10] Add deprecated version of resolveLocalFileSystemURI\n* [CB-6242](https://issues.apache.org/jira/browse/CB-6242): [BlackBerry10] add file:/// prefix for toURI / toURL\n* [CB-6242](https://issues.apache.org/jira/browse/CB-6242): [BlackBerry10] Polyfill window.requestAnimationFrame for OS < 10.2\n* [CB-6242](https://issues.apache.org/jira/browse/CB-6242): [BlackBerry10] Override window.resolveLocalFileSystemURL\n* [CB-6212](https://issues.apache.org/jira/browse/CB-6212): [iOS] fix warnings compiled under arm64 64-bit\n* ios: Don't cache responses from CDVFile's URLProtocol\n* [CB-6199](https://issues.apache.org/jira/browse/CB-6199): [iOS] Fix toNativeURL() not escaping characters properly\n* [CB-6148](https://issues.apache.org/jira/browse/CB-6148): Fix cross-filesystem copy and move\n* fixed setMetadata() to use the formatted fullPath\n* corrected typo which leads to a \"comma expression\"\n* [CB-4952](https://issues.apache.org/jira/browse/CB-4952): ios: Resolve symlinks in file:// URLs\n* Add docs about the extraFileSystems preference\n* [CB-6460](https://issues.apache.org/jira/browse/CB-6460): Update license headers\n\n### 1.0.1 (Feb 28, 2014)\n* [CB-6116](https://issues.apache.org/jira/browse/CB-6116) Fix error where resolveLocalFileSystemURL would fail\n* [CB-6106](https://issues.apache.org/jira/browse/CB-6106) Add support for nativeURL attribute on Entry objects\n* [CB-6110](https://issues.apache.org/jira/browse/CB-6110) iOS: Fix typo in filesystemPathForURL: method\n* Android: Use most specific FS match when resolving file: URIs\n* iOS: Update fileSystemURLforLocalPath: to return the most match url.\n* Allow third-party plugin registration, and the total count of fs type is not limited to just 4.\n* [CB-6097](https://issues.apache.org/jira/browse/CB-6097) Added missing files for amazon-fireos platform. Added onLoad flag to true.\n* [CB-6087](https://issues.apache.org/jira/browse/CB-6087) Android, iOS: Load file plugin on startup\n* [CB-6013](https://issues.apache.org/jira/browse/CB-6013) BlackBerry10: wrap webkit prefixed called in requestAnimationFrame\n* Update plugin writers' documentation\n* [CB-6080](https://issues.apache.org/jira/browse/CB-6080) Fix file copy when src and dst are on different local file systems\n* [CB-6057](https://issues.apache.org/jira/browse/CB-6057) Add methods for plugins to convert between URLs and paths\n* [CB-6050](https://issues.apache.org/jira/browse/CB-6050) Public method for returning a FileEntry from a device file path\n* [CB-2432](https://issues.apache.org/jira/browse/CB-2432) [CB-3185](https://issues.apache.org/jira/browse/CB-3185), [CB-5975](https://issues.apache.org/jira/browse/CB-5975): Fix Android handling of content:// URLs\n* [CB-6022](https://issues.apache.org/jira/browse/CB-6022) Add upgrade notes to doc\n* [CB-5233](https://issues.apache.org/jira/browse/CB-5233) Make asset-library urls work properly on iOS\n* [CB-6012](https://issues.apache.org/jira/browse/CB-6012) Preserve query strings on cdvfile:// URLs where necessary\n* [CB-6010](https://issues.apache.org/jira/browse/CB-6010) Test properly for presence of URLforFilesystemPath method\n* [CB-5959](https://issues.apache.org/jira/browse/CB-5959) Entry.getMetadata should return size attribute\n\n### 1.0.0 (Feb 05, 2014)\n* [CB-5974](https://issues.apache.org/jira/browse/CB-5974): Use safe 'Compatibilty' mode by default\n* [CB-5915](https://issues.apache.org/jira/browse/CB-5915): [CB-5916](https://issues.apache.org/jira/browse/CB-5916): Reorganize preference code to make defaults possible\n* [CB-5974](https://issues.apache.org/jira/browse/CB-5974): Android: Don't allow File operations to continue when not configured\n* [CB-5960](https://issues.apache.org/jira/browse/CB-5960): ios: android: Properly handle parent references in getFile/getDirectory\n* [ubuntu] adopt to recent changes\n* Add default FS root to new FS objects\n* [CB-5899](https://issues.apache.org/jira/browse/CB-5899): Make DirectoryReader.readEntries return properly formatted Entry objects\n* Add constuctor params to FileUploadResult related to [CB-2421](https://issues.apache.org/jira/browse/CB-2421)\n* Fill out filesystem attribute of entities returned from resolveLocalFileSystemURL\n* [CB-5916](https://issues.apache.org/jira/browse/CB-5916): Create documents directories if they don't exist\n* [CB-5915](https://issues.apache.org/jira/browse/CB-5915): Create documents directories if they don't exist\n* [CB-5916](https://issues.apache.org/jira/browse/CB-5916): Android: Fix unfortunate NPE in config check\n* [CB-5916](https://issues.apache.org/jira/browse/CB-5916): Android: Add \"/files/\" to persistent files path\n* [CB-5915](https://issues.apache.org/jira/browse/CB-5915): ios: Update config preference (and docs) to match issue\n* [CB-5916](https://issues.apache.org/jira/browse/CB-5916): Android: Add config preference for Android persistent storage location\n* iOS: Add config preference for iOS persistent storage location\n* iOS: Android: Allow third-party plugin registration\n* Android: Expose filePlugin getter so that other plugins can register filesystems\n* Fix typos in deprecation message\n* Add backwards-compatibility shim for file-transfer\n* Android: Allow third-party plugin registration\n* [CB-5810](https://issues.apache.org/jira/browse/CB-5810) [BlackBerry10] resolve local:/// paths (application assets)\n* [CB-5774](https://issues.apache.org/jira/browse/CB-5774): create DirectoryEntry instead of FileEntry\n* Initial fix for [CB-5747](https://issues.apache.org/jira/browse/CB-5747)\n* Change default FS URL scheme to \"cdvfile\"\n* Android: Properly format content urls\n* Android, iOS: Replace \"filesystem\" protocol string with constant\n* Android: Allow absolute paths on Entry.getFile / Entry.getDirectory\n* Android: Make clear that getFile takes a path, not just a filename\n* [CB-5008](https://issues.apache.org/jira/browse/CB-5008): Rename resolveLocalFileSystemURI to resolveLocalFileSystemURL; deprecate original\n* Remove old file reference from plugin.xml\n* Android: Refactor File API\n* [CB-4899](https://issues.apache.org/jira/browse/CB-4899) [BlackBerry10] Fix resolve directories\n* [CB-5602](https://issues.apache.org/jira/browse/CB-5602) Windows8. Fix File Api mobile spec tests\n* Android: Better support for content urls and cross-filesystem copy/move ops\n* [CB-5699](https://issues.apache.org/jira/browse/CB-5699) [BlackBerry10] Update resolveLocalFileSystemURI implementation\n* [CB-5658](https://issues.apache.org/jira/browse/CB-5658) Update license comment formatting of doc/index.md\n* [CB-5658](https://issues.apache.org/jira/browse/CB-5658) Add doc.index.md for File plugin.\n* [CB-5658](https://issues.apache.org/jira/browse/CB-5658) Delete stale snapshot of plugin docs\n* [CB-5403](https://issues.apache.org/jira/browse/CB-5403): Backwards-compatibility with file:// urls where possible\n* [CB-5407](https://issues.apache.org/jira/browse/CB-5407): Fixes for ContentFilesystem\n* Android: Add method for testing backwards-compatibility of filetransfer plugin\n* iOS: Add method for testing backwards-compatiblity of filetransfer plugin\n* Android: Updates to allow FileTransfer to continue to work\n* Android: Clean up unclosed file objects\n* [CB-5407](https://issues.apache.org/jira/browse/CB-5407): Cleanup\n* [CB-5407](https://issues.apache.org/jira/browse/CB-5407): Add new Android source files to plugin.xml\n* [CB-5407](https://issues.apache.org/jira/browse/CB-5407): Move read, write and truncate methods into modules\n* [CB-5407](https://issues.apache.org/jira/browse/CB-5407): Move copy/move methods into FS modules\n* [CB-5407](https://issues.apache.org/jira/browse/CB-5407): Move getParent into FS modules\n* [CB-5407](https://issues.apache.org/jira/browse/CB-5407): Move getmetadata methods into FS modules\n* [CB-5407](https://issues.apache.org/jira/browse/CB-5407): Move readdir methods into FS modules\n* [CB-5407](https://issues.apache.org/jira/browse/CB-5407): Move remove methods into FS modules\n* [CB-5407](https://issues.apache.org/jira/browse/CB-5407): Move getFile into FS modules\n* [CB-5407](https://issues.apache.org/jira/browse/CB-5407): Start refactoring android code: Modular filesystems, rfs, rlfsurl\n* [CB-5407](https://issues.apache.org/jira/browse/CB-5407): Update android JS to use FS urls\n* [CB-5405](https://issues.apache.org/jira/browse/CB-5405): Use URL formatting for Entry.toURL\n* [CB-5532](https://issues.apache.org/jira/browse/CB-5532) Fix\n* Log file path for File exceptions.\n* Partial fix for iOS File compatibility with previous fileTransfer plugin\n* [CB-5532](https://issues.apache.org/jira/browse/CB-5532) WP8. Add binary data support to FileWriter\n* [CB-5531](https://issues.apache.org/jira/browse/CB-5531) WP8. File Api readAsText incorrectly handles position args\n* Added ubuntu platform support\n* Added amazon-fireos platform support\n* [CB-5118](https://issues.apache.org/jira/browse/CB-5118) [BlackBerry10] Add check for undefined error handler\n* [CB-5406](https://issues.apache.org/jira/browse/CB-5406): Extend public API for dependent plugins\n* [CB-5403](https://issues.apache.org/jira/browse/CB-5403): Bump File plugin major version\n* [CB-5406](https://issues.apache.org/jira/browse/CB-5406): Split iOS file plugin into modules\n* [CB-5406](https://issues.apache.org/jira/browse/CB-5406): Factor out filesystem providers in iOS\n* [CB-5408](https://issues.apache.org/jira/browse/CB-5408): Add handler for filesystem:// urls\n* [CB-5406](https://issues.apache.org/jira/browse/CB-5406): Update iOS native code to use filesystem URLs internally\n* [CB-5405](https://issues.apache.org/jira/browse/CB-5405): Update JS code to use URLs exclusively\n* [CB-4816](https://issues.apache.org/jira/browse/CB-4816) Fix file creation outside sandbox for BB10\n\n### 0.2.5 (Oct 28, 2013)\n* [CB-5129](https://issues.apache.org/jira/browse/CB-5129): Add a consistent filesystem attribute to FileEntry and DirectoryEntry objects\n* [CB-5128](https://issues.apache.org/jira/browse/CB-5128): added repo + issue tag to plugin.xml for file plugin\n* [CB-5015](https://issues.apache.org/jira/browse/CB-5015) [BlackBerry10] Add missing dependency for File.slice\n* [CB-5010](https://issues.apache.org/jira/browse/CB-5010) Incremented plugin version on dev branch.\n\n### 0.2.4 (Oct 9, 2013)\n* [CB-5020](https://issues.apache.org/jira/browse/CB-5020) - File plugin should execute on a separate thread\n* [CB-4915](https://issues.apache.org/jira/browse/CB-4915) Incremented plugin version on dev branch.\n* [CB-4504](https://issues.apache.org/jira/browse/CB-4504): Updating FileUtils.java to compensate for Java porting failures in the Android SDK. This fails because Java knows nothing about android_asset not being an actual filesystem\n\n### 0.2.3 (Sept 25, 2013)\n* [CB-4889](https://issues.apache.org/jira/browse/CB-4889) bumping&resetting version\n* [CB-4903](https://issues.apache.org/jira/browse/CB-4903) File Plugin not loading Windows8\n* [CB-4903](https://issues.apache.org/jira/browse/CB-4903) File Plugin not loading Windows8\n* [CB-4889](https://issues.apache.org/jira/browse/CB-4889) renaming references\n* [CB-4889](https://issues.apache.org/jira/browse/CB-4889) renaming org.apache.cordova.core.file to org.apache.cordova.file\n* Rename CHANGELOG.md -> RELEASENOTES.md\n* [CB-4771](https://issues.apache.org/jira/browse/CB-4771) Expose TEMPORARY and PERSISTENT constants on window.\n* Fix compiler/lint warnings\n* [CB-4764](https://issues.apache.org/jira/browse/CB-4764) Move DirectoryManager.java into file plugin\n* [CB-4763](https://issues.apache.org/jira/browse/CB-4763) Copy FileHelper.java into the plugin.\n* [CB-2901](https://issues.apache.org/jira/browse/CB-2901) [BlackBerry10] Automatically unsandbox filesystem if path is not in app sandbox\n* [CB-4752](https://issues.apache.org/jira/browse/CB-4752) Incremented plugin version on dev branch.\n\n### 0.2.1 (Sept 5, 2013)\n* [CB-4656](https://issues.apache.org/jira/browse/CB-4656) Don't add newlines in data urls within readAsDataUrl.\n* [CB-4514](https://issues.apache.org/jira/browse/CB-4514) Making DirectoryCopy Recursive\n* [iOS] Simplify the code in resolveLocalFileSystemURI\n"
},
{
"path": "plugins/cordova-plugin-file/doc/de/README.md",
"content": "\n\n# cordova-plugin-file\n\n[](https://travis-ci.org/apache/cordova-plugin-file)\n\nDieses Plugin implementiert eine File-API, die Lese-/Schreibzugriff Zugriff auf Dateien, die auf dem Gerät befinden.\n\nDieses Plugin basiert auf mehrere Angaben, einschließlich: die HTML5-File-API \n\nDie (heute nicht mehr existierenden) Verzeichnisse und System neuesten Erweiterungen: , obwohl die meisten von den Plugin-Code wurde geschrieben, als eine frühere Spec aktuell waren: \n\nEs implementiert auch die FileWriter Spec: \n\nVerwendung finden Sie in HTML5 Rocks ausgezeichnete [Dateisystem Artikel.](http://www.html5rocks.com/en/tutorials/file/filesystem/)\n\nFinden Sie einen Überblick über andere Speicheroptionen Cordovas [Speicher-Führer](http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html).\n\nDieses Plugin wird global `cordova.file`-Objekt definiert.\n\nObwohl im globalen Gültigkeitsbereich, steht es nicht bis nach dem `deviceready`-Ereignis.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(cordova.file);\n }\n \n\n## Installation\n\n cordova plugin add cordova-plugin-file\n \n\n## Unterstützte Plattformen\n\n * Amazon Fire OS\n * Android\n * BlackBerry 10\n * Firefox OS\n * iOS\n * Windows Phone 7 und 8 *\n * Windows 8 *\n * Windows*\n * Browser\n\n\\* *These platforms do not support `FileReader.readAsArrayBuffer` nor `FileWriter.write(blob)`.*\n\n## Wo Dateien gespeichert\n\nStand: V1 werden URLs auf wichtige Datei-System-Verzeichnisse zur Verfügung gestellt. Jede URL in der Form *file:///path/to/spot/* ist, und ein `DirectoryEntry` mit `window.resolveLocalFileSystemURL()` konvertiert werden können.\n\n * `cordova.file.applicationDirectory`-Die schreibgeschützten Verzeichnis, in dem die Anwendung installiert ist. (*iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.applicationStorageDirectory`-Root-Verzeichnis der Anwendungs-Sandbox; auf iOS ist schreibgeschützt (aber bestimmte Unterverzeichnisse [wie `/Documents` ] sind Lese-und Schreibzugriff). Alle enthaltene Daten ist für die app privat. ( *iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.dataDirectory`-Beständige und private Datenspeicherung innerhalb der Anwendungs-Sandbox, die mit internen Speicher (auf Android, externen Speicher verwenden, verwenden Sie `.externalDataDirectory` ). Auf iOS, ist dieses Verzeichnis nicht mit iCloud synchronisiert (verwenden Sie `.syncedDataDirectory` ). (*iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.cacheDirectory`-Verzeichnis der zwischengespeicherten Daten-Dateien oder Dateien, die Ihre app einfach neu erstellen können. Das Betriebssystem kann diese Dateien löschen, wenn das Gerät auf Speicher knapp wird, dennoch sollten die apps vom Betriebssystem zum Löschen von Dateien hier nicht verlassen. (*iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.externalApplicationStorageDirectory`-Anwendungsraum auf externen Speicher. (*Android*)\n\n * `cordova.file.externalDataDirectory`-Wo, app-spezifische Datendateien auf externen Speicher setzen. (*Android*)\n\n * `cordova.file.externalCacheDirectory`-Anwendungscache auf externen Speicher. (*Android*)\n\n * `cordova.file.externalRootDirectory`-Externer Speicher (SD-Karte) Stamm. (*Android*, *BlackBerry 10*)\n\n * `cordova.file.tempDirectory`-Temp-Verzeichnis, dem das OS auf deaktivieren können wird. Verlassen Sie sich nicht auf das Betriebssystem, um dieses Verzeichnis zu löschen; Ihre Anwendung sollte immer Dateien gegebenenfalls entfernen. (*iOS*)\n\n * `cordova.file.syncedDataDirectory`-Hält app-spezifische Dateien, die (z. B. auf iCloud) synchronisiert werden sollten. (*iOS*)\n\n * `cordova.file.documentsDirectory`-Dateien für die app, aber privat sind sinnvoll, andere Anwendungen (z.B. Office-Dateien). (*iOS*)\n\n * `cordova.file.sharedDirectory`-Dateien für alle Anwendungen (*BlackBerry 10* weltweit verfügbar)\n\n## Dateisystemlayouts\n\nObwohl technisch ein Implementierungsdetail, kann es sehr hilfreich zu wissen, wie die `cordova.file.*`-Eigenschaften physikalische Pfade auf einem echten Gerät zugeordnet sein.\n\n### iOS-Datei-System-Layout\n\n| Gerätepfad | `Cordova.file.*` | `iosExtraFileSystems` | R/w? | persistent? | OS löscht | Sync | Private |\n|:---------------------------------------------- |:--------------------------- |:--------------------- |:----:|:-----------:|:------------:|:----:|:-------:|\n| `/ Var/mobile/Applications/< UUID > /` | applicationStorageDirectory | - | r | N/A | N/A | N/A | Ja |\n| `appname.app/` | applicationDirectory | Bundle | r | N/A | N/A | N/A | Ja |\n| `www/` | - | - | r | N/A | N/A | N/A | Ja |\n| `Documents/` | documentsDirectory | Dokumente | R/w | Ja | Nein | Ja | Ja |\n| `NoCloud/` | - | Dokumente-nosync | R/w | Ja | Nein | Nein | Ja |\n| `Library` | - | Bibliothek | R/w | Ja | Nein | Ja? | Ja |\n| `NoCloud/` | dataDirectory | Bibliothek-nosync | R/w | Ja | Nein | Nein | Ja |\n| `Cloud/` | syncedDataDirectory | - | R/w | Ja | Nein | Ja | Ja |\n| `Caches/` | cacheDirectory | Cache | R/w | Ja * | Ja**\\* | Nein | Ja |\n| `tmp/` | tempDirectory | - | R/w | Nein** | Ja**\\* | Nein | Ja |\n\n\\ * Dateien über app-Neustarts und Upgrades beibehalten, aber dieses Verzeichnis kann gelöscht werden, wenn das OS begehrt. Ihre Anwendung sollte in der Lage, alle Inhalte neu zu erstellen, die gelöscht werden können.\n\n** -Dateien kann über app-Neustarts beizubehalten, aber verlasse dich nicht auf dieses Verhalten. Dateien sind nicht unbedingt Aktuelles beibehalten. Ihre Anwendung sollte Dateien aus diesem Verzeichnis entfernen, wenn es gilt, diese Dateien werden entfernt, da das OS nicht wann (oder auch wenn) garantiert.\n\n**\\ * The OS kann den Inhalt dieses Verzeichnisses löschen, wann immer es sich anfühlt, ist es erforderlich, aber verlassen Sie sich nicht dazu. Sie sollten dieses Verzeichnis entsprechend Ihrer Anwendung deaktivieren.\n\n### Android File System-Layout\n\n| Gerätepfad | `Cordova.file.*` | `AndroidExtraFileSystems` | R/w? | persistent? | OS löscht | Private |\n|:------------------------------------------------ |:----------------------------------- |:------------------------- |:----:|:-----------:|:----------:|:-------:|\n| `file:///android_asset/` | applicationDirectory | | r | N/A | N/A | Ja |\n| `/ Data/Data/< app-Id > /` | applicationStorageDirectory | - | R/w | N/A | N/A | Ja |\n| `cache` | cacheDirectory | Cache | R/w | Ja | Ja\\* | Ja |\n| `files` | dataDirectory | Dateien | R/w | Ja | Nein | Ja |\n| `Documents` | | Dokumente | R/w | Ja | Nein | Ja |\n| `< Sdcard > /` | externalRootDirectory | sdcard | R/w | Ja | Nein | Nein |\n| `Android/data//` | externalApplicationStorageDirectory | - | R/w | Ja | Nein | Nein |\n| `cache` | externalCacheDirectry | Cache-extern | R/w | Ja | Nein** | Nein |\n| `files` | externalDataDirectory | Dateien-extern | R/w | Ja | Nein | Nein |\n\n\\ * OS kann regelmäßig dieses Verzeichnis zu löschen, aber verlasse dich nicht auf dieses Verhalten. Deaktivieren Sie den Inhalt dieses Verzeichnisses für Ihre Anwendung geeigneten. Ein Benutzer den Cache manuell löschen sollte, werden die Inhalte dieses Verzeichnisses entfernt.\n\n** Der OS nicht klar dieses Verzeichnis automatisch; Sie sind verantwortlich für die Inhalte selbst verwalten. Der Benutzer den Cache manuell löschen sollte, werden der Inhalt des Verzeichnisses entfernt.\n\n**Hinweis**: Wenn externe Speichergeräte nicht bereitgestellt werden kann, sind die `cordova.file.external*` Eigenschaften `null`.\n\n### BlackBerry 10-File-System-Layout\n\n| Gerätepfad | `Cordova.file.*` | R/w? | persistent? | OS löscht | Private |\n|:----------------------------------------------------------- |:--------------------------- |:----:|:-----------:|:---------:|:-------:|\n| `file:///Accounts/1000/APPDATA/ < app Id > /` | applicationStorageDirectory | r | N/A | N/A | Ja |\n| `app/native` | applicationDirectory | r | N/A | N/A | Ja |\n| `data/webviews/webfs/temporary/local__0` | cacheDirectory | R/w | Nein | Ja | Ja |\n| `data/webviews/webfs/persistent/local__0` | dataDirectory | R/w | Ja | Nein | Ja |\n| `file:///Accounts/1000/Removable/sdcard` | externalRemovableDirectory | R/w | Ja | Nein | Nein |\n| `file:///Accounts/1000/Shared` | sharedDirectory | R/w | Ja | Nein | Nein |\n\n*Hinweis*: Wenn die Anwendung bereitgestellt wird, um Perimeter zu arbeiten, alle Pfade sind relativ /accounts/1000-enterprise.\n\n## Android Eigenarten\n\n### Android permanenten Speicherort\n\nEs gibt mehrere gültige Speicherorte, persistente Dateien auf einem Android-Gerät zu speichern. Finden Sie auf [dieser Seite](http://developer.android.com/guide/topics/data/data-storage.html) eine ausführliche Diskussion über die verschiedenen Möglichkeiten.\n\nFrühere Versionen des Plugins wählen würde, den Speicherort der temporären und permanenten Dateien beim Start, basierend auf, ob das Gerät behauptete, dass die SD-Karte (oder gleichwertige Speicherpartition) bereitgestellt wurde. Wenn die SD-Karte eingelegt wurde, oder wenn eine große interne Speicherpartition verfügbar war (wie auf Nexus-Geräten) und dann in die Wurzel dieses Raumes, die persistenten Dateien gespeichert werden. Dies bedeutete, dass alle Cordova apps aller verfügbaren Dateien auf der Karte sehen konnte.\n\nWenn die SD-Karte nicht verfügbar war, dann Vorgängerversionen Daten unter speichern würde `/data/data/`, die isoliert Anwendungen voneinander, aber möglicherweise noch Ursache Daten zwischen Benutzern freigegeben werden.\n\nEs ist jetzt möglich, ob Sie Dateien der internen Datei-Speicherort oder unter Verwendung der bisherigen Logik, mit einer Präferenz in der Anwendung-`config.xml`-Datei speichern möchten. Hierzu fügen Sie eine dieser zwei Zeilen zu `\"config.xml\"`:\n\n \n \n \n \n\nOhne diese Zeile wird das Datei Plugin `Compatibility` als Standard verwenden. Wenn ein Präferenz-Tag vorhanden ist, und nicht einen der folgenden Werte, wird die Anwendung nicht gestartet.\n\nWenn Ihre Anwendung für Benutzer zuvor versandt wird, mithilfe eines älteren (Pre-1.0) Version dieses Plugins und gespeicherte Dateien im permanenten Dateisystem hat, dann sollten Sie die Einstellung zur `Compatibility` einstellen. Wechseln die Location auf \"Internal\" würde bedeuten, dass Benutzer, die aktualisieren Sie ihre Anwendung, möglicherweise nicht auf ihre zuvor gespeicherte Dateien, abhängig von ihrem Gerät zugreifen.\n\nWenn Ihre Anwendung neu ist, oder nie zuvor Dateien im Dateisystem persistent gespeichert hat, wird die `Internal` Einstellung in der Regel empfohlen.\n\n### Langsame rekursive Operationen für /android_asset\n\nAuflisten von Verzeichnissen Vermögenswert ist wirklich langsam auf Android. Sie können beschleunigen, es oben aber durch `src/android/build-extras.gradle` in das Stammverzeichnis von Ihrem android Projekt hinzufügen (erfordert auch cordova-android@4.0.0 oder größer).\n\n## iOS Macken\n\n * `cordova.file.applicationStorageDirectory`ist schreibgeschützt; zum Speichern von Dateien im Stammverzeichnis der Versuch schlägt fehl. Verwenden Sie eine der anderen `cordova.file.*` für iOS definierten Eigenschaften (nur `applicationDirectory` und `applicationStorageDirectory` sind schreibgeschützt).\n * `FileReader.readAsText(blob, encoding)` \n * Die `encoding` Parameter wird nicht unterstützt und UTF-8-Kodierung ist immer wirksam.\n\n### iOS permanenten Speicherort\n\nEs gibt zwei gültige Speicherorte persistente Dateien auf ein iOS-Gerät speichern: das Dokumenten-Verzeichnis und das Verzeichnis Library. Frühere Versionen des Plugins gespeichert immer nur persistente Dateien im Verzeichnis Dokumente. Dies hatte den Nebeneffekt einer Anwendung Dateien in iTunes, die oft unbeabsichtigte, speziell für Anwendungen, die viele kleine Dateien behandeln war, sichtbar zu machen, anstatt komplette Dokumente für den Export, die den beabsichtigten Zweck des Verzeichnisses ist zu produzieren.\n\nEs ist jetzt möglich, ob Sie Dateien in Dokumente oder Verzeichnis Library mit einer Präferenz in der Anwendung-`config.xml`-Datei speichern möchten. Hierzu fügen Sie eine dieser zwei Zeilen zu `\"config.xml\"`:\n\n \n \n \n \n\nOhne diese Zeile wird das Datei Plugin `Compatibility` als Standard verwenden. Wenn ein Präferenz-Tag vorhanden ist, und nicht einen der folgenden Werte, wird die Anwendung nicht gestartet.\n\nWenn Ihre Anwendung für Benutzer zuvor versandt wird, mithilfe eines älteren (Pre-1.0) Version dieses Plugins und gespeicherte Dateien im permanenten Dateisystem hat, dann sollten Sie die Einstellung zur `Compatibility` einstellen. Standort zur `Library` wechseln würde bedeuten, dass Benutzer, die ihre Anwendung aktualisieren nicht in der Lage wäre, ihre zuvor gespeicherte Dateien zugreifen.\n\nWenn die Anwendung neu, oder nie zuvor Dateien im Dateisystem persistent gespeichert hat, wird die Einstellung der `Library` allgemein empfohlen.\n\n## Firefox OS Macken\n\nDer Datei-System-API wird von Firefox-OS nicht nativ unterstützt und wird als ein Shim auf IndexedDB implementiert.\n\n * Schlägt nicht fehl, wenn Sie nicht leere Verzeichnisse entfernen\n * Metadaten wird für Verzeichnisse nicht unterstützt.\n * Methoden `copyTo` und `moveTo` unterstützen keine Verzeichnisse\n\nDie folgenden Datenpfade werden unterstützt: * `applicationDirectory` - `xhr` verwendet, um lokale Dateien erhalten, die mit der app verpackt sind. *`dataDirectory` - für persistente app-spezifische Daten-Dateien. *`cacheDirectory` - Cache-Dateien, die app startet überleben sollte (Apps sollten nicht vom Betriebssystem zum Löschen von Dateien hier verlassen).\n\n## Browser-Eigenheiten\n\n### Gemeinsamen Macken und Bemerkungen\n\n * Jeder Browser verwendet ein eigene Sandbox Dateisystem. IE und Firefox verwenden IndexedDB als Basis. Alle Browser verwenden Schrägstrich als Verzeichnistrennzeichen in einem Pfad.\n * Directory-Einträge müssen nacheinander erstellt werden. Z. B. der Aufruf `fs.root.getDirectory (\"dir1/Ordner2 ', {create:true}, SuccessCallback, ErrorCallback)` schlägt fehl, wenn dir1 nicht existierte.\n * Das Plugin fordert Benutzer die Berechtigung zum permanenten Speicher beim ersten Start Anwendung verwenden. \n * Plugin unterstützt `Cdvfile://localhost` (lokale Ressourcen) nur. D.h. externe Ressourcen nicht über `Cdvfile` unterstützt.\n * Das Plugin folgt nicht [\"File System API 8.3 Naming Einschränkungen\"](http://www.w3.org/TR/2011/WD-file-system-api-20110419/#naming-restrictions).\n * BLOB und Datei \"`close`-Funktion wird nicht unterstützt.\n * `FileSaver` und `BlobBuilder` werden von diesem Plugin nicht unterstützt und müssen nicht geboren.\n * Das Plugin unterstützt keine `RequestAllFileSystems`. Diese Funktion fehlt auch in den Spezifikationen.\n * Einträge im Verzeichnis werden nicht entfernt werden, wenn Sie verwenden `create: true` Flag für vorhandenes Verzeichnis.\n * Über Konstruktor erstellte Dateien werden nicht unterstützt. Sie sollten stattdessen die entry.file-Methode verwenden.\n * Jeder Browser verwendet eine eigene Form für Blob-URL-Verweise.\n * `readAsDataURL`-Funktion wird unterstützt, aber die Mediatype in Chrom hängt von der Eintrag Namenerweiterung, Mediatype im IE immer leer ist (das ist dasselbe wie `Text-Plain` gemäß der Spezifikation), Mediatype in Firefox ist immer `Application/Octet-Stream`. Beispielsweise, wenn der Inhalt `Abcdefg` gibt dann Firefox `Daten: Anwendung / Octet-Stream; base64, YWJjZGVmZw ==`, IE gibt `Daten:; base64, YWJjZGVmZw ==`, Chrom gibt `Daten: < Mediatype je nach Erweiterung des Eintragsnamens >; base64, YWJjZGVmZw ==`.\n * `ToInternalURL` gibt den Pfad zurück, in der Form `file:///persistent/path/to/entry` (Firefox, IE). Chrom gibt den Pfad zurück, in der Form `cdvfile://localhost/persistent/file`.\n\n### Chrom-Macken\n\n * Chrom-Dateisystem ist nicht sofort nach Gerät bereit. Als Workaround können Sie `FilePluginIsReady`-Ereignis abonnieren. Beispiel: \n\n```javascript\nwindow.addEventListener('filePluginIsReady', function(){ console.log('File plugin is ready');}, false);\n```\n\n`Window.isFilePluginReadyRaised`-Funktion können Sie überprüfen, ob Ereignis bereits ausgelöst wurde. -window.requestFileSystem temporär und PERSISTENTE Dateisystem-Quoten sind nicht begrenzt, in Chrom. -Um die dauerhafte Speicherung in Chrom zu erhöhen benötigen Sie `window.initPersistentFileSystem`-Methode aufrufen. Permanenter Speicherkontingent beträgt 5 MB standardmäßig. -Chrome erforderlich `--erlauben-Datei-Zugriff-aus-Files` Argument an den Support API via `file:///` Protokoll führen. -`Datei`-Objekt wird nicht geändert werden, wenn Sie Flag verwenden `{create:true}` als einen vorhandenen `Eintrag` zu erhalten. -Veranstaltungen `cancelable`-Eigenschaft festgelegt ist in Chrom wahr. Dies widerspricht der [Spezifikation](http://dev.w3.org/2009/dap/file-system/file-writer.html). -`toURL`-Funktion in Chrome zurück `Dateisystem:`-Pfad je nach Anwendungshost vorangestellt. Z. B. `filesystem:file:///persistent/somefile.txt`, `Filesystem:http://localhost:8080/persistent/somefile.txt`. -`toURL` Funktionsergebnis enthält keine nachgestellten Schrägstrich bei Verzeichniseintrag. Chrom löst Verzeichnisse mit Schrägstrich-gezogene Urls aber korrekt. -`ResolveLocalFileSystemURL`-Methode erfordert die eingehenden `Url` `Dateisystem` Präfix haben. Beispielsweise sollte die `Url`-Parameter für `ResolveLocalFileSystemURL` in der Form `filesystem:file:///persistent/somefile.txt` im Gegensatz zu der Form `file:///persistent/somefile.txt` in Android. -Veraltete `ToNativeURL`-Funktion wird nicht unterstützt und muss keinen Stub. -`SetMetadata`-Funktion ist nicht in den Spezifikationen angegeben und nicht unterstützt. -INVALID_MODIFICATION_ERR (Code: 9) wird ausgelöst, statt SYNTAX_ERR(code: 8) auf anfordern des Dateisystems nicht existent. -INVALID_MODIFICATION_ERR (Code: 9) wird ausgelöst, anstatt PATH_EXISTS_ERR(code: 12) zu versuchen, die ausschließlich eine Datei oder ein Verzeichnis zu erstellen, die bereits vorhanden ist. -INVALID_MODIFICATION_ERR (Code: 9) wird ausgelöst, anstatt NO_MODIFICATION_ALLOWED_ERR(code: 6) zu versuchen, rufen Sie RemoveRecursively auf das Root-Dateisystem. -INVALID_MODIFICATION_ERR (Code: 9) wird ausgelöst, anstatt NOT_FOUND_ERR(code: 1) zu versuchen, MoveTo-Verzeichnis, das nicht vorhanden ist.\n\n### Auf der Grundlage von IndexedDB Impl Macken (Firefox und IE)\n\n * `.` und `.` werden nicht unterstützt.\n * IE unterstützt keine `file:///`-Modus; nur der Modus für gehostete ist unterstützten (Http://localhost:xxxx).\n * Firefox Dateisystem Größe ist nicht begrenzt, aber jede 50MB-Erweiterung wird eine Benutzer die Berechtigung anzufordern. IE10 können bis zu 10mb kombinierte AppCache und IndexedDB in Implementierung des Dateisystems verwendet, ohne Aufforderung, sobald Sie dieses Niveau, werden, das Sie aufgefordert werden schlagen, wenn Sie es bis Max 250 mb pro Standort erhöht werden sollen. `Size`-Parameter für `RequestFileSystem` Funktion wirkt also nicht Dateisystem in Firefox und IE.\n * `ReadAsBinaryString` Funktion heißt es nicht in die Angaben und in IE nicht unterstützt und muss keinen Stub.\n * `file.Type` ist immer null.\n * Sie sollten nicht erstellen Eintrag mit DirectoryEntry Instanz Rückrufergebnis, die gelöscht wurde. Andernfalls erhalten Sie einen \"hängende Eintrag\".\n * Bevor Sie eine Datei lesen können, die gerade geschrieben wurde, müssen Sie eine neue Instanz dieser Datei erhalten.\n * `SetMetadata`-Funktion, die nicht in den Specs genannt unterstützt Feldänderung nur `ModificationTime`. \n * `CopyTo` und `MoveTo`-Funktionen unterstützen keine Verzeichnisse.\n * Verzeichnisse-Metadaten werden nicht unterstützt.\n * Beide Entry.remove und directoryEntry.removeRecursively nicht scheitern, wenn nicht leere Verzeichnisse entfernen - Verzeichnisse entfernt werden stattdessen zusammen mit Inhalt gereinigt.\n * `abort` und `truncate`-Funktionen werden nicht unterstützt.\n * Progress-Ereignisse werden nicht ausgelöst. Beispielsweise wird dieser Handler nicht ausgeführt werden:\n\n```javascript\nwriter.onprogress = function() { /*commands*/ };\n```\n\n## Upgrade Notes\n\nIn v1.0.0 dieses Plugins haben die `FileEntry` und `DirectoryEntry` Strukturen geändert, um mehr im Einklang mit der veröffentlichten Spezifikation sein.\n\nVorgängerversionen (Pre-1.0.0) des Plugins den Gerät-Absolute-Dateispeicherort in der Eigenschaft `fullPath` `Entry` Objekte gespeichert. Diese Pfade würde in der Regel aussehen\n\n /var/mobile/Applications//Documents/path/to/file (iOS)\n /storage/emulated/0/path/to/file (Android)\n \n\nDiese Pfade wurden auch von der `toURL()`-Methode der `Entry` Objekte zurückgegeben.\n\nMit v1.0.0 ist das `fullPath`-Attribut den Pfad zu der Datei, *relativ zum Stammverzeichnis des Dateisystems HTML*. Also, würde die oben genannten Wege jetzt beide durch ein `FileEntry`-Objekt mit einem `fullPath` von dargestellt werden\n\n /path/to/file\n \n\nWenn Ihre Anwendung mit absoluter Gerätepfade arbeitet und Sie zuvor diese Pfade durch die Eigenschaft `fullPath` `Entry` Objekte abgerufen, sollten dann Sie den Code, um stattdessen `entry.toURL()` verwenden aktualisieren.\n\nFür rückwärts Kompatibilität, die `resolveLocalFileSystemURL()`-Methode wird einen Absolute-Gerätepfad zu akzeptieren und kehrt ein `Entry`-Objekt entspricht, solange diese Datei in den `TEMPORARY` oder `PERSISTENT` Dateisysteme existiert.\n\nDies wurde vor allem ein Problem mit dem File-Transfer-Plugin, die zuvor-Absolute-Gerätepfade verwendet (und kann damit noch einverstanden). Es wurde überarbeitet, um mit Dateisystem-URLs korrekt zu arbeiten, damit ersetzen `entry.fullPath` mit `entry.toURL()` immer das Plugin zum Arbeiten mit Dateien auf dem Gerät Probleme lösen sollte.\n\nIn v1.1.0 wurde der Rückgabewert von `toURL()` (siehe \\[CB-6394\\] (https://issues.apache.org/jira/browse/CB-6394)) geändert, um eine absolute \"file://\" URL zurückgeben. wo immer möglich. Sicherstellung einer ' Cdvfile:'-URL können Sie an `toInternalURL()`. Diese Methode gibt jetzt Dateisystem URLs der Form zurück.\n\n cdvfile://localhost/persistent/path/to/file\n \n\ndie benutzt werden können, um die Datei eindeutig zu identifizieren.\n\n## Liste der Fehlercodes und Bedeutungen\n\nWenn ein Fehler ausgelöst wird, wird eines der folgenden Codes verwendet werden.\n\n| Code | Konstante |\n| ----:|:----------------------------- |\n| 1 | `NOT_FOUND_ERR` |\n| 2 | `SECURITY_ERR` |\n| 3 | `ABORT_ERR` |\n| 4 | `NOT_READABLE_ERR` |\n| 5 | `ENCODING_ERR` |\n| 6 | `NO_MODIFICATION_ALLOWED_ERR` |\n| 7 | `INVALID_STATE_ERR` |\n| 8 | `SYNTAX_ERR` |\n| 9 | `INVALID_MODIFICATION_ERR` |\n| 10 | `QUOTA_EXCEEDED_ERR` |\n| 11 | `TYPE_MISMATCH_ERR` |\n| 12 | `PATH_EXISTS_ERR` |\n\n## Konfigurieren das Plugin (Optional)\n\nDie Menge der verfügbaren Dateisysteme kann pro Plattform konfiguriert sein. Erkennen von iOS und Android ein Tag in `\"config.xml\"` die Namen der Dateisysteme installiert werden. Standardmäßig sind alle Datei-System-Roots aktiviert.\n\n \n \n \n\n### Android\n\n * `files`: interne Datei-Speicher-Verzeichnis der Anwendung\n * `files-external`: Verzeichnis der Anwendung externe Datei Speicher\n * `sdcard`: das externe Globaldatei-Speicherverzeichnis (Dies ist die Wurzel der SD-Karte, sofern installiert). Sie benötigen die Berechtigung zur Verwendung dieses `android.permission.WRITE_EXTERNAL_STORAGE`.\n * `cache`: internen Cache-Verzeichnis der Anwendung\n * `cache-external`: externer Cache-Verzeichnis der Anwendung\n * `root`: das gesamte Gerät-Dateisystem\n\nAndroid unterstützt auch eine spezielle Dateisystem mit dem Namen \"documents\", die ein Unterverzeichnis \"/Documents/\" die \"files\" Dateisystem darstellt.\n\n### iOS\n\n * `library`: Bibliothek-Verzeichnis der Anwendung\n * `documents`: Dokumente-Verzeichnis der Anwendung\n * `cache`: Cache-Verzeichnis der Anwendung\n * `bundle`: die Anwendung Bündel; den Speicherort der die app selbst auf dem Datenträger (schreibgeschützt)\n * `root`: das gesamte Gerät-Dateisystem\n\nStandardmäßig können die Bibliothek und Dokumenten-Verzeichnisse mit iCloud synchronisiert werden. Sie können auch verlangen, zwei zusätzliche Dateisysteme, `library-nosync` und `documents-nosync`, die einem speziellen nicht synchronisierten Verzeichnis innerhalb darstellen der `/Library` oder `/Documents`-Dateisystem."
},
{
"path": "plugins/cordova-plugin-file/doc/de/index.md",
"content": "\n\n# cordova-plugin-file\n\nDieses Plugin implementiert eine File-API, die Lese-/Schreibzugriff Zugriff auf Dateien, die auf dem Gerät befinden.\n\nDieses Plugin basiert auf mehrere Angaben, einschließlich: die HTML5-File-API \n\nDie (heute nicht mehr existierenden) Verzeichnisse und System neuesten Erweiterungen: , obwohl die meisten von den Plugin-Code wurde geschrieben, als eine frühere Spec aktuell waren: \n\nEs implementiert auch die FileWriter Spec: \n\nVerwendung finden Sie in HTML5 Rocks ausgezeichnete [Dateisystem Artikel.][1]\n\n [1]: http://www.html5rocks.com/en/tutorials/file/filesystem/\n\nFinden Sie einen Überblick über andere Speicheroptionen Cordovas [Speicher-Führer][2].\n\n [2]: http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html\n\nDieses Plugin wird global `cordova.file`-Objekt definiert.\n\nObwohl im globalen Gültigkeitsbereich, steht es nicht bis nach dem `deviceready`-Ereignis.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(cordova.file);\n }\n \n\n## Installation\n\n cordova plugin add cordova-plugin-file\n \n\n## Unterstützte Plattformen\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* Firefox OS\n* iOS\n* Windows Phone 7 und 8 *\n* Windows 8 *\n* Browser\n\n* *Diese Plattformen unterstützen nicht `FileReader.readAsArrayBuffer` noch `FileWriter.write(blob)`.*\n\n## Wo Dateien gespeichert\n\nStand: V1 werden URLs auf wichtige Datei-System-Verzeichnisse zur Verfügung gestellt. Jede URL in der Form *file:///path/to/spot/* ist, und ein `DirectoryEntry` mit `window.resolveLocalFileSystemURL()` konvertiert werden können.\n\n* `cordova.file.applicationDirectory`-Die schreibgeschützten Verzeichnis, in dem die Anwendung installiert ist. (*iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.applicationStorageDirectory`-Root-Verzeichnis der Anwendungs-Sandbox; auf iOS ist schreibgeschützt (aber bestimmte Unterverzeichnisse [wie `/Documents` ] sind Lese-und Schreibzugriff). Alle enthaltene Daten ist für die app privat. ( *iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.dataDirectory`-Beständige und private Datenspeicherung innerhalb der Anwendungs-Sandbox, die mit internen Speicher (auf Android, externen Speicher verwenden, verwenden Sie `.externalDataDirectory` ). Auf iOS, ist dieses Verzeichnis nicht mit iCloud synchronisiert (verwenden Sie `.syncedDataDirectory` ). (*iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.cacheDirectory`-Verzeichnis der zwischengespeicherten Daten-Dateien oder Dateien, die Ihre app einfach neu erstellen können. Das Betriebssystem kann diese Dateien löschen, wenn das Gerät auf Speicher knapp wird, dennoch sollten die apps vom Betriebssystem zum Löschen von Dateien hier nicht verlassen. (*iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.externalApplicationStorageDirectory`-Anwendungsraum auf externen Speicher. (*Android*)\n\n* `cordova.file.externalDataDirectory`-Wo, app-spezifische Datendateien auf externen Speicher setzen. (*Android*)\n\n* `cordova.file.externalCacheDirectory`-Anwendungscache auf externen Speicher. (*Android*)\n\n* `cordova.file.externalRootDirectory`-Externer Speicher (SD-Karte) Stamm. (*Android*, *BlackBerry 10*)\n\n* `cordova.file.tempDirectory`-Temp-Verzeichnis, dem das OS auf deaktivieren können wird. Verlassen Sie sich nicht auf das Betriebssystem, um dieses Verzeichnis zu löschen; Ihre Anwendung sollte immer Dateien gegebenenfalls entfernen. (*iOS*)\n\n* `cordova.file.syncedDataDirectory`-Hält app-spezifische Dateien, die (z. B. auf iCloud) synchronisiert werden sollten. (*iOS*)\n\n* `cordova.file.documentsDirectory`-Dateien für die app, aber privat sind sinnvoll, andere Anwendungen (z.B. Office-Dateien). (*iOS*)\n\n* `cordova.file.sharedDirectory`-Dateien für alle Anwendungen (*BlackBerry 10* weltweit verfügbar)\n\n## Dateisystemlayouts\n\nObwohl technisch ein Implementierungsdetail, kann es sehr hilfreich zu wissen, wie die `cordova.file.*`-Eigenschaften physikalische Pfade auf einem echten Gerät zugeordnet sein.\n\n### iOS-Datei-System-Layout\n\n| Gerätepfad | `Cordova.file.*` | `iosExtraFileSystems` | R/w? | persistent? | OS löscht | Sync | Private |\n|:-------------------------------------------- |:--------------------------- |:--------------------- |:----:|:-----------:|:----------:|:----:|:-------:|\n| `/ Var/mobile/Applications/< UUID > /` | applicationStorageDirectory | - | r | N/A | N/A | N/A | Ja |\n| `appname.app/` | applicationDirectory | Bundle | r | N/A | N/A | N/A | Ja |\n| `www/` | - | - | r | N/A | N/A | N/A | Ja |\n| `Documents/` | documentsDirectory | Dokumente | R/w | Ja | Nein | Ja | Ja |\n| `NoCloud/` | - | Dokumente-nosync | R/w | Ja | Nein | Nein | Ja |\n| `Library` | - | Bibliothek | R/w | Ja | Nein | Ja? | Ja |\n| `NoCloud/` | dataDirectory | Bibliothek-nosync | R/w | Ja | Nein | Nein | Ja |\n| `Cloud/` | syncedDataDirectory | - | R/w | Ja | Nein | Ja | Ja |\n| `Caches/` | cacheDirectory | Cache | R/w | Ja * | Ja * * *| | Nein | Ja |\n| `tmp/` | tempDirectory | - | R/w | Nicht * * | Ja * * *| | Nein | Ja |\n\n* Dateien werden hinweg app Neustarts und Upgrades beibehalten, aber dieses Verzeichnis kann gelöscht werden, wenn das OS begehrt. Ihre Anwendung sollte in der Lage, Inhalte zu erschaffen, die möglicherweise gelöscht werden.\n\n* *-Dateien kann über app-Neustarts beizubehalten, aber verlasse dich nicht auf dieses Verhalten. Dateien sind nicht unbedingt Aktuelles beibehalten. Ihre Anwendung sollte Dateien aus diesem Verzeichnis entfernen, wenn es gilt, diese Dateien werden entfernt, da das OS nicht wann (oder auch wenn) garantiert.\n\n* * *| The OS kann den Inhalt dieses Verzeichnisses löschen, wenn es sich anfühlt, ist es erforderlich, aber verlassen Sie sich nicht dazu. Sie sollten dieses Verzeichnis entsprechend Ihrer Anwendung deaktivieren.\n\n### Android File System-Layout\n\n| Gerätepfad | `Cordova.file.*` | `AndroidExtraFileSystems` | R/w? | persistent? | OS löscht | Private |\n|:--------------------------------- |:----------------------------------- |:------------------------- |:----:|:-----------:|:---------:|:-------:|\n| `file:///android_asset/` | applicationDirectory | | r | N/A | N/A | Ja |\n| `/ Data/Data/< app-Id > /` | applicationStorageDirectory | - | R/w | N/A | N/A | Ja |\n| `cache` | cacheDirectory | Cache | R/w | Ja | Ja * | Ja |\n| `files` | dataDirectory | Dateien | R/w | Ja | Nein | Ja |\n| `Documents` | | Dokumente | R/w | Ja | Nein | Ja |\n| `< Sdcard > /` | externalRootDirectory | sdcard | R/w | Ja | Nein | Nein |\n| `Android/data//` | externalApplicationStorageDirectory | - | R/w | Ja | Nein | Nein |\n| `cache` | externalCacheDirectry | Cache-extern | R/w | Ja | Nicht * * | Nein |\n| `files` | externalDataDirectory | Dateien-extern | R/w | Ja | Nein | Nein |\n\n* Das Betriebssystem kann regelmäßig dieses Verzeichnis zu löschen, aber verlasse dich nicht auf dieses Verhalten. Deaktivieren Sie den Inhalt dieses Verzeichnisses für Ihre Anwendung geeigneten. Ein Benutzer den Cache manuell löschen sollte, werden die Inhalte dieses Verzeichnisses entfernt.\n\n* * The OS nicht klar dieses Verzeichnis automatisch; Sie sind verantwortlich für die Inhalte selbst verwalten. Der Benutzer den Cache manuell löschen sollte, werden der Inhalt des Verzeichnisses entfernt.\n\n**Hinweis**: Wenn externe Speichergeräte nicht bereitgestellt werden kann, sind die `cordova.file.external*` Eigenschaften `null`.\n\n### BlackBerry 10-File-System-Layout\n\n| Gerätepfad | `Cordova.file.*` | R/w? | persistent? | OS löscht | Private |\n|:--------------------------------------------------- |:--------------------------- |:----:|:-----------:|:---------:|:-------:|\n| `file:///Accounts/1000/APPDATA/ < app Id > /` | applicationStorageDirectory | r | N/A | N/A | Ja |\n| `app/native` | applicationDirectory | r | N/A | N/A | Ja |\n| `data/webviews/webfs/temporary/local__0` | cacheDirectory | R/w | Nein | Ja | Ja |\n| `data/webviews/webfs/persistent/local__0` | dataDirectory | R/w | Ja | Nein | Ja |\n| `file:///Accounts/1000/Removable/sdcard` | externalRemovableDirectory | R/w | Ja | Nein | Nein |\n| `file:///Accounts/1000/Shared` | sharedDirectory | R/w | Ja | Nein | Nein |\n\n*Hinweis*: Wenn die Anwendung bereitgestellt wird, um Perimeter zu arbeiten, alle Pfade sind relativ /accounts/1000-enterprise.\n\n## Android Eigenarten\n\n### Android permanenten Speicherort\n\nEs gibt mehrere gültige Speicherorte, persistente Dateien auf einem Android-Gerät zu speichern. Finden Sie auf [dieser Seite][3] eine ausführliche Diskussion über die verschiedenen Möglichkeiten.\n\n [3]: http://developer.android.com/guide/topics/data/data-storage.html\n\nFrühere Versionen des Plugins wählen würde, den Speicherort der temporären und permanenten Dateien beim Start, basierend auf, ob das Gerät behauptete, dass die SD-Karte (oder gleichwertige Speicherpartition) bereitgestellt wurde. Wenn die SD-Karte eingelegt wurde, oder wenn eine große interne Speicherpartition verfügbar war (wie auf Nexus-Geräten) und dann in die Wurzel dieses Raumes, die persistenten Dateien gespeichert werden. Dies bedeutete, dass alle Cordova apps aller verfügbaren Dateien auf der Karte sehen konnte.\n\nWenn die SD-Karte nicht verfügbar war, dann Vorgängerversionen Daten unter speichern würde `/data/data/`, die isoliert Anwendungen voneinander, aber möglicherweise noch Ursache Daten zwischen Benutzern freigegeben werden.\n\nEs ist jetzt möglich, ob Sie Dateien der internen Datei-Speicherort oder unter Verwendung der bisherigen Logik, mit einer Präferenz in der Anwendung-`config.xml`-Datei speichern möchten. Hierzu fügen Sie eine dieser zwei Zeilen zu `\"config.xml\"`:\n\n \n \n \n \n\nOhne diese Zeile wird das Datei Plugin `Compatibility` als Standard verwenden. Wenn ein Präferenz-Tag vorhanden ist, und nicht einen der folgenden Werte, wird die Anwendung nicht gestartet.\n\nWenn Ihre Anwendung für Benutzer zuvor versandt wird, mithilfe eines älteren (Pre-1.0) Version dieses Plugins und gespeicherte Dateien im permanenten Dateisystem hat, dann sollten Sie die Einstellung zur `Compatibility` einstellen. Wechseln die Location auf \"Internal\" würde bedeuten, dass Benutzer, die aktualisieren Sie ihre Anwendung, möglicherweise nicht auf ihre zuvor gespeicherte Dateien, abhängig von ihrem Gerät zugreifen.\n\nWenn Ihre Anwendung neu ist, oder nie zuvor Dateien im Dateisystem persistent gespeichert hat, wird die `Internal` Einstellung in der Regel empfohlen.\n\n## iOS Macken\n\n* `cordova.file.applicationStorageDirectory`ist schreibgeschützt; zum Speichern von Dateien im Stammverzeichnis der Versuch schlägt fehl. Verwenden Sie eine der anderen `cordova.file.*` für iOS definierten Eigenschaften (nur `applicationDirectory` und `applicationStorageDirectory` sind schreibgeschützt).\n* `FileReader.readAsText(blob, encoding)` \n * Die `encoding` Parameter wird nicht unterstützt und UTF-8-Kodierung ist immer wirksam.\n\n### iOS permanenten Speicherort\n\nEs gibt zwei gültige Speicherorte persistente Dateien auf ein iOS-Gerät speichern: das Dokumenten-Verzeichnis und das Verzeichnis Library. Frühere Versionen des Plugins gespeichert immer nur persistente Dateien im Verzeichnis Dokumente. Dies hatte den Nebeneffekt einer Anwendung Dateien in iTunes, die oft unbeabsichtigte, speziell für Anwendungen, die viele kleine Dateien behandeln war, sichtbar zu machen, anstatt komplette Dokumente für den Export, die den beabsichtigten Zweck des Verzeichnisses ist zu produzieren.\n\nEs ist jetzt möglich, ob Sie Dateien in Dokumente oder Verzeichnis Library mit einer Präferenz in der Anwendung-`config.xml`-Datei speichern möchten. Hierzu fügen Sie eine dieser zwei Zeilen zu `\"config.xml\"`:\n\n \n \n \n \n\nOhne diese Zeile wird das Datei Plugin `Compatibility` als Standard verwenden. Wenn ein Präferenz-Tag vorhanden ist, und nicht einen der folgenden Werte, wird die Anwendung nicht gestartet.\n\nWenn Ihre Anwendung für Benutzer zuvor versandt wird, mithilfe eines älteren (Pre-1.0) Version dieses Plugins und gespeicherte Dateien im permanenten Dateisystem hat, dann sollten Sie die Einstellung zur `Compatibility` einstellen. Standort zur `Library` wechseln würde bedeuten, dass Benutzer, die ihre Anwendung aktualisieren nicht in der Lage wäre, ihre zuvor gespeicherte Dateien zugreifen.\n\nWenn die Anwendung neu, oder nie zuvor Dateien im Dateisystem persistent gespeichert hat, wird die Einstellung der `Library` allgemein empfohlen.\n\n## Firefox OS Macken\n\nDer Datei-System-API wird von Firefox-OS nicht nativ unterstützt und wird als ein Shim auf IndexedDB implementiert.\n\n* Schlägt nicht fehl, wenn Sie nicht leere Verzeichnisse entfernen\n* Metadaten wird für Verzeichnisse nicht unterstützt.\n* Methoden `copyTo` und `moveTo` unterstützen keine Verzeichnisse\n\nDie folgenden Datenpfade werden unterstützt: * `applicationDirectory` - `xhr` verwendet, um lokale Dateien erhalten, die mit der app verpackt sind. *`dataDirectory` - für persistente app-spezifische Daten-Dateien. *`cacheDirectory` - Cache-Dateien, die app startet überleben sollte (Apps sollten nicht vom Betriebssystem zum Löschen von Dateien hier verlassen).\n\n## Browser-Eigenheiten\n\n### Gemeinsamen Macken und Bemerkungen\n\n* Jeder Browser verwendet ein eigene Sandbox Dateisystem. IE und Firefox verwenden IndexedDB als Basis. Alle Browser verwenden Schrägstrich als Verzeichnistrennzeichen in einem Pfad.\n* Directory-Einträge müssen nacheinander erstellt werden. Z. B. der Aufruf `fs.root.getDirectory (\"dir1/Ordner2 ', {create:true}, SuccessCallback, ErrorCallback)` schlägt fehl, wenn dir1 nicht existierte.\n* Das Plugin fordert Benutzer die Berechtigung zum permanenten Speicher beim ersten Start Anwendung verwenden. \n* Plugin unterstützt `Cdvfile://localhost` (lokale Ressourcen) nur. D.h. externe Ressourcen nicht über `Cdvfile` unterstützt.\n* Das Plugin folgt nicht [\"File System API 8.3 Naming Einschränkungen\"][4].\n* BLOB und Datei \"`close`-Funktion wird nicht unterstützt.\n* `FileSaver` und `BlobBuilder` werden von diesem Plugin nicht unterstützt und müssen nicht geboren.\n* Das Plugin unterstützt keine `RequestAllFileSystems`. Diese Funktion fehlt auch in den Spezifikationen.\n* Einträge im Verzeichnis werden nicht entfernt werden, wenn Sie verwenden `create: true` Flag für vorhandenes Verzeichnis.\n* Über Konstruktor erstellte Dateien werden nicht unterstützt. Sie sollten stattdessen die entry.file-Methode verwenden.\n* Jeder Browser verwendet eine eigene Form für Blob-URL-Verweise.\n* `readAsDataURL`-Funktion wird unterstützt, aber die Mediatype in Chrom hängt von der Eintrag Namenerweiterung, Mediatype im IE immer leer ist (das ist dasselbe wie `Text-Plain` gemäß der Spezifikation), Mediatype in Firefox ist immer `Application/Octet-Stream`. Beispielsweise, wenn der Inhalt `Abcdefg` gibt dann Firefox `Daten: Anwendung / Octet-Stream; base64, YWJjZGVmZw ==`, IE gibt `Daten:; base64, YWJjZGVmZw ==`, Chrom gibt `Daten: < Mediatype je nach Erweiterung des Eintragsnamens >; base64, YWJjZGVmZw ==`.\n* `ToInternalURL` gibt den Pfad zurück, in der Form `file:///persistent/path/to/entry` (Firefox, IE). Chrom gibt den Pfad zurück, in der Form `cdvfile://localhost/persistent/file`.\n\n [4]: http://www.w3.org/TR/2011/WD-file-system-api-20110419/#naming-restrictions\n\n### Chrom-Macken\n\n* Chrom-Dateisystem ist nicht sofort nach Gerät bereit. Als Workaround können Sie `FilePluginIsReady`-Ereignis abonnieren. Beispiel: \n\n javascript\n window.addEventListener('filePluginIsReady', function(){ console.log('File plugin is ready');}, false);\n \n\n`Window.isFilePluginReadyRaised`-Funktion können Sie überprüfen, ob Ereignis bereits ausgelöst wurde. -window.requestFileSystem temporär und PERSISTENTE Dateisystem-Quoten sind nicht begrenzt, in Chrom. -Um die dauerhafte Speicherung in Chrom zu erhöhen benötigen Sie `window.initPersistentFileSystem`-Methode aufrufen. Permanenter Speicherkontingent beträgt 5 MB standardmäßig. -Chrome erforderlich `--erlauben-Datei-Zugriff-aus-Files` Argument an den Support API via `file:///` Protokoll führen. -`Datei`-Objekt wird nicht geändert werden, wenn Sie Flag verwenden `{create:true}` als einen vorhandenen `Eintrag` zu erhalten. -Veranstaltungen `cancelable`-Eigenschaft festgelegt ist in Chrom wahr. Dies widerspricht der [Spezifikation][5]. -`toURL`-Funktion in Chrome zurück `Dateisystem:`-Pfad je nach Anwendungshost vorangestellt. Z. B. `filesystem:file:///persistent/somefile.txt`, `Filesystem:http://localhost:8080/persistent/somefile.txt`. -`toURL` Funktionsergebnis enthält keine nachgestellten Schrägstrich bei Verzeichniseintrag. Chrom löst Verzeichnisse mit Schrägstrich-gezogene Urls aber korrekt. -`ResolveLocalFileSystemURL`-Methode erfordert die eingehenden `Url` `Dateisystem` Präfix haben. Beispielsweise sollte die `Url`-Parameter für `ResolveLocalFileSystemURL` in der Form `filesystem:file:///persistent/somefile.txt` im Gegensatz zu der Form `file:///persistent/somefile.txt` in Android. -Veraltete `ToNativeURL`-Funktion wird nicht unterstützt und muss keinen Stub. -`SetMetadata`-Funktion ist nicht in den Spezifikationen angegeben und nicht unterstützt. -INVALID_MODIFICATION_ERR (Code: 9) wird ausgelöst, statt SYNTAX_ERR(code: 8) auf anfordern des Dateisystems nicht existent. -INVALID_MODIFICATION_ERR (Code: 9) wird ausgelöst, anstatt PATH_EXISTS_ERR(code: 12) zu versuchen, die ausschließlich eine Datei oder ein Verzeichnis zu erstellen, die bereits vorhanden ist. -INVALID_MODIFICATION_ERR (Code: 9) wird ausgelöst, anstatt NO_MODIFICATION_ALLOWED_ERR(code: 6) zu versuchen, rufen Sie RemoveRecursively auf das Root-Dateisystem. -INVALID_MODIFICATION_ERR (Code: 9) wird ausgelöst, anstatt NOT_FOUND_ERR(code: 1) zu versuchen, MoveTo-Verzeichnis, das nicht vorhanden ist.\n\n [5]: http://dev.w3.org/2009/dap/file-system/file-writer.html\n\n### Auf der Grundlage von IndexedDB Impl Macken (Firefox und IE)\n\n* `.` und `.` werden nicht unterstützt.\n* IE unterstützt keine `file:///`-Modus; nur der Modus für gehostete ist unterstützten (Http://localhost:xxxx).\n* Firefox Dateisystem Größe ist nicht begrenzt, aber jede 50MB-Erweiterung wird eine Benutzer die Berechtigung anzufordern. IE10 können bis zu 10mb kombinierte AppCache und IndexedDB in Implementierung des Dateisystems verwendet, ohne Aufforderung, sobald Sie dieses Niveau, werden, das Sie aufgefordert werden schlagen, wenn Sie es bis Max 250 mb pro Standort erhöht werden sollen. `Size`-Parameter für `RequestFileSystem` Funktion wirkt also nicht Dateisystem in Firefox und IE.\n* `ReadAsBinaryString` Funktion heißt es nicht in die Angaben und in IE nicht unterstützt und muss keinen Stub.\n* `file.Type` ist immer null.\n* Sie sollten nicht erstellen Eintrag mit DirectoryEntry Instanz Rückrufergebnis, die gelöscht wurde. Andernfalls erhalten Sie einen \"hängende Eintrag\".\n* Bevor Sie eine Datei lesen können, die gerade geschrieben wurde, müssen Sie eine neue Instanz dieser Datei erhalten.\n* `SetMetadata`-Funktion, die nicht in den Specs genannt unterstützt Feldänderung nur `ModificationTime`. \n* `CopyTo` und `MoveTo`-Funktionen unterstützen keine Verzeichnisse.\n* Verzeichnisse-Metadaten werden nicht unterstützt.\n* Beide Entry.remove und directoryEntry.removeRecursively nicht scheitern, wenn nicht leere Verzeichnisse entfernen - Verzeichnisse entfernt werden stattdessen zusammen mit Inhalt gereinigt.\n* `abort` und `truncate`-Funktionen werden nicht unterstützt.\n* Progress-Ereignisse werden nicht ausgelöst. Beispielsweise wird dieser Handler nicht ausgeführt werden:\n\n javascript\n writer.onprogress = function() { /*commands*/ };\n \n\n## Upgrade Notes\n\nIn v1.0.0 dieses Plugins haben die `FileEntry` und `DirectoryEntry` Strukturen geändert, um mehr im Einklang mit der veröffentlichten Spezifikation sein.\n\nVorgängerversionen (Pre-1.0.0) des Plugins den Gerät-Absolute-Dateispeicherort in der Eigenschaft `fullPath` `Entry` Objekte gespeichert. Diese Pfade würde in der Regel aussehen\n\n /var/mobile/Applications//Documents/path/to/file (iOS)\n /storage/emulated/0/path/to/file (Android)\n \n\nDiese Pfade wurden auch von der `toURL()`-Methode der `Entry` Objekte zurückgegeben.\n\nMit v1.0.0 ist das `fullPath`-Attribut den Pfad zu der Datei, *relativ zum Stammverzeichnis des Dateisystems HTML*. Also, würde die oben genannten Wege jetzt beide durch ein `FileEntry`-Objekt mit einem `fullPath` von dargestellt werden\n\n /path/to/file\n \n\nWenn Ihre Anwendung mit absoluter Gerätepfade arbeitet und Sie zuvor diese Pfade durch die Eigenschaft `fullPath` `Entry` Objekte abgerufen, sollten dann Sie den Code, um stattdessen `entry.toURL()` verwenden aktualisieren.\n\nFür rückwärts Kompatibilität, die `resolveLocalFileSystemURL()`-Methode wird einen Absolute-Gerätepfad zu akzeptieren und kehrt ein `Entry`-Objekt entspricht, solange diese Datei in den `TEMPORARY` oder `PERSISTENT` Dateisysteme existiert.\n\nDies wurde vor allem ein Problem mit dem File-Transfer-Plugin, die zuvor-Absolute-Gerätepfade verwendet (und kann damit noch einverstanden). Es wurde überarbeitet, um mit Dateisystem-URLs korrekt zu arbeiten, damit ersetzen `entry.fullPath` mit `entry.toURL()` immer das Plugin zum Arbeiten mit Dateien auf dem Gerät Probleme lösen sollte.\n\nIn v1.1.0 wurde der Rückgabewert von `toURL()` (siehe \\[CB-6394\\] (https://issues.apache.org/jira/browse/CB-6394)) geändert, um eine absolute \"file://\" URL zurückgeben. wo immer möglich. Sicherstellung einer ' Cdvfile:'-URL können Sie an `toInternalURL()`. Diese Methode gibt jetzt Dateisystem URLs der Form zurück.\n\n cdvfile://localhost/persistent/path/to/file\n \n\ndie benutzt werden können, um die Datei eindeutig zu identifizieren.\n\n## Liste der Fehlercodes und Bedeutungen\n\nWenn ein Fehler ausgelöst wird, wird eines der folgenden Codes verwendet werden.\n\n| Code | Konstante |\n| ----:|:----------------------------- |\n| 1 | `NOT_FOUND_ERR` |\n| 2 | `SECURITY_ERR` |\n| 3 | `ABORT_ERR` |\n| 4 | `NOT_READABLE_ERR` |\n| 5 | `ENCODING_ERR` |\n| 6 | `NO_MODIFICATION_ALLOWED_ERR` |\n| 7 | `INVALID_STATE_ERR` |\n| 8 | `SYNTAX_ERR` |\n| 9 | `INVALID_MODIFICATION_ERR` |\n| 10 | `QUOTA_EXCEEDED_ERR` |\n| 11 | `TYPE_MISMATCH_ERR` |\n| 12 | `PATH_EXISTS_ERR` |\n\n## Konfigurieren das Plugin (Optional)\n\nDie Menge der verfügbaren Dateisysteme kann pro Plattform konfiguriert sein. Erkennen von iOS und Android ein Tag in `\"config.xml\"` die Namen der Dateisysteme installiert werden. Standardmäßig sind alle Datei-System-Roots aktiviert.\n\n \n \n \n\n### Android\n\n* `files`: interne Datei-Speicher-Verzeichnis der Anwendung\n* `files-external`: Verzeichnis der Anwendung externe Datei Speicher\n* `sdcard`: das externe Globaldatei-Speicherverzeichnis (Dies ist die Wurzel der SD-Karte, sofern installiert). Sie benötigen die Berechtigung zur Verwendung dieses `android.permission.WRITE_EXTERNAL_STORAGE`.\n* `cache`: internen Cache-Verzeichnis der Anwendung\n* `cache-external`: externer Cache-Verzeichnis der Anwendung\n* `root`: das gesamte Gerät-Dateisystem\n\nAndroid unterstützt auch eine spezielle Dateisystem mit dem Namen \"documents\", die ein Unterverzeichnis \"/Documents/\" die \"files\" Dateisystem darstellt.\n\n### iOS\n\n* `library`: Bibliothek-Verzeichnis der Anwendung\n* `documents`: Dokumente-Verzeichnis der Anwendung\n* `cache`: Cache-Verzeichnis der Anwendung\n* `bundle`: die Anwendung Bündel; den Speicherort der die app selbst auf dem Datenträger (schreibgeschützt)\n* `root`: das gesamte Gerät-Dateisystem\n\nStandardmäßig können die Bibliothek und Dokumenten-Verzeichnisse mit iCloud synchronisiert werden. Sie können auch verlangen, zwei zusätzliche Dateisysteme, `library-nosync` und `documents-nosync`, die einem speziellen nicht synchronisierten Verzeichnis innerhalb darstellen der `/Library` oder `/Documents`-Dateisystem.\n"
},
{
"path": "plugins/cordova-plugin-file/doc/de/plugins.md",
"content": "\n\n# Hinweise für Plugin-Entwickler\n\nDiese Notizen sind hauptsächlich für Android und iOS-Entwickler, die Plugins welche Schnittstelle mit dem Dateisystem, mit dem Plugin Datei schreiben möchten.\n\n## Arbeiten mit Cordova-Datei-System-URLs\n\nSeit der Version 1.0.0, wurde dieses Plugin verwendet URLs mit einer `cdvfile` Regelung für die gesamte Kommunikation über die Brücke, sondern als raw-Device Dateisystempfade zu JavaScript auszusetzen.\n\nAuf der Seite JavaScript bedeutet dies, dass FileEntries und DirectoryEntry-Objekt ein FullPath-Attribut haben, die relativ zum Stammverzeichnis des Dateisystems HTML ist. Wenn Ihr Plugins-JavaScript-API ein FileEntries oder DirectoryEntry-Objekt akzeptiert, rufen Sie `.toURL()` auf das Objekt vor der Übergabe an systemeigenen Code über die Brücke.\n\n### Konvertieren von Cdvfile: / / URLs auf Fileystem Pfade\n\nPlugins, die auf das Dateisystem schreiben müssen, sollten eine empfangene Datei-System-URL auf eine tatsächliche Stelle des Dateisystems zu konvertieren. Es gibt mehrere Wege, dies zu tun, je nach einheitlichen Plattform.\n\nEs ist wichtig, daran erinnern, dass nicht alle `cdvfile://` URLs sind zuweisbaren real Dateien auf das Gerät. Einige URLs verweisen auf Vermögenswerte auf Gerät nicht durch Dateien dargestellt werden, oder sogar auf Remoteressourcen verweisen können. Aufgrund dieser Möglichkeiten sollten Plugins immer testen, ob sie ein sinnvolles Ergebnis zu erhalten, wieder bei dem Versuch, die URLs in Pfade umwandeln.\n\n#### Android\n\nAuf Android, konvertiert die einfachste Methode eine `cdvfile://` URL zu einem Dateisystempfad zu verwenden ist `org.apache.cordova.CordovaResourceApi` . `CordovaResourceApi`verfügt über mehrere Methoden der verarbeiten kann `cdvfile://` URLs:\n\n WebView ist Mitglied der Plugin-Klasse CordovaResourceApi ResourceApi = webView.getResourceApi();\n \n Erhalten eine file:/// URL, diese Datei auf dem Gerät / / oder die gleiche URL unverändert, wenn es eine Datei-Uri FileURL zugeordnet werden kann nicht = resourceApi.remapUri(Uri.parse(cdvfileURL));\n \n\nEs ist auch möglich, das Plugin Datei direkt zu verwenden:\n\n Import org.apache.cordova.file.FileUtils;\n Import org.apache.cordova.file.FileSystem;\n Import Java.net.MalformedURLException:;\n \n Erhalten Sie das Datei-Plugin aus dem Plugin-Manager FileUtils FilePlugin = (FileUtils)webView.pluginManager.getPlugin(\"File\");\n \n Angesichts eine URL, einen Pfad zu erhalten, denn es versuchen {String Pfad = filePlugin.filesystemPathForURL(cdvfileURL);} catch (MalformedURLException e) {/ / die Dateisystem-Url war nicht erkannt}\n \n\nAus einem Pfad zu konvertieren eine `cdvfile://` URL:\n\n Import org.apache.cordova.file.LocalFilesystemURL;\n \n Rufen Sie ein LocalFilesystemURL-Objekt für einen Gerätepfad / / oder null, wenn sie nicht als URL Cdvfile dargestellt wird.\n LocalFilesystemURL Url = filePlugin.filesystemURLforLocalPath(path);\n Erhalten Sie die Zeichenfolgendarstellung der URL Objekt String CdvfileURL = url.toString();\n \n\nWenn Ihr Plugin eine Datei erstellt, und Sie dafür ein FileEntries-Objekt zurückgeben möchten, verwenden Sie das Datei-Plugin:\n\n Zurückgeben eine JSON-Struktur geeignet für die Rückgabe an JavaScript, / / oder null, wenn diese Datei nicht als URL Cdvfile darstellbar ist.\n JSONObject Eintrag = filePlugin.getEntryForFile(file);\n \n\n#### iOS\n\nCordova auf iOS verwendet nicht das gleiche `CordovaResourceApi` Konzept als Android. Auf iOS sollten Sie das Datei-Plugin verwenden, zum Konvertieren von URLs und Dateisystem-Pfaden.\n\n Rufen Sie ein CDVFilesystem URL-Objekt von einer URL-Zeichenfolge CDVFilesystemURL * Url = [CDVFilesystemURL FileSystemURLWithString:cdvfileURL];\n Erhalten Sie einen Pfad für die URL-Objekt oder NULL, wenn es einen Dateipfad NSString * zugeordnet werden kann nicht = [FilePlugin FilesystemPathForURL:url];\n \n \n Eine CDVFilesystem URL-Objekt für einen Gerätepfad abrufen oder / / gleich NULL, wenn sie nicht als URL Cdvfile dargestellt wird.\n CDVFilesystemURL-Url = [FilePlugin FileSystemURLforLocalPath:path];\n Erhalten Sie die Zeichenfolgendarstellung der URL Objekt NSString * CdvfileURL = [Url AbsoluteString];\n \n\nWenn Ihr Plugin eine Datei erstellt, und Sie dafür ein FileEntries-Objekt zurückgeben möchten, verwenden Sie das Datei-Plugin:\n\n Eine CDVFilesystem URL-Objekt für einen Gerätepfad abrufen oder / / gleich NULL, wenn sie nicht als URL Cdvfile dargestellt wird.\n CDVFilesystemURL-Url = [FilePlugin FileSystemURLforLocalPath:path];\n Erhalten eine Struktur zurück nach JavaScript NSDictionary * Eintrag = [FilePlugin MakeEntryForLocalURL:url]\n \n\n#### JavaScript\n\nIn JavaScript, bekommen eine `cdvfile://` URL aus einem FileEntries oder DirectoryEntry-Objekt, rufen Sie einfach `.toURL()` drauf:\n\n Var CdvfileURL = entry.toURL();\n \n\nIm Plugin Antwort Handler zur Konvertierung von einer zurückgegebenen FileEntries-Struktur in einem tatsächlichen Eintrag-Objekt sollte Handlercode importieren die Datei-Erweiterung und ein neues Objekt zu erstellen:\n\n Erstellen Sie entsprechenden Eintrag Objekt Var Eintrag;\n Wenn (entryStruct.isDirectory) {Eintrag = neues DirectoryEntry (entryStruct.name, entryStruct.fullPath, neue FileSystem(entryStruct.filesystemName));} sonst {Eintrag = neue FileEntries (entryStruct.name, entryStruct.fullPath, neue FileSystem(entryStruct.filesystemName));}"
},
{
"path": "plugins/cordova-plugin-file/doc/es/README.md",
"content": "\n\n# cordova-plugin-file\n\n[](https://travis-ci.org/apache/cordova-plugin-file)\n\nEste plugin implementa una API de archivo que permite acceso de lectura/escritura a los archivos que residen en el dispositivo.\n\nEste plugin se basa en varias especificaciones, incluyendo: el HTML5 archivo API \n\nLos directorios (ahora extinto) y sistema de extensiones más recientes: aunque la mayor parte del código del plugin fue escrito cuando una especificación anterior era actual: \n\nTambién implementa la especificación de FileWriter: \n\nPara el uso, por favor, consulte 'HTML5 Rocks excelente [FileSystem artículo.](http://www.html5rocks.com/en/tutorials/file/filesystem/)\n\nPara tener una visión general de otras opciones de almacenamiento, consulte [Guía de almacenamiento Cordova](http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html).\n\nEste plugin define global `cordova.file` objeto.\n\nAunque en el ámbito global, no estará disponible hasta después de la `deviceready` evento.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(cordova.file);\n }\n \n\n## Instalación\n\n cordova plugin add cordova-plugin-file\n \n\n## Plataformas soportadas\n\n * Amazon fire OS\n * Android\n * BlackBerry 10\n * Firefox OS\n * iOS\n * Windows Phone 7 y 8 *\n * Windows 8 *\n * Windows*\n * Explorador\n\n\\* *These platforms do not support `FileReader.readAsArrayBuffer` nor `FileWriter.write(blob)`.*\n\n## Donde almacenar los archivos\n\nA partir de v1.2.0, URLs a directorios de sistema de archivos importantes son proporcionadas. Cada dirección URL está en la forma *file:///path/to/spot/*y se puede convertir en un `DirectoryEntry` usando`window.resolveLocalFileSystemURL()`.\n\n * `cordova.file.applicationDirectory`-Directorio Read-only donde está instalada la aplicación. (*iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.applicationStorageDirectory`-Directorio del entorno limitado de la aplicación; en iOS esta ubicación es de sólo lectura (pero subdirectorios específicos [como `/Documents` ] son de lectura y escritura). Todos los datos contenidos dentro es privado para la aplicación. ( *iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.dataDirectory`-Almacenamiento de datos persistente y privadas dentro de entorno limitado de la aplicación utilizando la memoria interna (en Android, si necesitas usar memoria externa, use `.externalDataDirectory` ). En iOS, este directorio no está sincronizado con iCloud (utilice `.syncedDataDirectory` ). (*iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.cacheDirectory`-Directorio para los archivos de datos almacenados en caché o los archivos que su aplicación puede volver a crear fácilmente. El sistema operativo puede borrar estos archivos cuando el dispositivo se agota en almacenamiento de información, sin embargo, aplicaciones no deben confiar en el sistema operativo para eliminar los archivos de aquí. (*iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.externalApplicationStorageDirectory`-Espacio aplicación de almacenamiento externo. (*Android*)\n\n * `cordova.file.externalDataDirectory`¿Dónde poner los archivos de datos específicos de la aplicación de almacenamiento externo. (*Android*)\n\n * `cordova.file.externalCacheDirectory`-Caché aplicación de almacenamiento externo. (*Android*)\n\n * `cordova.file.externalRootDirectory`-Raíz de almacenamiento externo (tarjeta SD). (*Android*, *BlackBerry 10*)\n\n * `cordova.file.tempDirectory`-Directorio temporal que puede borrar el sistema operativo en sí. No confíe en el sistema operativo para borrar este directorio; su aplicación siempre debe eliminar archivos según corresponda. (*iOS*)\n\n * `cordova.file.syncedDataDirectory`-Contiene los archivos de la aplicación específica que deben ser sincronizados (e.g. a iCloud). (*iOS*)\n\n * `cordova.file.documentsDirectory`-Archivos privados a la aplicación, pero que son significativos para otra aplicación (por ejemplo archivos de Office). (*iOS*)\n\n * `cordova.file.sharedDirectory`-Archivos disponibles globalmente para todas las aplicaciones (*BlackBerry 10*)\n\n## Diseños de sistema de archivo\n\nAunque técnicamente un detalle de la implementación, puede ser muy útil saber cómo la `cordova.file.*` mapa de propiedades en trazados físicos en un dispositivo real.\n\n### iOS diseño de sistema de archivo\n\n| Ruta de dispositivo | `Cordova.file.*` | `iosExtraFileSystems` | ¿r/w? | ¿persistente? | OS despeja | sincronización | privado |\n|:---------------------------------------------- |:--------------------------- |:--------------------- |:-----:|:-------------:|:-------------:|:--------------:|:-------:|\n| `/ var/mobile/Applications/< UUID > /` | applicationStorageDirectory | - | r | N / A | N / A | N / A | Sí |\n| `appname.app/` | applicationDirectory | Bundle | r | N / A | N / A | N / A | Sí |\n| `www/` | - | - | r | N / A | N / A | N / A | Sí |\n| `Documents/` | documentsDirectory | documentos | r/w | Sí | No | Sí | Sí |\n| `NoCloud/` | - | documentos-nosync | r/w | Sí | No | No | Sí |\n| `Library` | - | Biblioteca | r/w | Sí | No | ¿Sí? | Sí |\n| `NoCloud/` | dataDirectory | Biblioteca-nosync | r/w | Sí | No | No | Sí |\n| `Cloud/` | syncedDataDirectory | - | r/w | Sí | No | Sí | Sí |\n| `Caches/` | cacheDirectory | caché | r/w | Sí * | Yes**\\* | No | Sí |\n| `tmp/` | tempDirectory | - | r/w | No** | Yes**\\* | No | Sí |\n\n\\ * Archivos persisten a través de reinicios de aplicación y actualizaciones, pero este directorio puede ser despejó cuando el OS deseos. Su aplicación debe ser capaz de recrear cualquier contenido que puede ser eliminado.\n\n** Archivos puede persistir a través de la aplicación se reinicia, pero no confiar en este comportamiento. Los archivos no se garantizan que persisten a través de actualizaciones. Su aplicación debe eliminar los archivos de este directorio cuando es aplicable, como el sistema operativo no garantiza cuando (o incluso si) estos archivos se quitan.\n\n**\\ * OS la puede borrar el contenido de este directorio siempre que se siente es necesario, pero no dependen de esto. Debe borrar este directorio según sea apropiado para su aplicación.\n\n### Disposición del sistema Android File\n\n| Ruta de dispositivo | `Cordova.file.*` | `AndroidExtraFileSystems` | ¿r/w? | ¿persistente? | OS despeja | privado |\n|:------------------------------------------------ |:----------------------------------- |:------------------------- |:-----:|:-------------:|:----------:|:-------:|\n| `File:///android_asset/` | applicationDirectory | | r | N / A | N / A | Sí |\n| `/Data/data/< id de aplicación > /` | applicationStorageDirectory | - | r/w | N / A | N / A | Sí |\n| `cache` | cacheDirectory | caché | r/w | Sí | Sí \\ * | Sí |\n| `files` | dataDirectory | archivos | r/w | Sí | No | Sí |\n| `Documents` | | documentos | r/w | Sí | No | Sí |\n| `< sdcard > /` | externalRootDirectory | sdcard | r/w | Sí | No | No |\n| `Android/data//` | externalApplicationStorageDirectory | - | r/w | Sí | No | No |\n| `cache` | externalCacheDirectry | caché-externo | r/w | Sí | No** | No |\n| `files` | externalDataDirectory | archivos externos | r/w | Sí | No | No |\n\n\\ * El sistema operativo periódicamente puede borrar este directorio, pero no confiar en este comportamiento. Borrar el contenido de este directorio según sea apropiado para su aplicación. El contenido de este directorio debe un usuario purga la caché manualmente, se eliminan.\n\n** El sistema operativo no borrar este directorio automáticamente; usted es responsable de administrar el contenido usted mismo. Deberá el usuario purga la caché manualmente, se extraen los contenidos del directorio.\n\n**Nota**: Si no se puede montar de almacenamiento externo, el `cordova.file.external*` Propiedades`null`.\n\n### Disposición del sistema blackBerry 10 archivo\n\n| Ruta de dispositivo | `Cordova.file.*` | ¿r/w? | ¿persistente? | OS despeja | privado |\n|:------------------------------------------------------------- |:--------------------------- |:-----:|:-------------:|:----------:|:-------:|\n| `File:///accounts/1000/AppData/ < id de aplicación > /` | applicationStorageDirectory | r | N / A | N / A | Sí |\n| `app/native` | applicationDirectory | r | N / A | N / A | Sí |\n| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | No | Sí | Sí |\n| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | Sí | No | Sí |\n| `File:///accounts/1000/Removable/sdcard` | externalRemovableDirectory | r/w | Sí | No | No |\n| `File:///accounts/1000/shared` | sharedDirectory | r/w | Sí | No | No |\n\n*Nota*: cuando se implementa la aplicación al trabajo de perímetro, todos los caminos son relativos a /accounts/1000-enterprise.\n\n## Rarezas Android\n\n### Ubicación de almacenamiento persistente Android\n\nHay múltiples ubicaciones válidas para almacenar archivos persistentes en un dispositivo Android. Vea [esta página](http://developer.android.com/guide/topics/data/data-storage.html) para una extensa discusión de las distintas posibilidades.\n\nLas versiones anteriores del plugin elegiría la ubicación de los archivos temporales y persistentes en el arranque, basado en si el dispositivo afirmó que fue montado en la tarjeta SD (o partición de almacenamiento equivalente). Si fue montada en la tarjeta SD, o una partición de gran almacenamiento interno estaba disponible (como en dispositivos de Nexus,) y luego los archivos persistentes se almacenaría en la raíz de ese espacio. Esto significaba que todas las apps Cordova podían ver todos los archivos disponibles en la tarjeta.\n\nSi la tarjeta SD no estaba disponible, entonces versiones anteriores podría almacenar datos debajo de `/data/data/` , que aísla las apps del otro, pero puede todavía causa datos para ser compartido entre los usuarios.\n\nAhora es posible elegir si desea almacenar archivos en la ubicación de almacenamiento del archivo interno, o usando la lógica anterior, con una preferencia en de la aplicación `config.xml` archivo. Para ello, añada una de estas dos líneas a `config.xml` :\n\n \n \n \n \n\nSin esta línea, se utilizará el archivo plugin `Compatibility` como valor predeterminado. Si una etiqueta de preferencia está presente y no es uno de estos valores, no se iniciará la aplicación.\n\nSi su solicitud se ha enviado previamente a los usuarios, usando un mayor (1.0 pre) versión de este plugin y archivos almacenados en el sistema de ficheros persistente, entonces debería establecer la preferencia en `Compatibility` . Cambiar la ubicación para \"Internal\" significa que los usuarios existentes que actualización su aplicación pueden ser incapaces de acceder a sus archivos previamente almacenadas, dependiendo de su dispositivo.\n\nSi su solicitud es nuevo, o nunca antes ha almacenado archivos en el sistema de ficheros persistente, entonces el `Internal` generalmente se recomienda el ajuste.\n\n### Operaciones recursivas lento para /android_asset\n\nListado de directorios activos es realmente lento en Android. Usted puede acelerar hacia arriba, agregando `src/android/build-extras.gradle` a la raíz de tu proyecto android (también requiere de cordova-android@4.0.0 o mayor).\n\n## iOS rarezas\n\n * `cordova.file.applicationStorageDirectory`es de sólo lectura; intentar almacenar archivos en el directorio raíz fallará. Utilice uno de los `cordova.file.*` las propiedades definidas para iOS (sólo `applicationDirectory` y `applicationStorageDirectory` son de sólo lectura).\n * `FileReader.readAsText(blob, encoding)` \n * El `encoding` no se admite el parámetro, y codificación UTF-8 es siempre en efecto.\n\n### iOS ubicación de almacenamiento persistente\n\nHay dos ubicaciones válidas para almacenar archivos persistentes en un dispositivo iOS: el directorio de documentos y el directorio de biblioteca. Las versiones anteriores del plugin sólo almacenan archivos persistentes en el directorio de documentos. Esto tenía el efecto secundario de todos los archivos de la aplicación haciendo visible en iTunes, que era a menudo involuntarios, especialmente para aplicaciones que manejan gran cantidad de archivos pequeños, en lugar de producir documentos completos para la exportación, que es la finalidad del directorio.\n\nAhora es posible elegir si desea almacenar archivos en los documentos o directorio de bibliotecas, con preferencia en de la aplicación `config.xml` archivo. Para ello, añada una de estas dos líneas a `config.xml` :\n\n \n \n \n \n\nSin esta línea, se utilizará el archivo plugin `Compatibility` como valor predeterminado. Si una etiqueta de preferencia está presente y no es uno de estos valores, no se iniciará la aplicación.\n\nSi su solicitud se ha enviado previamente a los usuarios, usando un mayor (1.0 pre) versión de este plugin y archivos almacenados en el sistema de ficheros persistente, entonces debería establecer la preferencia en `Compatibility` . Cambiar la ubicación de `Library` significa que los usuarios existentes que actualización su aplicación sería incapaces de acceder a sus archivos previamente almacenadas.\n\nSi su solicitud es nuevo, o nunca antes ha almacenado archivos en el sistema de ficheros persistente, entonces el `Library` generalmente se recomienda el ajuste.\n\n## Firefox OS rarezas\n\nLa API de sistema de archivo de forma nativa no es compatible con Firefox OS y se implementa como una cuña en la parte superior indexedDB.\n\n * No falla cuando eliminar directorios no vacía\n * No admite metadatos para directorios\n * Los métodos `copyTo` y `moveTo` no son compatibles con directorios\n\nSe admiten las siguientes rutas de datos: * `applicationDirectory` -usa `xhr` para obtener los archivos locales que están envasados con la aplicación. * `dataDirectory` - Para archivos de datos específicos de aplicación persistente. * `cacheDirectory` -En caché archivos que deben sobrevivir se reinicia la aplicación (aplicaciones no deben confiar en el sistema operativo para eliminar archivos aquí).\n\n## Navegador rarezas\n\n### Rarezas y observaciones comunes\n\n * Cada navegador utiliza su propio sistema de ficheros un espacio aislado. IE y Firefox utilizan IndexedDB como base. Todos los navegadores utilizan diagonal como separador de directorio en un camino.\n * Las entradas de directorio deben crearse sucesivamente. Por ejemplo, la llamada `fs.root.getDirectory (' dir1/dir2 ', {create:true}, successCallback, errorCallback)` se producirá un error si no existiera dir1.\n * El plugin solicita permiso de usuario para usar almacenamiento persistente en el primer comienzo de la aplicación. \n * Plugin soporta `cdvfile://localhost` (recursos locales) solamente. Es decir, no se admiten los recursos externos vía `cdvfile`.\n * El plugin no sigue [\"Archivo sistema API 8.3 nombrando restricciones\"](http://www.w3.org/TR/2011/WD-file-system-api-20110419/#naming-restrictions).\n * BLOB y archivo ' `close` la función no es compatible.\n * `FileSaver` y `BlobBuilder` no son compatibles con este plugin y no tengo recibos.\n * El plugin no es compatible con `requestAllFileSystems`. Esta función también está desaparecida en las especificaciones.\n * No se quitarán las entradas de directorio Si utilizas `create: true` bandera de directorio existente.\n * No se admiten archivos creados mediante el constructor. Debe utilizar método entry.file en su lugar.\n * Cada navegador utiliza su propia forma de blob URL referencias.\n * se admite la función `readAsDataURL`, pero el mediatype en cromo depende de la extensión de nombre de entrada, mediatype en IE siempre está vacío (que es lo mismo como `plain-text` según la especificación), el mediatype en Firefox siempre es `application/octet-stream`. Por ejemplo, si el contenido es `abcdefg` entonces Firefox devuelve `datos: aplicación / octet-stream; base64, YWJjZGVmZw ==`, es decir devuelve `datos:; base64, YWJjZGVmZw ==`, cromo devuelve `datos: < mediatype dependiendo de la extensión de nombre de la entrada >; base64, YWJjZGVmZw ==`.\n * `toInternalURL` devuelve la ruta de la forma `file:///persistent/path/to/entry` (Firefox, IE). Cromo devuelve la ruta de acceso en el formulario `cdvfile://localhost/persistent/file`.\n\n### Rarezas de Chrome\n\n * Filesystem de Chrome no es inmediatamente después de evento ready dispositivo. Como solución temporal puede suscribirse al evento `filePluginIsReady`. Ejemplo: \n\n```javascript\nwindow.addEventListener('filePluginIsReady', function(){ console.log('File plugin is ready');}, false);\n```\n\nPuede utilizar la función `window.isFilePluginReadyRaised` para verificar si ya se provoca el evento. -window.requestFileSystem temporal y persistente filesystem cuotas no están limitadas en cromo. -Para aumentar el almacenamiento persistente en cromo necesitas llamar el método `window.initPersistentFileSystem`. Cuota de almacenamiento persistente es de 5 MB por defecto. -Chrome requiere `--permitir-archivo-acceso-de-archivos` ejecutar argumento al soporte API mediante protocolo `file:///`. -`Archivo` objeto no cambiará si utilizas bandera `{create:true}` cuando una `entrada` de existente. -eventos `cancelable` propiedad está establecida en true en cromo. Esto es contrario a la [Especificación](http://dev.w3.org/2009/dap/file-system/file-writer.html). -función de `toURL` en Chrome devuelve `filesystem:`-prefijo camino dependiendo de host de la aplicación. Por ejemplo, `filesystem:file:///persistent/somefile.txt`, `filesystem:http://localhost:8080/persistent/somefile.txt`. -resultado de la función de `toURL` no contiene barra en caso de entrada en el directorio. Cromo resuelve directorios con urls slash-siguió correctamente sin embargo. -método `resolveLocalFileSystemURL` requiere la entrantes `url` que tienen prefijo `filesystem`. Por ejemplo, el parámetro de `url` para `resolveLocalFileSystemURL` debería estar en la forma `filesystem:file:///persistent/somefile.txt` en comparación con la forma `file:///persistent/somefile.txt` en Android. -Obsoleto `toNativeURL` función no es compatible y no tiene un trozo. -función de `setMetadata` no es indicada en las especificaciones y no admite. -INVALID_MODIFICATION_ERR (código: 9) se lanza en lugar de SYNTAX_ERR(code: 8) a petición de un sistema de ficheros inexistentes. -INVALID_MODIFICATION_ERR (código: 9) se lanza en vez de PATH_EXISTS_ERR(code: 12) en intentar exclusivamente crear un archivo o directorio, que ya existe. -INVALID_MODIFICATION_ERR (código: 9) se lanza en lugar de NO_MODIFICATION_ALLOWED_ERR(code: 6) para tratar de llamar a removeRecursively en el sistema de archivos raíz. -INVALID_MODIFICATION_ERR (código: 9) se lanza en vez de NOT_FOUND_ERR(code: 1) en tratar de moveTo directorio que no existe.\n\n### Impl base IndexedDB rarezas (IE y Firefox)\n\n * `.` y `..` no son compatibles.\n * IE no soporta `file:///`-modo; modo alojado sólo es compatible (http://localhost:xxxx).\n * Tamaño del sistema de archivos de Firefox no es limitada pero cada extensión de 50 MB solicitará un permiso de usuario. IE10 permite hasta 10mb de combinados AppCache y IndexedDB utilizados en la implementación del sistema de ficheros sin preguntar, cuando llegas a ese nivel que se le preguntará si desea permitir que ser aumentada hasta un máximo de 250 mb por sitio. Para que `size` parámetro para la función `requestFileSystem` no afecta sistema de ficheros en Firefox y IE.\n * la función `readAsBinaryString` no se indica en las especificaciones y no compatible con IE y no tiene un trozo.\n * `file.type` siempre es null.\n * No debe crear entrada utilizando DirectoryEntry resultado de devolución de llamada de instancia que fue borrado. De lo contrario, obtendrá una entrada' colgar'.\n * Antes de que se puede leer un archivo, el cual fue escrito sólo que necesitas una nueva instancia de este archivo.\n * la función `setMetadata`, que no es indicada en las especificaciones soporta sólo el cambio de campo `modificationTime`. \n * `copyTo` y `moveTo` funciones no son compatibles con directorios.\n * Metadatos de directorios no es compatible.\n * Tanto Entry.remove y directoryEntry.removeRecursively no fallan al retirar no vacía directorios - directorios de ser eliminados se limpian junto con contenido en su lugar.\n * `abort` y `truncate` las funciones no son compatibles.\n * eventos de progreso no están despedidos. Por ejemplo, este controlador no ejecutará:\n\n```javascript\nwriter.onprogress = function() { /*commands*/ };\n```\n\n## Actualización de notas\n\nEn v1.0.0 de este plugin, han cambiado las estructuras `FileEntry` y `DirectoryEntry`, para estar más acorde con las especificaciones publicadas.\n\nVersiones anteriores (pre-1.0.0) del plugin almacenan el dispositivo-absoluto-archivo-ubicación en la propiedad `fullPath` de objetos de `entrada`. Estos caminos típicamente parecería\n\n /var/mobile/Applications//Documents/path/to/file (iOS)\n /storage/emulated/0/path/to/file (Android)\n \n\nEstas rutas también fueron devueltos por el método `toURL()` de los objetos de `entrada`.\n\nCon v1.0.0, el atributo `fullPath` es la ruta del archivo, *relativo a la raíz del sistema de archivos HTML*. Así, los caminos más arriba sería ahora ambos ser representado por un objeto `FileEntry` con un `fullPath` de\n\n /path/to/file\n \n\nSi su aplicación funciona con dispositivo-absoluto-caminos, y previamente obtenido esos caminos a través de la propiedad `fullPath` de objetos de `Entry`, deberá actualizar el código para utilizar `entry.toURL()` en su lugar.\n\nPara atrás compatibilidad, el método `resolveLocalFileSystemURL()` a aceptar un dispositivo-absoluto-trayectoria y devolverá un objeto de `Entry` correspondiente que, mientras exista ese archivo dentro de los sistemas de ficheros `TEMPORARY` o la `PERSISTENT`.\n\nEsto ha sido particularmente un problema con el plugin de transferencia de archivos, que anteriormente utilizado dispositivo-absoluto-caminos (y todavía puede aceptarlas). Ha sido actualizado para funcionar correctamente con sistema de ficheros URLs, para reemplazar `entry.fullPath` con `entry.toURL()` debe resolver cualquier problema conseguir ese plugin para trabajar con archivos en el dispositivo.\n\nEn v1.1.0 el valor devuelto por `toURL()` fue cambiado (consulte \\[CB-6394\\] (https://issues.apache.org/jira/browse/CB-6394)) para devolver una dirección URL absoluta 'file://'. siempre que sea posible. Para asegurar una ' cdvfile:'-URL ahora puede utilizar `toInternalURL()`. Este método devolverá ahora filesystem URLs de la forma\n\n cdvfile://localhost/persistent/path/to/file\n \n\nque puede utilizarse para identificar el archivo únicamente.\n\n## Lista de códigos de Error y significados\n\nCuando se produce un error, uno de los siguientes códigos se utilizará.\n\n| Código | Constante |\n| ------:|:----------------------------- |\n| 1 | `NOT_FOUND_ERR` |\n| 2 | `SECURITY_ERR` |\n| 3 | `ABORT_ERR` |\n| 4 | `NOT_READABLE_ERR` |\n| 5 | `ENCODING_ERR` |\n| 6 | `NO_MODIFICATION_ALLOWED_ERR` |\n| 7 | `INVALID_STATE_ERR` |\n| 8 | `SYNTAX_ERR` |\n| 9 | `INVALID_MODIFICATION_ERR` |\n| 10 | `QUOTA_EXCEEDED_ERR` |\n| 11 | `TYPE_MISMATCH_ERR` |\n| 12 | `PATH_EXISTS_ERR` |\n\n## Configurando el Plugin (opcional)\n\nEl conjunto de los sistemas de ficheros disponibles puede ser configurado por plataforma. Tanto iOS y Android reconocen un etiqueta en el `archivo config.xml` que nombra a los sistemas de archivos para ser instalado. De forma predeterminada, se activan todas las raíces del sistema de archivos.\n\n \n \n \n\n### Android\n\n * `files`: directorio de almacenamiento de archivo interno de la aplicación\n * `files-external`: directorio de almacenamiento de archivo externo de la aplicación\n * `sdcard`: el directorio de almacenamiento de archivo externo global (esta es la raíz de la tarjeta SD, si uno está instalado). Debe tener el permiso de `android.permission.WRITE_EXTERNAL_STORAGE` a usar esto.\n * `cache`: directorio de memoria caché interna de la aplicación\n * `cache-external`: directorio de caché externo de la aplicación\n * `root`: el sistema de archivos de todo el dispositivo\n\nAndroid también es compatible con un sistema de archivos especial llamado \"documents\", que representa un subdirectorio \"/Documents/\" dentro del sistema de archivos \"archivos\".\n\n### iOS\n\n * `library`: directorio de bibliotecas de la aplicación\n * `documents`: directorio de documentos de la aplicación\n * `cache`: directorio de caché de la aplicación\n * `bundle`: paquete de la aplicación; la ubicación de la aplicación en sí mismo en el disco (sólo lectura)\n * `root`: el sistema de archivos de todo el dispositivo\n\nDe forma predeterminada, los directorios de documentos y la biblioteca pueden ser sincronizados con iCloud. También puede solicitar dos sistemas adicionales, `library-nosync` y `documents-nosync`, que representan un directorio especial no sincronizados dentro de la `/Library` o sistema de ficheros `/Documents`."
},
{
"path": "plugins/cordova-plugin-file/doc/es/index.md",
"content": "\n\n# cordova-plugin-file\n\nEste plugin implementa una API de archivo que permite acceso de lectura/escritura a los archivos que residen en el dispositivo.\n\nEste plugin se basa en varias especificaciones, incluyendo: el HTML5 archivo API \n\nLos directorios (ahora extinto) y sistema de extensiones más recientes: aunque la mayor parte del código del plugin fue escrito cuando una especificación anterior era actual: \n\nTambién implementa la especificación de FileWriter: \n\nPara el uso, por favor, consulte 'HTML5 Rocks excelente [FileSystem artículo.][1]\n\n [1]: http://www.html5rocks.com/en/tutorials/file/filesystem/\n\nPara tener una visión general de otras opciones de almacenamiento, consulte [Guía de almacenamiento Cordova][2].\n\n [2]: http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html\n\nEste plugin define global `cordova.file` objeto.\n\nAunque en el ámbito global, no estará disponible hasta después de la `deviceready` evento.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(cordova.file);\n }\n \n\n## Instalación\n\n cordova plugin add cordova-plugin-file\n \n\n## Plataformas soportadas\n\n* Amazon fire OS\n* Android\n* BlackBerry 10\n* Firefox OS\n* iOS\n* Windows Phone 7 y 8 *\n* Windows 8 *\n* Explorador\n\n* *No son compatibles con estas plataformas `FileReader.readAsArrayBuffer` ni `FileWriter.write(blob)` .*\n\n## Donde almacenar los archivos\n\nA partir de v1.2.0, URLs a directorios de sistema de archivos importantes son proporcionadas. Cada dirección URL está en la forma *file:///path/to/spot/*y se puede convertir en un `DirectoryEntry` usando`window.resolveLocalFileSystemURL()`.\n\n* `cordova.file.applicationDirectory`-Directorio Read-only donde está instalada la aplicación. (*iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.applicationStorageDirectory`-Directorio del entorno limitado de la aplicación; en iOS esta ubicación es de sólo lectura (pero subdirectorios específicos [como `/Documents` ] son de lectura y escritura). Todos los datos contenidos dentro es privado para la aplicación. ( *iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.dataDirectory`-Almacenamiento de datos persistente y privadas dentro de entorno limitado de la aplicación utilizando la memoria interna (en Android, si necesitas usar memoria externa, use `.externalDataDirectory` ). En iOS, este directorio no está sincronizado con iCloud (utilice `.syncedDataDirectory` ). (*iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.cacheDirectory`-Directorio para los archivos de datos almacenados en caché o los archivos que su aplicación puede volver a crear fácilmente. El sistema operativo puede borrar estos archivos cuando el dispositivo se agota en almacenamiento de información, sin embargo, aplicaciones no deben confiar en el sistema operativo para eliminar los archivos de aquí. (*iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.externalApplicationStorageDirectory`-Espacio aplicación de almacenamiento externo. (*Android*)\n\n* `cordova.file.externalDataDirectory`¿Dónde poner los archivos de datos específicos de la aplicación de almacenamiento externo. (*Android*)\n\n* `cordova.file.externalCacheDirectory`-Caché aplicación de almacenamiento externo. (*Android*)\n\n* `cordova.file.externalRootDirectory`-Raíz de almacenamiento externo (tarjeta SD). (*Android*, *BlackBerry 10*)\n\n* `cordova.file.tempDirectory`-Directorio temporal que puede borrar el sistema operativo en sí. No confíe en el sistema operativo para borrar este directorio; su aplicación siempre debe eliminar archivos según corresponda. (*iOS*)\n\n* `cordova.file.syncedDataDirectory`-Contiene los archivos de la aplicación específica que deben ser sincronizados (e.g. a iCloud). (*iOS*)\n\n* `cordova.file.documentsDirectory`-Archivos privados a la aplicación, pero que son significativos para otra aplicación (por ejemplo archivos de Office). (*iOS*)\n\n* `cordova.file.sharedDirectory`-Archivos disponibles globalmente para todas las aplicaciones (*BlackBerry 10*)\n\n## Diseños de sistema de archivo\n\nAunque técnicamente un detalle de la implementación, puede ser muy útil saber cómo la `cordova.file.*` mapa de propiedades en trazados físicos en un dispositivo real.\n\n### iOS diseño de sistema de archivo\n\n| Ruta de dispositivo | `Cordova.file.*` | `iosExtraFileSystems` | ¿r/w? | ¿persistente? | OS despeja | sincronización | privado |\n|:-------------------------------------------- |:--------------------------- |:--------------------- |:-----:|:-------------:|:----------:|:--------------:|:-------:|\n| `/ var/mobile/Applications/< UUID > /` | applicationStorageDirectory | - | r | N / A | N / A | N / A | Sí |\n| `appname.app/` | applicationDirectory | Bundle | r | N / A | N / A | N / A | Sí |\n| `www/` | - | - | r | N / A | N / A | N / A | Sí |\n| `Documents/` | documentsDirectory | documentos | r/w | Sí | No | Sí | Sí |\n| `NoCloud/` | - | documentos-nosync | r/w | Sí | No | No | Sí |\n| `Library` | - | Biblioteca | r/w | Sí | No | ¿Sí? | Sí |\n| `NoCloud/` | dataDirectory | Biblioteca-nosync | r/w | Sí | No | No | Sí |\n| `Cloud/` | syncedDataDirectory | - | r/w | Sí | No | Sí | Sí |\n| `Caches/` | cacheDirectory | caché | r/w | Sí * | Si * * *| | No | Sí |\n| `tmp/` | tempDirectory | - | r/w | No * * | Si * * *| | No | Sí |\n\n* Archivos persisten a través de la aplicación se reinicia y actualizaciones, pero este directorio puede ser despejó cuando el OS desea. Su aplicación debe ser capaz de recrear cualquier contenido que puede ser eliminado.\n\n* * Archivos pueden persistir a través de la aplicación se reinicia, pero no confiar en este comportamiento. Los archivos no se garantizan que persisten a través de actualizaciones. Su aplicación debe eliminar los archivos de este directorio cuando es aplicable, como el sistema operativo no garantiza cuando (o incluso si) estos archivos se quitan.\n\n* * *| OS la puede borrar el contenido de este directorio cuando se siente que es necesario, pero no dependen de éste. Debe borrar este directorio según sea apropiado para su aplicación.\n\n### Disposición del sistema Android File\n\n| Ruta de dispositivo | `Cordova.file.*` | `AndroidExtraFileSystems` | ¿r/w? | ¿persistente? | OS despeja | privado |\n|:----------------------------------------- |:----------------------------------- |:------------------------- |:-----:|:-------------:|:----------:|:-------:|\n| `File:///android_asset/` | applicationDirectory | | r | N / A | N / A | Sí |\n| `/Data/data/< id de aplicación > /` | applicationStorageDirectory | - | r/w | N / A | N / A | Sí |\n| `cache` | cacheDirectory | caché | r/w | Sí | Sí * | Sí |\n| `files` | dataDirectory | archivos | r/w | Sí | No | Sí |\n| `Documents` | | documentos | r/w | Sí | No | Sí |\n| `< sdcard > /` | externalRootDirectory | sdcard | r/w | Sí | No | No |\n| `Android/data//` | externalApplicationStorageDirectory | - | r/w | Sí | No | No |\n| `cache` | externalCacheDirectry | caché-externo | r/w | Sí | No * * | No |\n| `files` | externalDataDirectory | archivos externos | r/w | Sí | No | No |\n\n* El sistema operativo puede eliminar periódicamente este directorio, pero no dependen de este comportamiento. Borrar el contenido de este directorio según sea apropiado para su aplicación. El contenido de este directorio debe un usuario purga la caché manualmente, se eliminan.\n\n* * El sistema operativo no borra este directorio automáticamente; Usted es responsable de administrar el contenido mismo. Deberá el usuario purga la caché manualmente, se extraen los contenidos del directorio.\n\n**Nota**: Si no se puede montar de almacenamiento externo, el `cordova.file.external*` Propiedades`null`.\n\n### Disposición del sistema blackBerry 10 archivo\n\n| Ruta de dispositivo | `Cordova.file.*` | ¿r/w? | ¿persistente? | OS despeja | privado |\n|:------------------------------------------------------------- |:--------------------------- |:-----:|:-------------:|:----------:|:-------:|\n| `File:///accounts/1000/AppData/ < id de aplicación > /` | applicationStorageDirectory | r | N / A | N / A | Sí |\n| `app/native` | applicationDirectory | r | N / A | N / A | Sí |\n| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | No | Sí | Sí |\n| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | Sí | No | Sí |\n| `File:///accounts/1000/Removable/sdcard` | externalRemovableDirectory | r/w | Sí | No | No |\n| `File:///accounts/1000/shared` | sharedDirectory | r/w | Sí | No | No |\n\n*Nota*: cuando se implementa la aplicación al trabajo de perímetro, todos los caminos son relativos a /accounts/1000-enterprise.\n\n## Rarezas Android\n\n### Ubicación de almacenamiento persistente Android\n\nHay múltiples ubicaciones válidas para almacenar archivos persistentes en un dispositivo Android. Vea [esta página][3] para una extensa discusión de las distintas posibilidades.\n\n [3]: http://developer.android.com/guide/topics/data/data-storage.html\n\nLas versiones anteriores del plugin elegiría la ubicación de los archivos temporales y persistentes en el arranque, basado en si el dispositivo afirmó que fue montado en la tarjeta SD (o partición de almacenamiento equivalente). Si fue montada en la tarjeta SD, o una partición de gran almacenamiento interno estaba disponible (como en dispositivos de Nexus,) y luego los archivos persistentes se almacenaría en la raíz de ese espacio. Esto significaba que todas las apps Cordova podían ver todos los archivos disponibles en la tarjeta.\n\nSi la tarjeta SD no estaba disponible, entonces versiones anteriores podría almacenar datos debajo de `/data/data/` , que aísla las apps del otro, pero puede todavía causa datos para ser compartido entre los usuarios.\n\nAhora es posible elegir si desea almacenar archivos en la ubicación de almacenamiento del archivo interno, o usando la lógica anterior, con una preferencia en de la aplicación `config.xml` archivo. Para ello, añada una de estas dos líneas a `config.xml` :\n\n < nombre de preferencia = \"AndroidPersistentFileLocation\" value = \"Internal\" / >< nombre de preferencia = \"AndroidPersistentFileLocation\" value = \"Compatibilidad\" / >\n \n\nSin esta línea, se utilizará el archivo plugin `Compatibility` como valor predeterminado. Si una etiqueta de preferencia está presente y no es uno de estos valores, no se iniciará la aplicación.\n\nSi su solicitud se ha enviado previamente a los usuarios, usando un mayor (1.0 pre) versión de este plugin y archivos almacenados en el sistema de ficheros persistente, entonces debería establecer la preferencia en `Compatibility` . Cambiar la ubicación para \"Internal\" significa que los usuarios existentes que actualización su aplicación pueden ser incapaces de acceder a sus archivos previamente almacenadas, dependiendo de su dispositivo.\n\nSi su solicitud es nuevo, o nunca antes ha almacenado archivos en el sistema de ficheros persistente, entonces el `Internal` generalmente se recomienda el ajuste.\n\n## iOS rarezas\n\n* `cordova.file.applicationStorageDirectory`es de sólo lectura; intentar almacenar archivos en el directorio raíz fallará. Utilice uno de los `cordova.file.*` las propiedades definidas para iOS (sólo `applicationDirectory` y `applicationStorageDirectory` son de sólo lectura).\n* `FileReader.readAsText(blob, encoding)` \n * El `encoding` no se admite el parámetro, y codificación UTF-8 es siempre en efecto.\n\n### iOS ubicación de almacenamiento persistente\n\nHay dos ubicaciones válidas para almacenar archivos persistentes en un dispositivo iOS: el directorio de documentos y el directorio de biblioteca. Las versiones anteriores del plugin sólo almacenan archivos persistentes en el directorio de documentos. Esto tenía el efecto secundario de todos los archivos de la aplicación haciendo visible en iTunes, que era a menudo involuntarios, especialmente para aplicaciones que manejan gran cantidad de archivos pequeños, en lugar de producir documentos completos para la exportación, que es la finalidad del directorio.\n\nAhora es posible elegir si desea almacenar archivos en los documentos o directorio de bibliotecas, con preferencia en de la aplicación `config.xml` archivo. Para ello, añada una de estas dos líneas a `config.xml` :\n\n \n \n \n \n\nSin esta línea, se utilizará el archivo plugin `Compatibility` como valor predeterminado. Si una etiqueta de preferencia está presente y no es uno de estos valores, no se iniciará la aplicación.\n\nSi su solicitud se ha enviado previamente a los usuarios, usando un mayor (1.0 pre) versión de este plugin y archivos almacenados en el sistema de ficheros persistente, entonces debería establecer la preferencia en `Compatibility` . Cambiar la ubicación de `Library` significa que los usuarios existentes que actualización su aplicación sería incapaces de acceder a sus archivos previamente almacenadas.\n\nSi su solicitud es nuevo, o nunca antes ha almacenado archivos en el sistema de ficheros persistente, entonces el `Library` generalmente se recomienda el ajuste.\n\n## Firefox OS rarezas\n\nLa API de sistema de archivo de forma nativa no es compatible con Firefox OS y se implementa como una cuña en la parte superior indexedDB.\n\n* No falla cuando eliminar directorios no vacía\n* No admite metadatos para directorios\n* Los métodos `copyTo` y `moveTo` no son compatibles con directorios\n\nSe admiten las siguientes rutas de datos: * `applicationDirectory` -usa `xhr` para obtener los archivos locales que están envasados con la aplicación. * `dataDirectory` - Para archivos de datos específicos de aplicación persistente. * `cacheDirectory` -En caché archivos que deben sobrevivir se reinicia la aplicación (aplicaciones no deben confiar en el sistema operativo para eliminar archivos aquí).\n\n## Navegador rarezas\n\n### Rarezas y observaciones comunes\n\n* Cada navegador utiliza su propio sistema de ficheros un espacio aislado. IE y Firefox utilizan IndexedDB como base. Todos los navegadores utilizan diagonal como separador de directorio en un camino.\n* Las entradas de directorio deben crearse sucesivamente. Por ejemplo, la llamada `fs.root.getDirectory (' dir1/dir2 ', {create:true}, successCallback, errorCallback)` se producirá un error si no existiera dir1.\n* El plugin solicita permiso de usuario para usar almacenamiento persistente en el primer comienzo de la aplicación. \n* Plugin soporta `cdvfile://localhost` (recursos locales) solamente. Es decir, no se admiten los recursos externos vía `cdvfile`.\n* El plugin no sigue [\"Archivo sistema API 8.3 nombrando restricciones\"][4].\n* BLOB y archivo ' `close` la función no es compatible.\n* `FileSaver` y `BlobBuilder` no son compatibles con este plugin y no tengo recibos.\n* El plugin no es compatible con `requestAllFileSystems`. Esta función también está desaparecida en las especificaciones.\n* No se quitarán las entradas de directorio Si utilizas `create: true` bandera de directorio existente.\n* No se admiten archivos creados mediante el constructor. Debe utilizar método entry.file en su lugar.\n* Cada navegador utiliza su propia forma de blob URL referencias.\n* se admite la función `readAsDataURL`, pero el mediatype en cromo depende de la extensión de nombre de entrada, mediatype en IE siempre está vacío (que es lo mismo como `plain-text` según la especificación), el mediatype en Firefox siempre es `application/octet-stream`. Por ejemplo, si el contenido es `abcdefg` entonces Firefox devuelve `datos: aplicación / octet-stream; base64, YWJjZGVmZw ==`, es decir devuelve `datos:; base64, YWJjZGVmZw ==`, cromo devuelve `datos: < mediatype dependiendo de la extensión de nombre de la entrada >; base64, YWJjZGVmZw ==`.\n* `toInternalURL` devuelve la ruta de la forma `file:///persistent/path/to/entry` (Firefox, IE). Cromo devuelve la ruta de acceso en el formulario `cdvfile://localhost/persistent/file`.\n\n [4]: http://www.w3.org/TR/2011/WD-file-system-api-20110419/#naming-restrictions\n\n### Rarezas de Chrome\n\n* Filesystem de Chrome no es inmediatamente después de evento ready dispositivo. Como solución temporal puede suscribirse al evento `filePluginIsReady`. Ejemplo: \n\n javascript\n window.addEventListener('filePluginIsReady', function(){ console.log('File plugin is ready');}, false);\n \n\nPuede utilizar la función `window.isFilePluginReadyRaised` para verificar si ya se provoca el evento. -window.requestFileSystem temporal y persistente filesystem cuotas no están limitadas en cromo. -Para aumentar el almacenamiento persistente en cromo necesitas llamar el método `window.initPersistentFileSystem`. Cuota de almacenamiento persistente es de 5 MB por defecto. -Chrome requiere `--permitir-archivo-acceso-de-archivos` ejecutar argumento al soporte API mediante protocolo `file:///`. -`Archivo` objeto no cambiará si utilizas bandera `{create:true}` cuando una `entrada` de existente. -eventos `cancelable` propiedad está establecida en true en cromo. Esto es contrario a la [Especificación][5]. -función de `toURL` en Chrome devuelve `filesystem:`-prefijo camino dependiendo de host de la aplicación. Por ejemplo, `filesystem:file:///persistent/somefile.txt`, `filesystem:http://localhost:8080/persistent/somefile.txt`. -resultado de la función de `toURL` no contiene barra en caso de entrada en el directorio. Cromo resuelve directorios con urls slash-siguió correctamente sin embargo. -método `resolveLocalFileSystemURL` requiere la entrantes `url` que tienen prefijo `filesystem`. Por ejemplo, el parámetro de `url` para `resolveLocalFileSystemURL` debería estar en la forma `filesystem:file:///persistent/somefile.txt` en comparación con la forma `file:///persistent/somefile.txt` en Android. -Obsoleto `toNativeURL` función no es compatible y no tiene un trozo. -función de `setMetadata` no es indicada en las especificaciones y no admite. -INVALID_MODIFICATION_ERR (código: 9) se lanza en lugar de SYNTAX_ERR(code: 8) a petición de un sistema de ficheros inexistentes. -INVALID_MODIFICATION_ERR (código: 9) se lanza en vez de PATH_EXISTS_ERR(code: 12) en intentar exclusivamente crear un archivo o directorio, que ya existe. -INVALID_MODIFICATION_ERR (código: 9) se lanza en lugar de NO_MODIFICATION_ALLOWED_ERR(code: 6) para tratar de llamar a removeRecursively en el sistema de archivos raíz. -INVALID_MODIFICATION_ERR (código: 9) se lanza en vez de NOT_FOUND_ERR(code: 1) en tratar de moveTo directorio que no existe.\n\n [5]: http://dev.w3.org/2009/dap/file-system/file-writer.html\n\n### Impl base IndexedDB rarezas (IE y Firefox)\n\n* `.` y `..` no son compatibles.\n* IE no soporta `file:///`-modo; modo alojado sólo es compatible (http://localhost:xxxx).\n* Tamaño del sistema de archivos de Firefox no es limitada pero cada extensión de 50 MB solicitará un permiso de usuario. IE10 permite hasta 10mb de combinados AppCache y IndexedDB utilizados en la implementación del sistema de ficheros sin preguntar, cuando llegas a ese nivel que se le preguntará si desea permitir que ser aumentada hasta un máximo de 250 mb por sitio. Para que `size` parámetro para la función `requestFileSystem` no afecta sistema de ficheros en Firefox y IE.\n* la función `readAsBinaryString` no se indica en las especificaciones y no compatible con IE y no tiene un trozo.\n* `file.type` siempre es null.\n* No debe crear entrada utilizando DirectoryEntry resultado de devolución de llamada de instancia que fue borrado. De lo contrario, obtendrá una entrada' colgar'.\n* Antes de que se puede leer un archivo, el cual fue escrito sólo que necesitas una nueva instancia de este archivo.\n* la función `setMetadata`, que no es indicada en las especificaciones soporta sólo el cambio de campo `modificationTime`. \n* `copyTo` y `moveTo` funciones no son compatibles con directorios.\n* Metadatos de directorios no es compatible.\n* Tanto Entry.remove y directoryEntry.removeRecursively no fallan al retirar no vacía directorios - directorios de ser eliminados se limpian junto con contenido en su lugar.\n* `abort` y `truncate` las funciones no son compatibles.\n* eventos de progreso no están despedidos. Por ejemplo, este controlador no ejecutará:\n\n javascript\n writer.onprogress = function() { /*commands*/ };\n \n\n## Actualización de notas\n\nEn v1.0.0 de este plugin, han cambiado las estructuras `FileEntry` y `DirectoryEntry`, para estar más acorde con las especificaciones publicadas.\n\nVersiones anteriores (pre-1.0.0) del plugin almacenan el dispositivo-absoluto-archivo-ubicación en la propiedad `fullPath` de objetos de `entrada`. Estos caminos típicamente parecería\n\n /var/mobile/Applications//Documents/path/to/file (iOS)\n /storage/emulated/0/path/to/file (Android)\n \n\nEstas rutas también fueron devueltos por el método `toURL()` de los objetos de `entrada`.\n\nCon v1.0.0, el atributo `fullPath` es la ruta del archivo, *relativo a la raíz del sistema de archivos HTML*. Así, los caminos más arriba sería ahora ambos ser representado por un objeto `FileEntry` con un `fullPath` de\n\n /path/to/file\n \n\nSi su aplicación funciona con dispositivo-absoluto-caminos, y previamente obtenido esos caminos a través de la propiedad `fullPath` de objetos de `Entry`, deberá actualizar el código para utilizar `entry.toURL()` en su lugar.\n\nPara atrás compatibilidad, el método `resolveLocalFileSystemURL()` a aceptar un dispositivo-absoluto-trayectoria y devolverá un objeto de `Entry` correspondiente que, mientras exista ese archivo dentro de los sistemas de ficheros `TEMPORARY` o la `PERSISTENT`.\n\nEsto ha sido particularmente un problema con el plugin de transferencia de archivos, que anteriormente utilizado dispositivo-absoluto-caminos (y todavía puede aceptarlas). Ha sido actualizado para funcionar correctamente con sistema de ficheros URLs, para reemplazar `entry.fullPath` con `entry.toURL()` debe resolver cualquier problema conseguir ese plugin para trabajar con archivos en el dispositivo.\n\nEn v1.1.0 el valor devuelto por `toURL()` fue cambiado (consulte \\[CB-6394\\] (https://issues.apache.org/jira/browse/CB-6394)) para devolver una dirección URL absoluta 'file://'. siempre que sea posible. Para asegurar una ' cdvfile:'-URL ahora puede utilizar `toInternalURL()`. Este método devolverá ahora filesystem URLs de la forma\n\n cdvfile://localhost/persistent/path/to/file\n \n\nque puede utilizarse para identificar el archivo únicamente.\n\n## Lista de códigos de Error y significados\n\nCuando se produce un error, uno de los siguientes códigos se utilizará.\n\n| Código | Constante |\n| ------:|:----------------------------- |\n| 1 | `NOT_FOUND_ERR` |\n| 2 | `SECURITY_ERR` |\n| 3 | `ABORT_ERR` |\n| 4 | `NOT_READABLE_ERR` |\n| 5 | `ENCODING_ERR` |\n| 6 | `NO_MODIFICATION_ALLOWED_ERR` |\n| 7 | `INVALID_STATE_ERR` |\n| 8 | `SYNTAX_ERR` |\n| 9 | `INVALID_MODIFICATION_ERR` |\n| 10 | `QUOTA_EXCEEDED_ERR` |\n| 11 | `TYPE_MISMATCH_ERR` |\n| 12 | `PATH_EXISTS_ERR` |\n\n## Configurando el Plugin (opcional)\n\nEl conjunto de los sistemas de ficheros disponibles puede ser configurado por plataforma. Tanto iOS y Android reconocen un etiqueta en el `archivo config.xml` que nombra a los sistemas de archivos para ser instalado. De forma predeterminada, se activan todas las raíces del sistema de archivos.\n\n \n \n \n\n### Android\n\n* `files`: directorio de almacenamiento de archivo interno de la aplicación\n* `files-external`: directorio de almacenamiento de archivo externo de la aplicación\n* `sdcard`: el directorio de almacenamiento de archivo externo global (esta es la raíz de la tarjeta SD, si uno está instalado). Debe tener el permiso de `android.permission.WRITE_EXTERNAL_STORAGE` a usar esto.\n* `cache`: directorio de memoria caché interna de la aplicación\n* `cache-external`: directorio de caché externo de la aplicación\n* `root`: el sistema de archivos de todo el dispositivo\n\nAndroid también es compatible con un sistema de archivos especial llamado \"documents\", que representa un subdirectorio \"/Documents/\" dentro del sistema de archivos \"archivos\".\n\n### iOS\n\n* `library`: directorio de bibliotecas de la aplicación\n* `documents`: directorio de documentos de la aplicación\n* `cache`: directorio de caché de la aplicación\n* `bundle`: paquete de la aplicación; la ubicación de la aplicación en sí mismo en el disco (sólo lectura)\n* `root`: el sistema de archivos de todo el dispositivo\n\nDe forma predeterminada, los directorios de documentos y la biblioteca pueden ser sincronizados con iCloud. También puede solicitar dos sistemas adicionales, `library-nosync` y `documents-nosync`, que representan un directorio especial no sincronizados dentro de la `/Library` o sistema de ficheros `/Documents`.\n"
},
{
"path": "plugins/cordova-plugin-file/doc/es/plugins.md",
"content": "\n\n# Notas para los desarrolladores del plugin\n\nEstas notas están pensadas principalmente para desarrolladores de Android y el iOS que quieran escribir plugins que interfaz con el sistema de ficheros usando el plugin del archivo.\n\n## Trabajar con URLs de sistema de archivo de Córdoba\n\nDesde la versión 1.0.0, este plugin ha utilizado las direcciones URL con un `cdvfile` plan para todas las comunicaciones sobre el puente, en lugar de exponer rutas de sistema de archivos de dispositivos raw para JavaScript.\n\nEn el lado de JavaScript, esto significa que los objetos FileEntry y DirectoryEntry tienen un atributo fullPath que es relativo a la raíz del sistema de archivos HTML. Si JavaScript API de tu plugin acepta un objeto FileEntry o DirectoryEntry, usted debe llamar a `.toURL()` en ese objeto antes de pasar a través del puente al código nativo.\n\n### Conversión de cdvfile: / / URL al fileystem caminos\n\nPlugins que necesita escribir en el sistema de archivos puede convertir un archivo recibido sistema URL a una ubicación de sistema de archivos real. Hay varias formas de hacerlo, dependiendo de la plataforma nativa.\n\nEs importante recordar que no todos `cdvfile://` las direcciones URL son asignables a reales archivos en el dispositivo. Algunas URLs pueden referirse a activos en dispositivos que no están representadas por archivos, o incluso pueden hacer referencia a recursos remotos. Debido a estas posibilidades, plugins siempre debe comprobar si consiguen un resultado significativo cuando tratando de convertir las URL en trazados.\n\n#### Android\n\nEn Android, el método más simple para convertir un `cdvfile://` URL a una ruta de sistema de archivos es utilizar `org.apache.cordova.CordovaResourceApi` . `CordovaResourceApi`tiene varios métodos que pueden manejar `cdvfile://` URL:\n\n webView es un miembro de la clase Plugin CordovaResourceApi resourceApi = webView.getResourceApi();\n \n Obtener una URL file:/// representando este archivo en el dispositivo, / / o el mismo URL sin cambios si no se puede asignar a un archivo Uri fileURL = resourceApi.remapUri(Uri.parse(cdvfileURL));\n \n\nTambién es posible utilizar el plugin de archivos directamente:\n\n Import org.apache.cordova.file.FileUtils;\n Import org.apache.cordova.file.FileSystem;\n Import java.net.MalformedURLException;\n \n Obtener el archivo plugin desde el administrador de plugin FileUtils filePlugin = (FileUtils)webView.pluginManager.getPlugin(\"File\");\n \n Dada una URL, haz un camino para tratar de {camino de cadena = filePlugin.filesystemPathForURL(cdvfileURL);} catch (DD e) {/ / el sistema de archivos url no reconocida}\n \n\nPara convertir de una ruta a un `cdvfile://` URL:\n\n Import org.apache.cordova.file.LocalFilesystemURL;\n \n Obtener un objeto LocalFilesystemURL para una ruta, / / o null si no se puede representar como una dirección URL cdvfile.\n LocalFilesystemURL url = filePlugin.filesystemURLforLocalPath(path);\n Obtener la representación string de la URL objeto String cdvfileURL = url.toString();\n \n\nSi tu plugin crea un archivo y desea devolver un objeto FileEntry para él, usar el plugin de archivos:\n\n Devolver una estructura JSON adecuado para volver a JavaScript, / / o null si este archivo no es representable como una dirección URL cdvfile.\n JSONObject entrada = filePlugin.getEntryForFile(file);\n \n\n#### iOS\n\nCordova en iOS no utiliza la misma `CordovaResourceApi` concepto como Android. En iOS, debe usar el archivo plugin para convertir las direcciones URL y rutas de sistema de archivos.\n\n Obtener un objeto URL CDVFilesystem de una URL string CDVFilesystemURL * url = [CDVFilesystemURL fileSystemURLWithString:cdvfileURL];\n Obtener una ruta de acceso para el objeto URL, o nil si no puede ser asignado a una ruta de archivo NSString * = [filePlugin filesystemPathForURL:url];\n \n \n Obtener un objeto URL CDVFilesystem para una ruta, o / / nula si no se puede representar como una dirección URL cdvfile.\n CDVFilesystemURL * url = [filePlugin fileSystemURLforLocalPath:path];\n Obtener la representación string de la URL objetos NSString * cdvfileURL = [enlace absoluteString];\n \n\nSi tu plugin crea un archivo y desea devolver un objeto FileEntry para él, usar el plugin de archivos:\n\n Obtener un objeto URL CDVFilesystem para una ruta, o / / nula si no se puede representar como una dirección URL cdvfile.\n CDVFilesystemURL * url = [filePlugin fileSystemURLforLocalPath:path];\n Conseguir una estructura para volver a JavaScript NSDictionary * entrada = [filePlugin makeEntryForLocalURL:url]\n \n\n#### JavaScript\n\nEn JavaScript, para obtener un `cdvfile://` dirección URL de un objeto FileEntry o DirectoryEntry, simplemente llame al `.toURL()` en él:\n\n var cdvfileURL = entry.toURL();\n \n\nEn manipuladores de la respuesta del plugin, para convertir de una estructura FileEntry devuelta a un objeto real de la entrada, su código de controlador debe importar el archivo plugin y crear un nuevo objeto:\n\n crear apropiado objeto var ingreso;\n Si (entryStruct.isDirectory) {entrada = new DirectoryEntry (entryStruct.name, entryStruct.fullPath, FileSystem(entryStruct.filesystemName)) nuevo;} else {entrada = nuevo FileEntry (entryStruct.name, entryStruct.fullPath, nuevo FileSystem(entryStruct.filesystemName));}"
},
{
"path": "plugins/cordova-plugin-file/doc/fr/README.md",
"content": "\n\n# cordova-plugin-file\n\n[](https://travis-ci.org/apache/cordova-plugin-file)\n\nCe plugin implémente une API de fichier permettant l'accès en lecture/écriture aux fichiers qui résident sur le périphérique.\n\nCe plugin est basé sur plusieurs spécifications, y compris : l'API de fichier HTML5 \n\nLes répertoires (aujourd'hui disparue) et le système des extensions plus récentes : bien que la plupart du code du plugin a été écrit quand une technique antérieure était en vigueur : \n\nIl met également en œuvre la spécification FileWriter : \n\nPour son utilisation, veuillez vous reporter au HTML5 Rocks' excellent [article de système de fichiers.](http://www.html5rocks.com/en/tutorials/file/filesystem/)\n\nPour un aperçu des autres options de stockage, consultez [guide d'entreposage de Cordova](http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html).\n\nCe plugin définit global `cordova.file` objet.\n\nBien que dans la portée globale, il n'est pas disponible jusqu'après la `deviceready` événement.\n\n document.addEventListener (« deviceready », onDeviceReady, false) ;\n function onDeviceReady() {console.log(cordova.file);}\n \n\n## Installation\n\n cordova plugin add cordova-plugin-file\n \n\n## Plates-formes supportées\n\n * Amazon Fire OS\n * Android\n * BlackBerry 10\n * Firefox OS\n * iOS\n * Windows Phone 7 et 8 *\n * Windows 8 *\n * Windows*\n * Navigateur\n\n\\* *These platforms do not support `FileReader.readAsArrayBuffer` nor `FileWriter.write(blob)`.*\n\n## Emplacement de stockage des fichiers\n\nÀ partir de v1.2.0, URL vers des répertoires de système de fichiers importants est fournis. Chaque URL est dans la forme *file:///path/to/spot/*et peut être converti en un `DirectoryEntry` à l'aide`window.resolveLocalFileSystemURL()`.\n\n * `cordova.file.applicationDirectory`-Lecture seule répertoire où l'application est installée. (*iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.applicationStorageDirectory`-Répertoire racine du bac à sable de l'application ; cet endroit est en lecture seule sur iOS (mais les sous-répertoires spécifiques [comme `/Documents` ] sont en lecture / écriture). Toutes les données qu'il contient est privé de l'application. ( *iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.dataDirectory`-Stockage des données persistants et privés au sein de bac à sable de l'application à l'aide de la mémoire interne (sur Android, si vous avez besoin d'utiliser une mémoire externe, utilisez `.externalDataDirectory` ). Sur iOS, ce répertoire n'est pas synchronisé avec iCloud (utiliser `.syncedDataDirectory` ). (*iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.cacheDirectory`-Répertoire pour les fichiers de données en mémoire cache ou les fichiers que votre application peut recréer facilement. L'OS peut supprimer ces fichiers lorsque l'appareil faiblit sur stockage, néanmoins, les applications ne doivent pas compter sur l'OS pour supprimer les fichiers ici. (*iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.externalApplicationStorageDirectory`-Espace l'application sur le stockage externe. (*Android*)\n\n * `cordova.file.externalDataDirectory`-Où placer les fichiers de données d'application spécifiques sur le stockage externe. (*Android*)\n\n * `cordova.file.externalCacheDirectory`-Cache de l'application sur le stockage externe. (*Android*)\n\n * `cordova.file.externalRootDirectory`-Racine de stockage externe (carte SD). (*Android*, *BlackBerry 10*)\n\n * `cordova.file.tempDirectory`-Répertoire temp que l'OS peut effacer à volonté. Ne comptez pas sur l'OS pour effacer ce répertoire ; votre application doit toujours supprimer les fichiers selon le cas. (*iOS*)\n\n * `cordova.file.syncedDataDirectory`-Contient des fichiers d'app spécifique qui doivent se synchroniser (par exemple à iCloud). (*iOS*)\n\n * `cordova.file.documentsDirectory`-Fichiers privés à l'app, mais qui sont significatives pour l'autre application (par exemple les fichiers Office). (*iOS*)\n\n * `cordova.file.sharedDirectory`-Fichiers disponibles globalement à toutes les applications (*BlackBerry 10*)\n\n## Structures de système de fichiers\n\nBien que techniquement un détail d'implémentation, il peut être très utile de savoir comment les `cordova.file.*` carte de propriétés à des chemins d'accès physiques sur un périphérique réel.\n\n### iOS agencement de système de fichier\n\n| Chemin de l'unité | `Cordova.file.*` | `iosExtraFileSystems` | r/w ? | persistants ? | OS efface | Sync | privé |\n|:---------------------------------------------- |:--------------------------- |:--------------------- |:-----:|:-------------:|:-------------:|:-----:|:-----:|\n| `/ var/mobile/Applications/< UUID > /` | applicationStorageDirectory | - | r | N/A | N/A | N/A | Oui |\n| `appname.app/` | applicationDirectory | Bundle | r | N/A | N/A | N/A | Oui |\n| `www/` | - | - | r | N/A | N/A | N/A | Oui |\n| `Documents/` | documentsDirectory | documents | r/w | Oui | Non | Oui | Oui |\n| `NoCloud/` | - | documents-nosync | r/w | Oui | Non | Non | Oui |\n| `Library` | - | Bibliothèque | r/w | Oui | Non | Oui ? | Oui |\n| `NoCloud/` | dataDirectory | Bibliothèque-nosync | r/w | Oui | Non | Non | Oui |\n| `Cloud/` | syncedDataDirectory | - | r/w | Oui | Non | Oui | Oui |\n| `Caches/` | cacheDirectory | cache | r/w | Oui * | Oui**\\* | Non | Oui |\n| `tmp/` | tempDirectory | - | r/w | Non** | Oui**\\* | Non | Oui |\n\n\\ * Fichiers persistent à travers l'application redémarre et mises à niveau, mais ce répertoire peut être effacé à chaque fois que le système d'exploitation désire. Votre application doit être en mesure de recréer tout contenu qui pourrait être supprimé.\n\n** Fichiers peuvent persister redémarrages de l'application, mais ne vous fiez pas ce comportement. Les fichiers ne sont pas garantis à persister dans l'ensemble de mises à jour. Votre application doit supprimer les fichiers de ce répertoire lorsqu'elle s'applique, comme le système d'exploitation ne garantit pas quand (ou même si) ces fichiers sont supprimés.\n\n**\\ * Le système d'exploitation peut effacer le contenu de ce répertoire chaque fois qu'il se sent il est nécessaire, mais ne comptez pas là-dessus. Vous devez supprimer ce répertoire comme approprié pour votre application.\n\n### Agencement de système de fichiers Android\n\n| Chemin de l'unité | `Cordova.file.*` | `AndroidExtraFileSystems` | r/w ? | persistants ? | OS efface | privé |\n|:------------------------------------------------ |:----------------------------------- |:------------------------- |:-----:|:-------------:|:---------:|:-----:|\n| `file:///android_asset/` | applicationDirectory | | r | N/A | N/A | Oui |\n| `/ données/data/app < id > /` | applicationStorageDirectory | - | r/w | N/A | N/A | Oui |\n| `cache` | cacheDirectory | cache | r/w | Oui | Oui\\ * | Oui |\n| `files` | dataDirectory | fichiers | r/w | Oui | Non | Oui |\n| `Documents` | | documents | r/w | Oui | Non | Oui |\n| `< sdcard > /` | externalRootDirectory | sdcard | r/w | Oui | Non | Non |\n| `Android/data//` | externalApplicationStorageDirectory | - | r/w | Oui | Non | Non |\n| `cache` | externalCacheDirectry | cache-externe | r/w | Oui | Non** | Non |\n| `files` | externalDataDirectory | fichiers externes | r/w | Oui | Non | Non |\n\n\\ * L'OS peut effacer périodiquement ce répertoire, mais ne vous fiez pas ce comportement. Effacer le contenu de ce répertoire comme approprié pour votre application. Un utilisateur doit purger le cache manuellement, le contenu de ce répertoire est supprimé.\n\n** Le système d'exploitation n'efface pas ce répertoire automatiquement ; vous êtes chargé de gérer le contenu vous-même. L'utilisateur devrait purger le cache manuellement, le contenu du répertoire est supprimé.\n\n**Remarque**: si le stockage externe ne peut pas être monté, les `cordova.file.external*` sont des propriétés`null`.\n\n### Configuration du système blackBerry 10 fichier\n\n| Chemin de l'unité | `Cordova.file.*` | r/w ? | persistants ? | OS efface | privé |\n|:----------------------------------------------------------- |:--------------------------- |:-----:|:-------------:|:---------:|:-----:|\n| `file:///Accounts/1000/AppData/ < id app > /` | applicationStorageDirectory | r | N/A | N/A | Oui |\n| `app/native` | applicationDirectory | r | N/A | N/A | Oui |\n| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | Non | Oui | Oui |\n| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | Oui | Non | Oui |\n| `file:///Accounts/1000/Removable/sdcard` | externalRemovableDirectory | r/w | Oui | Non | Non |\n| `file:///Accounts/1000/Shared` | sharedDirectory | r/w | Oui | Non | Non |\n\n*Remarque*: lorsque l'application est déployée dans le périmètre de travail, tous les chemins sont par rapport à /accounts/1000-enterprise.\n\n## Quirks Android\n\n### Emplacement de stockage persistant Android\n\nIl y a plusieurs emplacements valides pour stocker des fichiers persistants sur un appareil Android. Voir [cette page](http://developer.android.com/guide/topics/data/data-storage.html) pour une analyse approfondie des diverses possibilités.\n\nLes versions précédentes du plugin choisirait l'emplacement des fichiers temporaires et persistantes au démarrage, basé sur la question de savoir si le dispositif réclamé que la carte SD (ou une partition de stockage équivalent) a été montée. Si la carte SD a été montée, ou si une partition de stockage interne importante était disponible (comme sur les appareils Nexus,) puis les fichiers persistants seraient stockés dans la racine de cet espace. Cela signifie que toutes les apps de Cordova pouvaient voir tous les fichiers disponibles sur la carte.\n\nSi la carte SD n'était pas disponible, les versions précédentes pourraient stocker des données sous `/data/data/` , qui isole des apps de l'autre, mais peut encore cause données à partager entre les utilisateurs.\n\nIl est maintenant possible de choisir de stocker les fichiers dans l'emplacement de stockage de fichier interne, ou en utilisant la logique précédente, avec une préférence au sein de votre application `config.xml` fichier. Pour ce faire, ajoutez l'un de ces deux lignes de `config.xml` :\n\n < nom de l'option = « AndroidPersistentFileLocation » value = « Internal » / >< nom de préférence = « AndroidPersistentFileLocation » value = « Compatibilité » / >\n \n\nSans cette ligne, utilisera le fichier plugin `Compatibility` par défaut. Si une balise de préférence est présente et n'est pas une des valeurs suivantes, l'application ne démarrera pas.\n\nSi votre application a déjà été expédiée aux utilisateurs, en utilisant une ancienne (avant 1.0) version de ce plugin et dispose des fichiers stockés dans le système de fichiers persistant, alors vous devez définir la préférence au `Compatibility` . Commutation de l'emplacement « Internal » signifierait que les utilisateurs existants qui mettre à niveau leur application peuvent être impossible d'accéder à leurs fichiers déjà enregistrés, selon leur appareil.\n\nSi votre application est nouvelle ou a jamais précédemment stocké les fichiers dans le système de fichiers persistant, puis la `Internal` réglage est généralement recommandé.\n\n### Opérations récursives lent pour /android_asset\n\nListe des répertoires actifs est vraiment lent sur Android. Vous pouvez accélérer il vers le haut, en ajoutant `src/android/build-extras.gradle` à la racine de votre projet android (requiert également cordova-android@4.0.0 ou supérieur).\n\n## Notes au sujet d'iOS\n\n * `cordova.file.applicationStorageDirectory`est en lecture seule ; tentative de stocker des fichiers dans le répertoire racine échoue. Utilisez l'une de l'autre `cordova.file.*` les propriétés définies pour iOS (seulement `applicationDirectory` et `applicationStorageDirectory` sont en lecture seule).\n * `FileReader.readAsText(blob, encoding)` \n * Le `encoding` paramètre n'est pas pris en charge, et le codage UTF-8 est toujours en vigueur.\n\n### emplacement de stockage persistant d'iOS\n\nIl y a deux emplacements valides pour stocker des fichiers persistants sur un appareil iOS : le répertoire de Documents et le répertoire de la bibliothèque. Les versions précédentes du plugin stockaient ne jamais fichiers persistants dans le répertoire de Documents. Cela a eu l'effet secondaire de rendre tous les fichiers de l'application visible dans iTunes, qui était souvent inattendus, en particulier pour les applications qui traitent beaucoup de petits fichiers, plutôt que de produire des documents complets destinés à l'exportation, qui est l'objectif visé par le répertoire.\n\nIl est maintenant possible de choisir de stocker les fichiers dans le répertoire de bibliothèque, avec une préférence au sein de votre application ou de documents `config.xml` fichier. Pour ce faire, ajoutez l'un de ces deux lignes de `config.xml` :\n\n < nom de l'option = « iosPersistentFileLocation » value = « Library » / >< nom de préférence = « iosPersistentFileLocation » value = « Compatibilité » / >\n \n\nSans cette ligne, utilisera le fichier plugin `Compatibility` par défaut. Si une balise de préférence est présente et n'est pas une des valeurs suivantes, l'application ne démarrera pas.\n\nSi votre application a déjà été expédiée aux utilisateurs, en utilisant une ancienne (avant 1.0) version de ce plugin et dispose des fichiers stockés dans le système de fichiers persistant, alors vous devez définir la préférence au `Compatibility` . Changer l'emplacement de `Library` voudrait dire que les utilisateurs existants qui mettre à niveau leur application serait incapables d'accéder à leurs fichiers déjà enregistrés.\n\nSi votre application est nouvelle ou a jamais précédemment stocké les fichiers dans le système de fichiers persistant, puis la `Library` réglage est généralement recommandé.\n\n## Firefox OS Quirks\n\nL'API de système de fichier n'est pas nativement pris en charge par Firefox OS et est implémentée comme une cale d'épaisseur sur le dessus d'indexedDB.\n\n * Ne manque pas lors de la suppression des répertoires non vide\n * Ne supporte pas les métadonnées pour les répertoires\n * Méthodes `copyTo` et `moveTo` ne prennent pas en charge les répertoires\n\nLes chemins de données suivants sont pris en charge: * `applicationDirectory` -utilise `xhr` pour obtenir des fichiers les qui sont emballées avec l'app. * `dataDirectory` - Pour les fichiers de données persistantes de app spécifique. * `cacheDirectory` -Mise en cache de fichiers qui doivent survivre les redémarrages de l'application (les applications ne doivent pas compter sur le système d'exploitation pour supprimer les fichiers ici).\n\n## Bizarreries navigateur\n\n### Commune de bizarreries et de remarques\n\n * Chaque navigateur utilise son propre système de fichiers en bac à sable. IE et Firefox utilisent IndexedDB comme base. Tous les navigateurs utilisent oblique comme séparateur de répertoire dans un chemin d'accès.\n * Entrées d'annuaire doivent être créées successivement. Par exemple, l'appel `fs.root.getDirectory (' dir1/dir2 ', {create:true}, successCallback, errorCallback)` échouera si dir1 n'existait pas.\n * Le plugin demande utilisateur l'autorisation d'utiliser le stockage persistant lors du premier démarrage d'application. \n * Plugin supporte `cdvfile://localhost` (ressources locales) seulement. C'est-à-dire les ressources externes ne sont pas supportés par l'intermédiaire de `cdvfile`.\n * Le plugin ne suit pas les [\"Restrictions de nommage des fichiers système API 8.3\"](http://www.w3.org/TR/2011/WD-file-system-api-20110419/#naming-restrictions).\n * BLOB et le fichier \"`close` la fonction n'est pas pris en charge.\n * `FileSaver` et `BlobBuilder` ne sont pas pris en charge par ce plugin et n'ont stubs.\n * Le plugin ne supporte pas les `requestAllFileSystems`. Cette fonction est également absent dans les cahier des charges.\n * Inscriptions dans l'annuaire ne seront pas supprimées si vous utilisez `create: true` drapeau pour le répertoire existant.\n * Fichiers créés via le constructeur ne sont pas pris en charge. Vous devez plutôt utiliser entry.file méthode.\n * Chaque navigateur utilise sa propre forme de références URL blob.\n * `readAsDataURL` fonction est prise en charge, mais le mediatype en Chrome dépend de l'extension entrée, mediatype dans IE est toujours vide (qui est le même que le `texte-plaine` selon la spécification), le mediatype dans Firefox est toujours `application/octet-stream`. Par exemple, si le contenu est `abcdefg` puis Firefox renvoie `données : application / octet-stream ; base64, YWJjZGVmZw ==`, c'est à dire les retours `données:; base64, YWJjZGVmZw ==`, retours de Chrome `données : < mediatype selon l'extension de nom d'entrée > ; base64, YWJjZGVmZw ==`.\n * `toInternalURL` retourne le chemin d'accès dans le formulaire `file:///persistent/path/to/entry` (Firefox, IE). Chrome retourne le chemin d'accès dans le formulaire `cdvfile://localhost/persistent/file`.\n\n### Bizarreries de chrome\n\n * Chrome filesystem n'est pas prête immédiatement après l'événement ready périphérique. Pour contourner le problème, vous pouvez vous abonner à l'événement `filePluginIsReady`. Exemple : \n\n```javascript\nwindow.addEventListener('filePluginIsReady', function(){ console.log('File plugin is ready');}, false);\n```\n\nVous pouvez utiliser la fonction `window.isFilePluginReadyRaised` pour vérifier si les événement était déjà déclenché. -quotas de window.requestFileSystem temporaire et permanent de système de fichiers ne sont pas limités en Chrome. -Pour augmenter le stockage persistant en Chrome, vous devez appeler la méthode `window.initPersistentFileSystem`. Quota de stockage persistant est 5 Mo par défaut. -Chrome nécessite `--permettre-fichier-accès-de-fichiers` exécuter l'argument au support API via le protocole `file:///`. -`Fichier` objet changera pas si vous utilisez le drapeau `{create:true}` lors du passage d'une `entrée` existante. -événements `annulables` propriété a la valeur true dans Chrome. Il s'agit à l'encontre de la [spécification](http://dev.w3.org/2009/dap/file-system/file-writer.html). -`toURL` renvoie à Chrome `système de fichiers :`-préfixe de chemin d'accès selon l'application hôte. Par exemple, `filesystem:file:///persistent/somefile.txt`, `filesystem:http://localhost:8080/persistent/somefile.txt`. -résultat de la fonction `toURL` ne contient-elle pas de barre oblique dans le cas d'entrée d'annuaire. Chrome résout répertoires avec barre oblique-trainés URL correctement cependant. -`resolveLocalFileSystemURL` méthode nécessite l' entrant `url` préfixe de `système de fichiers`. Par exemple, le paramètre `d'url` pour `resolveLocalFileSystemURL` devrait être dans la forme `filesystem:file:///persistent/somefile.txt` par opposition à la forme `file:///persistent/somefile.txt` dans Android. -Déconseillée `toNativeURL` fonction n'est pas prise en charge et n'est pas une ébauche. -fonction de `setMetadata` n'est pas stipulée dans le devis et pas pris en charge. -INVALID_MODIFICATION_ERR (code: 9) est levée au lieu de SYNTAX_ERR(code: 8) sur la demande d'un système de fichier inexistant. -INVALID_MODIFICATION_ERR (code: 9) est levée au lieu de PATH_EXISTS_ERR(code: 12) à essayer de créer exclusivement un fichier ou un répertoire, qui existe déjà. -INVALID_MODIFICATION_ERR (code: 9) est levée au lieu de NO_MODIFICATION_ALLOWED_ERR(code: 6) à essayer d'appeler removeRecursively sur le système de fichiers racine. -INVALID_MODIFICATION_ERR (code: 9) est levée au lieu de NOT_FOUND_ERR(code: 1) en essayant de moveTo répertoire qui n'existe pas.\n\n### Base IndexedDB impl bizarreries (Firefox et IE)\n\n * `.` et `.` ne sont pas pris en charge.\n * IE ne prend pas en charge les `file:///`-mode ; seul le mode hébergé est pris en charge (http://localhost:xxxx).\n * Taille de système de fichiers de Firefox n'est pas limité, mais chaque extension de 50Mo demandera une autorisation de l'utilisateur. IE10 permet jusqu'à 10 Mo de combiné AppCache et IndexedDB utilisés dans la mise en œuvre du système de fichiers sans demander de confirmation, une fois que vous atteignez ce niveau, Qu'on vous demandera si vous souhaitez lui permettre d'être augmentée jusqu'à un maximum de 250 Mo par site. Si le paramètre de `taille` pour la fonction `requestFileSystem` n'affecte pas le système de fichiers dans Firefox et IE.\n * fonction de `readAsBinaryString` n'est pas indiquée dans les spécifications et pas pris en charge dans Internet Explorer et n'a pas une ébauche.\n * `file.type` est toujours null.\n * Vous ne devez pas créer en utilisant le résultat du callback instance DirectoryEntry qui avait été supprimée. Sinon, vous obtiendrez une « entrée de pendaison ».\n * Avant que vous pouvez lire un fichier qui a été écrit juste que vous devez obtenir une nouvelle instance de ce fichier.\n * `setMetadata` fonction, qui n'est pas indiquée dans les spécifications supporte `modificationTime` changement de champ seulement. \n * fonctions `copyTo` et `moveTo` ne supportent pas les répertoires.\n * Répertoires métadonnées ne sont pas pris en charge.\n * Les deux Entry.remove et directoryEntry.removeRecursively ne manquent pas lors de la suppression des répertoires non-vides - répertoires retirés sont nettoyés avec contenu au lieu de cela.\n * fonctions `abort` et `truncate` ne sont pas supportées.\n * événements de progression ne sont pas déclenchés. Par exemple, ce gestionnaire ne sera pas exécuté :\n\n```javascript\nwriter.onprogress = function() { /*commands*/ };\n```\n\n## Notes de mise à niveau\n\nV1.0.0 de ce plugin, les structures `FileEntry` et `DirectoryEntry` ont changé, pour être plus conforme à la spécification publiée.\n\nLes versions précédentes de (pré-1.0.0) du plugin stockaient le dispositif-absolu--emplacement du fichier dans la propriété `fullPath` d'objets `d'entrée`. Ces chemins seraient présente généralement comme\n\n / var/mobile/Applications/< application UUID >/Documents/chemin/vers/fichier (iOS), /storage/emulated/0/path/to/file (Android)\n \n\nCes chemins ont été également retournés par la méthode de `toURL()` les objets `d'entrée`.\n\nAvec v1.0.0, l'attribut `fullPath` est le chemin d'accès au fichier, *par rapport à la racine du système de fichiers HTML*. Ainsi, les chemins d'accès ci-dessus seraient maintenant tous les deux être représentée par un objet `FileEntry` avec un `fullPath` de\n\n /path/to/file\n \n\nSi votre application fonctionne avec le dispositif-absolu-chemins et que vous avez récupéré précédemment ces chemins d'accès par le biais de la propriété `fullPath` d'objets `d'entrée`, puis vous devez mettre à jour votre code afin d'utiliser `entry.toURL()` à la place.\n\nPour vers l'arrière la compatibilité, la méthode `resolveLocalFileSystemURL()` sera un chemin absolu de l'unité et retourne un objet `Entry` correspondant à elle, tant que ce fichier existe au sein des systèmes de fichiers les `TEMPORARY` ou `PERSISTENT`.\n\nCela a été particulièrement un problème avec le plugin de transfert de fichiers, qui autrefois périphérique-absolu-chemins (et peut encore accepter). Il a été mis à jour pour fonctionner correctement avec le système de fichiers URL, afin de remplacer `entry.fullPath` par `entry.toURL()` devrait résoudre tout problème obtenir ce plugin pour travailler avec des fichiers sur le périphérique.\n\nDans v1.1.0 la valeur de retour de `toURL()` a été changée (voir \\[CB-6394\\] (https://issues.apache.org/jira/browse/CB-6394)) pour renvoyer une URL absolue \"file://\". dans la mesure du possible. Pour assurer un ' cdvfile:'-URL, vous pouvez utiliser `toInternalURL()` maintenant. Cette méthode retourne maintenant filesystem URL du formulaire\n\n cdvfile://localhost/persistent/path/to/file\n \n\nqui peut servir à identifier de manière unique le fichier.\n\n## Liste des Codes d'erreur et leur signification\n\nLorsqu'une erreur est levée, l'un des codes suivants sera utilisé.\n\n| Code | Constant |\n| ----:|:----------------------------- |\n| 1 | `NOT_FOUND_ERR` |\n| 2 | `SECURITY_ERR` |\n| 3 | `ABORT_ERR` |\n| 4 | `NOT_READABLE_ERR` |\n| 5 | `ENCODING_ERR` |\n| 6 | `NO_MODIFICATION_ALLOWED_ERR` |\n| 7 | `INVALID_STATE_ERR` |\n| 8 | `SYNTAX_ERR` |\n| 9 | `INVALID_MODIFICATION_ERR` |\n| 10 | `QUOTA_EXCEEDED_ERR` |\n| 11 | `TYPE_MISMATCH_ERR` |\n| 12 | `PATH_EXISTS_ERR` |\n\n## Configuration du Plugin (facultatif)\n\nL'ensemble des systèmes de fichiers disponibles peut être configurée par plate-forme. Les iOS et Android reconnaissent une balise dans le `fichier config.xml` qui nomme les systèmes de fichiers à installer. Par défaut, toutes les racines du système de fichiers sont activées.\n\n \n \n \n\n### Android\n\n * `files` : répertoire de stockage de fichier interne de l'application\n * `files-external` : répertoire de l'application de stockage de fichier externe\n * `sdcard` : le répertoire de stockage global fichier externe (c'est la racine de la carte SD, s'il est installé). Vous devez avoir la permission de `android.permission.WRITE_EXTERNAL_STORAGE` de l'utiliser.\n * `cache` : répertoire de cache interne de l'application\n * `cache-external` : répertoire de cache externe de l'application\n * `root` : le système de fichiers de tout dispositif\n\nAndroid prend également en charge un système de fichiers spécial nommé « documents », qui représente un sous-répertoire « / Documents / » dans le système de fichiers « files ».\n\n### iOS\n\n * `library` : répertoire de bibliothèque de l'application\n * `documents` : répertoire de Documents de l'application\n * `cache` : répertoire de Cache de l'application\n * `bundle` : bundle de l'application ; l'emplacement de l'application elle-même sur disque (lecture seule)\n * `root` : le système de fichiers de tout dispositif\n\nPar défaut, vous peuvent synchroniser les répertoires de la bibliothèque et les documents à iCloud. Vous pouvez également demander des deux systèmes de fichiers supplémentaires, `library-nosync` et `documents-nosync`, qui représentent un répertoire spécial non synchronisées dans le `/Library` ou système de fichiers `/ Documents`."
},
{
"path": "plugins/cordova-plugin-file/doc/fr/index.md",
"content": "\n\n# cordova-plugin-file\n\nCe plugin implémente une API de fichier permettant l'accès en lecture/écriture aux fichiers qui résident sur le périphérique.\n\nCe plugin est basé sur plusieurs spécifications, y compris : l'API de fichier HTML5 \n\nLes répertoires (aujourd'hui disparue) et le système des extensions plus récentes : bien que la plupart du code du plugin a été écrit quand une technique antérieure était en vigueur : \n\nIl met également en œuvre la spécification FileWriter : \n\nPour son utilisation, veuillez vous reporter au HTML5 Rocks' excellent [article de système de fichiers.][1]\n\n [1]: http://www.html5rocks.com/en/tutorials/file/filesystem/\n\nPour un aperçu des autres options de stockage, consultez [guide d'entreposage de Cordova][2].\n\n [2]: http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html\n\nCe plugin définit global `cordova.file` objet.\n\nBien que dans la portée globale, il n'est pas disponible jusqu'après la `deviceready` événement.\n\n document.addEventListener (« deviceready », onDeviceReady, false) ;\n function onDeviceReady() {console.log(cordova.file);}\n \n\n## Installation\n\n Cordova plugin ajouter cordova-plugin-file\n \n\n## Plates-formes prises en charge\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* Firefox OS\n* iOS\n* Windows Phone 7 et 8 *\n* Windows 8 *\n* Navigateur\n\n* *Ces plates-formes ne supportent pas `FileReader.readAsArrayBuffer` ni `FileWriter.write(blob)` .*\n\n## Emplacement de stockage des fichiers\n\nÀ partir de v1.2.0, URL vers des répertoires de système de fichiers importants est fournis. Chaque URL est dans la forme *file:///path/to/spot/*et peut être converti en un `DirectoryEntry` à l'aide`window.resolveLocalFileSystemURL()`.\n\n* `cordova.file.applicationDirectory`-Lecture seule répertoire où l'application est installée. (*iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.applicationStorageDirectory`-Répertoire racine du bac à sable de l'application ; cet endroit est en lecture seule sur iOS (mais les sous-répertoires spécifiques [comme `/Documents` ] sont en lecture / écriture). Toutes les données qu'il contient est privé de l'application. ( *iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.dataDirectory`-Stockage des données persistants et privés au sein de bac à sable de l'application à l'aide de la mémoire interne (sur Android, si vous avez besoin d'utiliser une mémoire externe, utilisez `.externalDataDirectory` ). Sur iOS, ce répertoire n'est pas synchronisé avec iCloud (utiliser `.syncedDataDirectory` ). (*iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.cacheDirectory`-Répertoire pour les fichiers de données en mémoire cache ou les fichiers que votre application peut recréer facilement. L'OS peut supprimer ces fichiers lorsque l'appareil faiblit sur stockage, néanmoins, les applications ne doivent pas compter sur l'OS pour supprimer les fichiers ici. (*iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.externalApplicationStorageDirectory`-Espace l'application sur le stockage externe. (*Android*)\n\n* `cordova.file.externalDataDirectory`-Où placer les fichiers de données d'application spécifiques sur le stockage externe. (*Android*)\n\n* `cordova.file.externalCacheDirectory`-Cache de l'application sur le stockage externe. (*Android*)\n\n* `cordova.file.externalRootDirectory`-Racine de stockage externe (carte SD). (*Android*, *BlackBerry 10*)\n\n* `cordova.file.tempDirectory`-Répertoire temp que l'OS peut effacer à volonté. Ne comptez pas sur l'OS pour effacer ce répertoire ; votre application doit toujours supprimer les fichiers selon le cas. (*iOS*)\n\n* `cordova.file.syncedDataDirectory`-Contient des fichiers d'app spécifique qui doivent se synchroniser (par exemple à iCloud). (*iOS*)\n\n* `cordova.file.documentsDirectory`-Fichiers privés à l'app, mais qui sont significatives pour l'autre application (par exemple les fichiers Office). (*iOS*)\n\n* `cordova.file.sharedDirectory`-Fichiers disponibles globalement à toutes les applications (*BlackBerry 10*)\n\n## Structures de système de fichiers\n\nBien que techniquement un détail d'implémentation, il peut être très utile de savoir comment les `cordova.file.*` carte de propriétés à des chemins d'accès physiques sur un périphérique réel.\n\n### iOS agencement de système de fichier\n\n| Chemin de l'unité | `Cordova.file.*` | `iosExtraFileSystems` | r/w ? | persistants ? | OS efface | Sync | privé |\n|:-------------------------------------------- |:--------------------------- |:--------------------- |:-----:|:-------------:|:-----------:|:-----:|:-----:|\n| `/ var/mobile/Applications/< UUID > /` | applicationStorageDirectory | - | r | N/A | N/A | N/A | Oui |\n| `appname.app/` | applicationDirectory | Bundle | r | N/A | N/A | N/A | Oui |\n| `www/` | - | - | r | N/A | N/A | N/A | Oui |\n| `Documents/` | documentsDirectory | documents | r/w | Oui | Non | Oui | Oui |\n| `NoCloud/` | - | documents-nosync | r/w | Oui | Non | Non | Oui |\n| `Library` | - | Bibliothèque | r/w | Oui | Non | Oui ? | Oui |\n| `NoCloud/` | dataDirectory | Bibliothèque-nosync | r/w | Oui | Non | Non | Oui |\n| `Cloud/` | syncedDataDirectory | - | r/w | Oui | Non | Oui | Oui |\n| `Caches/` | cacheDirectory | cache | r/w | Oui * | Oui * * *| | Non | Oui |\n| `tmp/` | tempDirectory | - | r/w | Ne * * | Oui * * *| | Non | Oui |\n\n* Fichiers persistent à travers les redémarrages de l'application et mises à niveau, mais ce répertoire peut être effacé à chaque fois que les désirs de l'OS. Votre application doit être en mesure de recréer tout contenu qui pourrait être supprimé.\n\n* * Fichiers peuvent persister redémarrages de l'application, mais ne vous fiez pas ce comportement. Les fichiers ne sont pas garantis à persister dans l'ensemble de mises à jour. Votre application doit supprimer les fichiers de ce répertoire lorsqu'elle s'applique, comme le système d'exploitation ne garantit pas quand (ou même si) ces fichiers sont supprimés.\n\n* * *| L'OS peut effacer le contenu de ce répertoire chaque fois qu'il se sent il est nécessaire, mais ne comptez pas là-dessus. Vous devez supprimer ce répertoire comme approprié pour votre application.\n\n### Agencement de système de fichiers Android\n\n| Chemin de l'unité | `Cordova.file.*` | `AndroidExtraFileSystems` | r/w ? | persistants ? | OS efface | privé |\n|:----------------------------------- |:----------------------------------- |:------------------------- |:-----:|:-------------:|:---------:|:-----:|\n| `file:///android_asset/` | applicationDirectory | | r | N/A | N/A | Oui |\n| `/ données/data/app < id > /` | applicationStorageDirectory | - | r/w | N/A | N/A | Oui |\n| `cache` | cacheDirectory | cache | r/w | Oui | Oui * | Oui |\n| `files` | dataDirectory | fichiers | r/w | Oui | Non | Oui |\n| `Documents` | | documents | r/w | Oui | Non | Oui |\n| `< sdcard > /` | externalRootDirectory | sdcard | r/w | Oui | Non | Non |\n| `Android/data//` | externalApplicationStorageDirectory | - | r/w | Oui | Non | Non |\n| `cache` | externalCacheDirectry | cache-externe | r/w | Oui | Ne * * | Non |\n| `files` | externalDataDirectory | fichiers externes | r/w | Oui | Non | Non |\n\n* Le système d'exploitation peut effacer périodiquement ce répertoire, mais ne vous fiez pas ce comportement. Effacer le contenu de ce répertoire comme approprié pour votre application. Un utilisateur doit purger le cache manuellement, le contenu de ce répertoire est supprimé.\n\n* * The OS vous n'effacez pas ce répertoire automatiquement ; vous êtes chargé de gérer le contenu vous-même. L'utilisateur devrait purger le cache manuellement, le contenu du répertoire est supprimé.\n\n**Remarque**: si le stockage externe ne peut pas être monté, les `cordova.file.external*` sont des propriétés`null`.\n\n### Configuration du système blackBerry 10 fichier\n\n| Chemin de l'unité | `Cordova.file.*` | r/w ? | persistants ? | OS efface | privé |\n|:--------------------------------------------------- |:--------------------------- |:-----:|:-------------:|:---------:|:-----:|\n| `file:///Accounts/1000/AppData/ < id app > /` | applicationStorageDirectory | r | N/A | N/A | Oui |\n| `app/native` | applicationDirectory | r | N/A | N/A | Oui |\n| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | Non | Oui | Oui |\n| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | Oui | Non | Oui |\n| `file:///Accounts/1000/Removable/sdcard` | externalRemovableDirectory | r/w | Oui | Non | Non |\n| `file:///Accounts/1000/Shared` | sharedDirectory | r/w | Oui | Non | Non |\n\n*Remarque*: lorsque l'application est déployée dans le périmètre de travail, tous les chemins sont par rapport à /accounts/1000-enterprise.\n\n## Quirks Android\n\n### Emplacement de stockage persistant Android\n\nIl y a plusieurs emplacements valides pour stocker des fichiers persistants sur un appareil Android. Voir [cette page][3] pour une analyse approfondie des diverses possibilités.\n\n [3]: http://developer.android.com/guide/topics/data/data-storage.html\n\nLes versions précédentes du plugin choisirait l'emplacement des fichiers temporaires et persistantes au démarrage, basé sur la question de savoir si le dispositif réclamé que la carte SD (ou une partition de stockage équivalent) a été montée. Si la carte SD a été montée, ou si une partition de stockage interne importante était disponible (comme sur les appareils Nexus,) puis les fichiers persistants seraient stockés dans la racine de cet espace. Cela signifie que toutes les apps de Cordova pouvaient voir tous les fichiers disponibles sur la carte.\n\nSi la carte SD n'était pas disponible, les versions précédentes pourraient stocker des données sous `/data/data/` , qui isole des apps de l'autre, mais peut encore cause données à partager entre les utilisateurs.\n\nIl est maintenant possible de choisir de stocker les fichiers dans l'emplacement de stockage de fichier interne, ou en utilisant la logique précédente, avec une préférence au sein de votre application `config.xml` fichier. Pour ce faire, ajoutez l'un de ces deux lignes de `config.xml` :\n\n < nom de l'option = « AndroidPersistentFileLocation » value = « Internal » / >< nom de préférence = « AndroidPersistentFileLocation » value = « Compatibilité » / >\n \n\nSans cette ligne, utilisera le fichier plugin `Compatibility` par défaut. Si une balise de préférence est présente et n'est pas une des valeurs suivantes, l'application ne démarrera pas.\n\nSi votre application a déjà été expédiée aux utilisateurs, en utilisant une ancienne (avant 1.0) version de ce plugin et dispose des fichiers stockés dans le système de fichiers persistant, alors vous devez définir la préférence au `Compatibility` . Commutation de l'emplacement « Internal » signifierait que les utilisateurs existants qui mettre à niveau leur application peuvent être impossible d'accéder à leurs fichiers déjà enregistrés, selon leur appareil.\n\nSi votre application est nouvelle ou a jamais précédemment stocké les fichiers dans le système de fichiers persistant, puis la `Internal` réglage est généralement recommandé.\n\n## iOS Quirks\n\n* `cordova.file.applicationStorageDirectory`est en lecture seule ; tentative de stocker des fichiers dans le répertoire racine échoue. Utilisez l'une de l'autre `cordova.file.*` les propriétés définies pour iOS (seulement `applicationDirectory` et `applicationStorageDirectory` sont en lecture seule).\n* `FileReader.readAsText(blob, encoding)` \n * Le `encoding` paramètre n'est pas pris en charge, et le codage UTF-8 est toujours en vigueur.\n\n### emplacement de stockage persistant d'iOS\n\nIl y a deux emplacements valides pour stocker des fichiers persistants sur un appareil iOS : le répertoire de Documents et le répertoire de la bibliothèque. Les versions précédentes du plugin stockaient ne jamais fichiers persistants dans le répertoire de Documents. Cela a eu l'effet secondaire de rendre tous les fichiers de l'application visible dans iTunes, qui était souvent inattendus, en particulier pour les applications qui traitent beaucoup de petits fichiers, plutôt que de produire des documents complets destinés à l'exportation, qui est l'objectif visé par le répertoire.\n\nIl est maintenant possible de choisir de stocker les fichiers dans le répertoire de bibliothèque, avec une préférence au sein de votre application ou de documents `config.xml` fichier. Pour ce faire, ajoutez l'un de ces deux lignes de `config.xml` :\n\n < nom de l'option = « iosPersistentFileLocation » value = « Library » / >< nom de préférence = « iosPersistentFileLocation » value = « Compatibilité » / >\n \n\nSans cette ligne, utilisera le fichier plugin `Compatibility` par défaut. Si une balise de préférence est présente et n'est pas une des valeurs suivantes, l'application ne démarrera pas.\n\nSi votre application a déjà été expédiée aux utilisateurs, en utilisant une ancienne (avant 1.0) version de ce plugin et dispose des fichiers stockés dans le système de fichiers persistant, alors vous devez définir la préférence au `Compatibility` . Changer l'emplacement de `Library` voudrait dire que les utilisateurs existants qui mettre à niveau leur application serait incapables d'accéder à leurs fichiers déjà enregistrés.\n\nSi votre application est nouvelle ou a jamais précédemment stocké les fichiers dans le système de fichiers persistant, puis la `Library` réglage est généralement recommandé.\n\n## Firefox OS Quirks\n\nL'API de système de fichier n'est pas nativement pris en charge par Firefox OS et est implémentée comme une cale d'épaisseur sur le dessus d'indexedDB.\n\n* Ne manque pas lors de la suppression des répertoires non vide\n* Ne supporte pas les métadonnées pour les répertoires\n* Méthodes `copyTo` et `moveTo` ne prennent pas en charge les répertoires\n\nLes chemins de données suivants sont pris en charge: * `applicationDirectory` -utilise `xhr` pour obtenir des fichiers les qui sont emballées avec l'app. * `dataDirectory` - Pour les fichiers de données persistantes de app spécifique. * `cacheDirectory` -Mise en cache de fichiers qui doivent survivre les redémarrages de l'application (les applications ne doivent pas compter sur le système d'exploitation pour supprimer les fichiers ici).\n\n## Bizarreries navigateur\n\n### Commune de bizarreries et de remarques\n\n* Chaque navigateur utilise son propre système de fichiers en bac à sable. IE et Firefox utilisent IndexedDB comme base. Tous les navigateurs utilisent oblique comme séparateur de répertoire dans un chemin d'accès.\n* Entrées d'annuaire doivent être créées successivement. Par exemple, l'appel `fs.root.getDirectory (' dir1/dir2 ', {create:true}, successCallback, errorCallback)` échouera si dir1 n'existait pas.\n* Le plugin demande utilisateur l'autorisation d'utiliser le stockage persistant lors du premier démarrage d'application. \n* Plugin supporte `cdvfile://localhost` (ressources locales) seulement. C'est-à-dire les ressources externes ne sont pas supportés par l'intermédiaire de `cdvfile`.\n* Le plugin ne suit pas les [\"Restrictions de nommage des fichiers système API 8.3\"][4].\n* BLOB et le fichier \"`close` la fonction n'est pas pris en charge.\n* `FileSaver` et `BlobBuilder` ne sont pas pris en charge par ce plugin et n'ont stubs.\n* Le plugin ne supporte pas les `requestAllFileSystems`. Cette fonction est également absent dans les cahier des charges.\n* Inscriptions dans l'annuaire ne seront pas supprimées si vous utilisez `create: true` drapeau pour le répertoire existant.\n* Fichiers créés via le constructeur ne sont pas pris en charge. Vous devez plutôt utiliser entry.file méthode.\n* Chaque navigateur utilise sa propre forme de références URL blob.\n* `readAsDataURL` fonction est prise en charge, mais le mediatype en Chrome dépend de l'extension entrée, mediatype dans IE est toujours vide (qui est le même que le `texte-plaine` selon la spécification), le mediatype dans Firefox est toujours `application/octet-stream`. Par exemple, si le contenu est `abcdefg` puis Firefox renvoie `données : application / octet-stream ; base64, YWJjZGVmZw ==`, c'est à dire les retours `données:; base64, YWJjZGVmZw ==`, retours de Chrome `données : < mediatype selon l'extension de nom d'entrée > ; base64, YWJjZGVmZw ==`.\n* `toInternalURL` retourne le chemin d'accès dans le formulaire `file:///persistent/path/to/entry` (Firefox, IE). Chrome retourne le chemin d'accès dans le formulaire `cdvfile://localhost/persistent/file`.\n\n [4]: http://www.w3.org/TR/2011/WD-file-system-api-20110419/#naming-restrictions\n\n### Bizarreries de chrome\n\n* Chrome filesystem n'est pas prête immédiatement après l'événement ready périphérique. Pour contourner le problème, vous pouvez vous abonner à l'événement `filePluginIsReady`. Exemple : \n\n javascript\n window.addEventListener('filePluginIsReady', function(){ console.log('File plugin is ready');}, false);\n \n\nVous pouvez utiliser la fonction `window.isFilePluginReadyRaised` pour vérifier si les événement était déjà déclenché. -quotas de window.requestFileSystem temporaire et permanent de système de fichiers ne sont pas limités en Chrome. -Pour augmenter le stockage persistant en Chrome, vous devez appeler la méthode `window.initPersistentFileSystem`. Quota de stockage persistant est 5 Mo par défaut. -Chrome nécessite `--permettre-fichier-accès-de-fichiers` exécuter l'argument au support API via le protocole `file:///`. -`Fichier` objet changera pas si vous utilisez le drapeau `{create:true}` lors du passage d'une `entrée` existante. -événements `annulables` propriété a la valeur true dans Chrome. Il s'agit à l'encontre de la [spécification][5]. -`toURL` renvoie à Chrome `système de fichiers :`-préfixe de chemin d'accès selon l'application hôte. Par exemple, `filesystem:file:///persistent/somefile.txt`, `filesystem:http://localhost:8080/persistent/somefile.txt`. -résultat de la fonction `toURL` ne contient-elle pas de barre oblique dans le cas d'entrée d'annuaire. Chrome résout répertoires avec barre oblique-trainés URL correctement cependant. -`resolveLocalFileSystemURL` méthode nécessite l' entrant `url` préfixe de `système de fichiers`. Par exemple, le paramètre `d'url` pour `resolveLocalFileSystemURL` devrait être dans la forme `filesystem:file:///persistent/somefile.txt` par opposition à la forme `file:///persistent/somefile.txt` dans Android. -Déconseillée `toNativeURL` fonction n'est pas prise en charge et n'est pas une ébauche. -fonction de `setMetadata` n'est pas stipulée dans le devis et pas pris en charge. -INVALID_MODIFICATION_ERR (code: 9) est levée au lieu de SYNTAX_ERR(code: 8) sur la demande d'un système de fichier inexistant. -INVALID_MODIFICATION_ERR (code: 9) est levée au lieu de PATH_EXISTS_ERR(code: 12) à essayer de créer exclusivement un fichier ou un répertoire, qui existe déjà. -INVALID_MODIFICATION_ERR (code: 9) est levée au lieu de NO_MODIFICATION_ALLOWED_ERR(code: 6) à essayer d'appeler removeRecursively sur le système de fichiers racine. -INVALID_MODIFICATION_ERR (code: 9) est levée au lieu de NOT_FOUND_ERR(code: 1) en essayant de moveTo répertoire qui n'existe pas.\n\n [5]: http://dev.w3.org/2009/dap/file-system/file-writer.html\n\n### Base IndexedDB impl bizarreries (Firefox et IE)\n\n* `.` et `.` ne sont pas pris en charge.\n* IE ne prend pas en charge les `file:///`-mode ; seul le mode hébergé est pris en charge (http://localhost:xxxx).\n* Taille de système de fichiers de Firefox n'est pas limité, mais chaque extension de 50Mo demandera une autorisation de l'utilisateur. IE10 permet jusqu'à 10 Mo de combiné AppCache et IndexedDB utilisés dans la mise en œuvre du système de fichiers sans demander de confirmation, une fois que vous atteignez ce niveau, Qu'on vous demandera si vous souhaitez lui permettre d'être augmentée jusqu'à un maximum de 250 Mo par site. Si le paramètre de `taille` pour la fonction `requestFileSystem` n'affecte pas le système de fichiers dans Firefox et IE.\n* fonction de `readAsBinaryString` n'est pas indiquée dans les spécifications et pas pris en charge dans Internet Explorer et n'a pas une ébauche.\n* `file.type` est toujours null.\n* Vous ne devez pas créer en utilisant le résultat du callback instance DirectoryEntry qui avait été supprimée. Sinon, vous obtiendrez une « entrée de pendaison ».\n* Avant que vous pouvez lire un fichier qui a été écrit juste que vous devez obtenir une nouvelle instance de ce fichier.\n* `setMetadata` fonction, qui n'est pas indiquée dans les spécifications supporte `modificationTime` changement de champ seulement. \n* fonctions `copyTo` et `moveTo` ne supportent pas les répertoires.\n* Répertoires métadonnées ne sont pas pris en charge.\n* Les deux Entry.remove et directoryEntry.removeRecursively ne manquent pas lors de la suppression des répertoires non-vides - répertoires retirés sont nettoyés avec contenu au lieu de cela.\n* fonctions `abort` et `truncate` ne sont pas supportées.\n* événements de progression ne sont pas déclenchés. Par exemple, ce gestionnaire ne sera pas exécuté :\n\n javascript\n writer.onprogress = function() { /*commands*/ };\n \n\n## Notes de mise à niveau\n\nV1.0.0 de ce plugin, les structures `FileEntry` et `DirectoryEntry` ont changé, pour être plus conforme à la spécification publiée.\n\nLes versions précédentes de (pré-1.0.0) du plugin stockaient le dispositif-absolu--emplacement du fichier dans la propriété `fullPath` d'objets `d'entrée`. Ces chemins seraient présente généralement comme\n\n / var/mobile/Applications/< application UUID >/Documents/chemin/vers/fichier (iOS), /storage/emulated/0/path/to/file (Android)\n \n\nCes chemins ont été également retournés par la méthode de `toURL()` les objets `d'entrée`.\n\nAvec v1.0.0, l'attribut `fullPath` est le chemin d'accès au fichier, *par rapport à la racine du système de fichiers HTML*. Ainsi, les chemins d'accès ci-dessus seraient maintenant tous les deux être représentée par un objet `FileEntry` avec un `fullPath` de\n\n /path/to/file\n \n\nSi votre application fonctionne avec le dispositif-absolu-chemins et que vous avez récupéré précédemment ces chemins d'accès par le biais de la propriété `fullPath` d'objets `d'entrée`, puis vous devez mettre à jour votre code afin d'utiliser `entry.toURL()` à la place.\n\nPour vers l'arrière la compatibilité, la méthode `resolveLocalFileSystemURL()` sera un chemin absolu de l'unité et retourne un objet `Entry` correspondant à elle, tant que ce fichier existe au sein des systèmes de fichiers les `TEMPORARY` ou `PERSISTENT`.\n\nCela a été particulièrement un problème avec le plugin de transfert de fichiers, qui autrefois périphérique-absolu-chemins (et peut encore accepter). Il a été mis à jour pour fonctionner correctement avec le système de fichiers URL, afin de remplacer `entry.fullPath` par `entry.toURL()` devrait résoudre tout problème obtenir ce plugin pour travailler avec des fichiers sur le périphérique.\n\nDans v1.1.0 la valeur de retour de `toURL()` a été changée (voir \\[CB-6394\\] (https://issues.apache.org/jira/browse/CB-6394)) pour renvoyer une URL absolue \"file://\". dans la mesure du possible. Pour assurer un ' cdvfile:'-URL, vous pouvez utiliser `toInternalURL()` maintenant. Cette méthode retourne maintenant filesystem URL du formulaire\n\n cdvfile://localhost/persistent/path/to/file\n \n\nqui peut servir à identifier de manière unique le fichier.\n\n## Liste des Codes d'erreur et leur signification\n\nLorsqu'une erreur est levée, l'un des codes suivants sera utilisé.\n\n| Code | Constant |\n| ----:|:----------------------------- |\n| 1 | `NOT_FOUND_ERR` |\n| 2 | `SECURITY_ERR` |\n| 3 | `ABORT_ERR` |\n| 4 | `NOT_READABLE_ERR` |\n| 5 | `ENCODING_ERR` |\n| 6 | `NO_MODIFICATION_ALLOWED_ERR` |\n| 7 | `INVALID_STATE_ERR` |\n| 8 | `SYNTAX_ERR` |\n| 9 | `INVALID_MODIFICATION_ERR` |\n| 10 | `QUOTA_EXCEEDED_ERR` |\n| 11 | `TYPE_MISMATCH_ERR` |\n| 12 | `PATH_EXISTS_ERR` |\n\n## Configuration du Plugin (facultatif)\n\nL'ensemble des systèmes de fichiers disponibles peut être configurée par plate-forme. Les iOS et Android reconnaissent une balise dans le `fichier config.xml` qui nomme les systèmes de fichiers à installer. Par défaut, toutes les racines du système de fichiers sont activées.\n\n \n \n \n\n### Android\n\n* `files` : répertoire de stockage de fichier interne de l'application\n* `files-external` : répertoire de l'application de stockage de fichier externe\n* `sdcard` : le répertoire de stockage global fichier externe (c'est la racine de la carte SD, s'il est installé). Vous devez avoir la permission de `android.permission.WRITE_EXTERNAL_STORAGE` de l'utiliser.\n* `cache` : répertoire de cache interne de l'application\n* `cache-external` : répertoire de cache externe de l'application\n* `root` : le système de fichiers de tout dispositif\n\nAndroid prend également en charge un système de fichiers spécial nommé « documents », qui représente un sous-répertoire « / Documents / » dans le système de fichiers « files ».\n\n### iOS\n\n* `library` : répertoire de bibliothèque de l'application\n* `documents` : répertoire de Documents de l'application\n* `cache` : répertoire de Cache de l'application\n* `bundle` : bundle de l'application ; l'emplacement de l'application elle-même sur disque (lecture seule)\n* `root` : le système de fichiers de tout dispositif\n\nPar défaut, vous peuvent synchroniser les répertoires de la bibliothèque et les documents à iCloud. Vous pouvez également demander des deux systèmes de fichiers supplémentaires, `library-nosync` et `documents-nosync`, qui représentent un répertoire spécial non synchronisées dans le `/Library` ou système de fichiers `/ Documents`.\n"
},
{
"path": "plugins/cordova-plugin-file/doc/fr/plugins.md",
"content": "\n\n# Notes pour les développeurs de plugins\n\nCes notes sont principalement destinés à des développeurs Android et iOS qui veulent écrire des plugins qui interface avec le système de fichiers en utilisant le fichier plugin.\n\n## Travailler avec Cordova fichier système URL\n\nDepuis la version 1.0.0, ce plugin utilise des URL avec un `cdvfile` guichet pour toutes les communications sur le pont, plutôt que d'exposer des chemins de système de fichiers de périphérique brut à JavaScript.\n\nDu côté du JavaScript, cela signifie que les objets FileEntry et DirectoryEntry ont un attribut fullPath qui est relatif à la racine du système de fichiers HTML. Si votre plugin JavaScript API accepte un objet FileEntry ou DirectoryEntry, vous devez appeler `.toURL()` sur cet objet avant de le passer sur le pont en code natif.\n\n### Conversion de cdvfile: / / URL aux chemins d'accès fileystem\n\nPlugins qui ont besoin d'écrire dans le système de fichiers pouvez convertir un fichier reçu système URL vers un emplacement de système de fichiers réels. Il y a plusieurs façons de le faire, selon la plate-forme native.\n\nIl est important de rappeler que pas tous les `cdvfile://` URL sont cartographiables à des fichiers sur le périphérique. Certaines URL peut faire référence aux actifs sur les périphériques qui ne sont pas représentés par des fichiers, ou peuvent même faire référence aux ressources distantes. En raison de ces possibilités, plugins devraient toujours tester si ils obtiennent un résultat significatif retour lorsque vous essayez de convertir les URL aux chemins d'accès.\n\n#### Androïde\n\nSur Android, la méthode la plus simple pour convertir un `cdvfile://` URL vers un chemin d'accès de système de fichiers est d'utiliser `org.apache.cordova.CordovaResourceApi` . `CordovaResourceApi`possède plusieurs méthodes qui peuvent gérer `cdvfile://` URL :\n\n webView est membre de la Plugin classe CordovaResourceApi resourceApi = webView.getResourceApi() ;\n \n Obtenir une URL file:/// représentant ce fichier sur le périphérique, / / ou le même URL inchangée si elle ne peut pas être mappée à un fichier Uri fileURL = resourceApi.remapUri(Uri.parse(cdvfileURL)) ;\n \n\nIl est également possible d'utiliser le fichier plugin directement :\n\n Import org.apache.cordova.file.FileUtils ;\n Import org.apache.cordova.file.FileSystem ;\n java.net.MalformedURLException d'importation ;\n \n Téléchargez le fichier plugin depuis le gestionnaire de plugin FileUtils filePlugin = (FileUtils)webView.pluginManager.getPlugin(\"File\") ;\n \n En donnant une URL, obtenir un chemin d'accès pour essayer {String path = filePlugin.filesystemPathForURL(cdvfileURL);} catch (MalformedURLException e) {/ / l'url du système de fichiers n'a pas été reconnu}\n \n\nPour convertir un chemin d'accès à un `cdvfile://` URL :\n\n Import org.apache.cordova.file.LocalFilesystemURL ;\n \n Obtenir un objet LocalFilesystemURL pour un chemin de périphérique, / / ou null si elle ne peut être représentée sous forme d'URL cdvfile.\n LocalFilesystemURL url = filePlugin.filesystemURLforLocalPath(path) ;\n Obtenir la chaîne représentant l'URL objet String cdvfileURL = url.toString() ;\n \n\nSi votre plugin crée un fichier et que vous souhaitez renvoyer un objet FileEntry pour cela, utilisez le fichier plugin :\n\n Retourne une structure JSON approprié pour revenir en JavaScript, / / ou null si ce fichier n'est pas représentable sous forme d'URL cdvfile.\n JSONObject entrée = filePlugin.getEntryForFile(file) ;\n \n\n#### iOS\n\nCordova sur iOS n'utilise pas le même `CordovaResourceApi` concept d'Android. Sur iOS, vous devez utiliser le fichier plugin pour convertir entre les URL et les chemins d'accès de système de fichiers.\n\n Obtenir un objet URL CDVFilesystem partir d'une chaîne d'URL CDVFilesystemURL * url = [CDVFilesystemURL fileSystemURLWithString:cdvfileURL] ;\n Obtenir un chemin d'accès de l'objet URL, ou zéro si elle ne peut pas être mappée à un chemin de fichier NSString * = [filePlugin filesystemPathForURL:url] ;\n \n \n Obtenir un objet CDVFilesystem URL pour un chemin de périphérique, ou / / zéro si elle ne peut être représentée sous forme d'URL cdvfile.\n CDVFilesystemURL * url = [filePlugin fileSystemURLforLocalPath:path] ;\n Obtenir la représentation de chaîne de l'objet NSString * cdvfileURL URL = [url absoluteString] ;\n \n\nSi votre plugin crée un fichier et que vous souhaitez renvoyer un objet FileEntry pour cela, utilisez le fichier plugin :\n\n Obtenir un objet CDVFilesystem URL pour un chemin de périphérique, ou / / zéro si elle ne peut être représentée sous forme d'URL cdvfile.\n CDVFilesystemURL * url = [filePlugin fileSystemURLforLocalPath:path] ;\n Obtenir une structure pour revenir à JavaScript NSDictionary * entrée = [filePlugin makeEntryForLocalURL:url]\n \n\n#### JavaScript\n\nEn JavaScript, pour obtenir un `cdvfile://` URL d'un objet FileEntry ou DirectoryEntry, il suffit d'appeler `.toURL()` à ce sujet :\n\n var cdvfileURL = entry.toURL() ;\n \n\nDans gestionnaires de plugin de réponse, pour convertir une structure FileEntry retournée vers un objet réel de l'entrée, votre code de gestionnaire doit importer le fichier plugin et créer un nouvel objet :\n\n créer l'entrée de var d'objet entrée appropriée ;\n Si (entryStruct.isDirectory) {entrée = new DirectoryEntry (entryStruct.name, entryStruct.fullPath, nouveau FileSystem(entryStruct.filesystemName));} else {entrée = nouvelle FileEntry (entryStruct.name, entryStruct.fullPath, nouvelle FileSystem(entryStruct.filesystemName));}"
},
{
"path": "plugins/cordova-plugin-file/doc/it/README.md",
"content": "\n\n# cordova-plugin-file\n\n[](https://travis-ci.org/apache/cordova-plugin-file)\n\nQuesto plugin implementa un API File permettendo l'accesso di lettura/scrittura ai file che risiedono sul dispositivo.\n\nQuesto plugin si basa su diverse specifiche, tra cui: The HTML5 File API \n\nLe directory (ormai defunta) e il sistema delle estensioni più recenti: anche se la maggior parte del codice plugin è stato scritto quando una spec precedenti era corrente: \n\nImplementa inoltre FileWriter spec: \n\nPer l'utilizzo, fare riferimento a HTML5 Rocks' eccellente [articolo FileSystem.](http://www.html5rocks.com/en/tutorials/file/filesystem/)\n\nPer una panoramica delle altre opzioni di archiviazione, consultare [Guida di archiviazione di Cordova](http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html).\n\nQuesto plugin definisce oggetto global `cordova.file`.\n\nAnche se in ambito globale, non è disponibile fino a dopo l'evento `deviceready`.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(cordova.file);\n }\n \n\n## Installazione\n\n cordova plugin add cordova-plugin-file\n \n\n## Piattaforme supportate\n\n * Amazon fuoco OS\n * Android\n * BlackBerry 10\n * Firefox OS\n * iOS\n * Windows Phone 7 e 8 *\n * Windows 8 *\n * Windows*\n * Browser\n\n\\* *These platforms do not support `FileReader.readAsArrayBuffer` nor `FileWriter.write(blob)`.*\n\n## Dove memorizzare i file\n\nA partire dalla v 1.2.0, vengono forniti gli URL per le directory importanti file di sistema. Ogni URL è nella forma *file:///path/to/spot/* e può essere convertito in un `DirectoryEntry` utilizzando `window.resolveLocalFileSystemURL()`.\n\n * `cordova.file.applicationDirectory`-Sola lettura directory dove è installato l'applicazione. (*iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.applicationStorageDirectory`-Directory radice di sandbox dell'applicazione; su iOS questa posizione è in sola lettura (ma sottodirectory specifiche [come `/Documents` ] sono di sola lettura). Tutti i dati contenuti all'interno è privato all'app. ( *iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.dataDirectory`-Archiviazione dati persistente e privati nella sandbox dell'applicazione utilizzando la memoria interna (su Android, se è necessario utilizzare la memoria esterna, utilizzare `.externalDataDirectory` ). IOS, questa directory non è sincronizzata con iCloud (utilizzare `.syncedDataDirectory` ). (*iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.cacheDirectory`-Directory per i file memorizzati nella cache di dati o qualsiasi file che app possibile ricreare facilmente. L'OS può eliminare questi file quando il dispositivo viene eseguito basso sull'archiviazione, tuttavia, apps non deve basarsi sul sistema operativo per cancellare i file qui. (*iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.externalApplicationStorageDirectory`-Spazio applicazione su storage esterno. (*Android*)\n\n * `cordova.file.externalDataDirectory`-Dove mettere i file di dati specifico app su storage esterno. (*Android*)\n\n * `cordova.file.externalCacheDirectory`-Cache applicazione su storage esterno. (*Android*)\n\n * `cordova.file.externalRootDirectory`-Radice di archiviazione esterna (scheda SD). (*Android*, *BlackBerry, 10*)\n\n * `cordova.file.tempDirectory`-Temp directory che l'OS è possibile cancellare a volontà. Non fare affidamento sul sistema operativo per cancellare questa directory; l'app deve sempre rimuovere file come applicabile. (*iOS*)\n\n * `cordova.file.syncedDataDirectory`-Contiene i file app specifiche che devono essere sincronizzati (per esempio a iCloud). (*iOS*)\n\n * `cordova.file.documentsDirectory`-I file privati per le app, ma che sono significativi per altre applicazioni (ad esempio i file di Office). (*iOS*)\n\n * `cordova.file.sharedDirectory`-File disponibili globalmente a tutte le applicazioni (*BlackBerry 10*)\n\n## Layout dei file di sistema\n\nAnche se tecnicamente un dettaglio di implementazione, può essere molto utile per conoscere come le proprietà `cordova.file.*` mappa di percorsi fisici su un dispositivo reale.\n\n### iOS File sistema Layout\n\n| Percorso dispositivo | `Cordova.file.*` | `iosExtraFileSystems` | r/w? | persistente? | OS cancella | sincronizzazione | privato |\n|:---------------------------------------------- |:--------------------------- |:--------------------- |:----:|:------------:|:------------:|:----------------:|:-------:|\n| `/ var/mobile/Applications/< UUID > /` | applicationStorageDirectory | - | r | N/A | N/A | N/A | Sì |\n| `appname.app/` | applicationDirectory | bundle | r | N/A | N/A | N/A | Sì |\n| `www/` | - | - | r | N/A | N/A | N/A | Sì |\n| `Documents/` | documentsDirectory | documenti | r/w | Sì | No | Sì | Sì |\n| `NoCloud/` | - | nosync-documenti | r/w | Sì | No | No | Sì |\n| `Library` | - | libreria | r/w | Sì | No | Sì? | Sì |\n| `NoCloud/` | dataDirectory | nosync-libreria | r/w | Sì | No | No | Sì |\n| `Cloud/` | syncedDataDirectory | - | r/w | Sì | No | Sì | Sì |\n| `Caches/` | cacheDirectory | cache | r/w | Sì * | Sì**\\* | No | Sì |\n| `tmp/` | tempDirectory | - | r/w | No** | Sì**\\* | No | Sì |\n\n\\ * File persistono tra riavvii app e aggiornamenti, ma questa directory può essere cancellata ogni volta che il sistema operativo desideri. L'app dovrebbe essere in grado di ricreare qualsiasi contenuto che potrebbe essere eliminato.\n\n** File possono persistere riavvii del app, ma non fare affidamento su questo comportamento. I file non sono garantiti a persistere attraverso gli aggiornamenti. L'app deve rimuovere i file dalla directory quando è applicabile, come il sistema operativo non garantisce quando (o anche se) questi file vengono rimossi.\n\n**\\ * The OS può cancellare il contenuto di questa directory ogni volta che si sente è necessario, ma non fare affidamento su questo. Si dovrebbe cancellare questa directory come adatto per l'applicazione.\n\n### Layout sistema Android File\n\n| Percorso dispositivo | `Cordova.file.*` | `AndroidExtraFileSystems` | r/w? | persistente? | OS cancella | privato |\n|:------------------------------------------------ |:----------------------------------- |:------------------------- |:----:|:------------:|:-----------:|:-------:|\n| `File:///android_asset/` | applicationDirectory | | r | N/A | N/A | Sì |\n| `< app-id > /dati/dati / /` | applicationStorageDirectory | - | r/w | N/A | N/A | Sì |\n| `cache` | cacheDirectory | cache | r/w | Sì | Sì\\* | Sì |\n| `files` | dataDirectory | file | r/w | Sì | No | Sì |\n| `Documents` | | documenti | r/w | Sì | No | Sì |\n| `< sdcard > /` | externalRootDirectory | sdcard | r/w | Sì | No | No |\n| `Android/data//` | externalApplicationStorageDirectory | - | r/w | Sì | No | No |\n| `cache` | externalCacheDirectry | cache-esterno | r/w | Sì | No** | No |\n| `files` | externalDataDirectory | file-esterno | r/w | Sì | No | No |\n\n\\ * Il sistema operativo può cancellare periodicamente questa directory, ma non fare affidamento su questo comportamento. Cancellare il contenuto di questa directory come adatto per l'applicazione. Il contenuto di questa directory dovrebbe un utente eliminare manualmente la cache, vengono rimossi.\n\n** Il sistema operativo non cancella questa directory automaticamente; Siete responsabili di gestire i contenuti da soli. Il contenuto della directory dovrebbe l'utente eliminare manualmente la cache, vengono rimossi.\n\n**Nota**: se la memorizzazione esterna non può essere montato, le proprietà `cordova.file.external*` sono `null`.\n\n### BlackBerry 10 File sistema Layout\n\n| Percorso dispositivo | `Cordova.file.*` | r/w? | persistente? | OS cancella | privato |\n|:----------------------------------------------------------- |:--------------------------- |:----:|:------------:|:-----------:|:-------:|\n| `File:///accounts/1000/AppData/ < id app > /` | applicationStorageDirectory | r | N/A | N/A | Sì |\n| `app/native` | applicationDirectory | r | N/A | N/A | Sì |\n| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | No | Sì | Sì |\n| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | Sì | No | Sì |\n| `File:///accounts/1000/Removable/sdcard` | externalRemovableDirectory | r/w | Sì | No | No |\n| `File:///accounts/1000/Shared` | sharedDirectory | r/w | Sì | No | No |\n\n*Nota*: quando l'applicazione viene distribuita a lavorare perimetrale, tutti i percorsi sono relativi a /accounts/1000-enterprise.\n\n## Stranezze Android\n\n### Posizione di archiviazione persistente Android\n\nCi sono più percorsi validi per memorizzare i file persistenti su un dispositivo Android. Vedi [questa pagina](http://developer.android.com/guide/topics/data/data-storage.html) per un'ampia discussione delle varie possibilità.\n\nVersioni precedenti del plugin avrebbe scelto il percorso dei file temporanei e permanenti su avvio, in base se il dispositivo ha sostenuto che la scheda SD (o partizione storage equivalente) è stato montato. Se è stata montata sulla scheda SD o una partizione di storage interno grande era disponibile (come sui dispositivi Nexus,) allora saranno memorizzati i file persistenti nella radice di quello spazio. Questo significava che tutte le apps di Cordova poteva vedere tutti i file disponibili sulla carta.\n\nSe la scheda SD non era disponibile, poi versioni precedenti vuoi memorizzare dati sotto `/data/data/`, che isola i apps da altro, ma può ancora causa dati da condividere tra gli utenti.\n\nOra è possibile scegliere se memorizzare i file nel percorso di archiviazione di file interno o utilizzando la logica precedente, con una preferenza nel file `config. xml` dell'applicazione. Per fare questo, aggiungere una di queste due linee al `file config. xml`:\n\n \n \n \n \n\nSenza questa linea, il File del plugin utilizzerà la `Compatibility` come predefinito. Se è presente un tag di preferenza e non è uno di questi valori, l'applicazione non si avvia.\n\nSe l'applicazione è stato spedito in precedenza agli utenti, utilizzando un vecchio (pre-1.0) versione di questo plugin e ha i file memorizzati nel filesystem persistente, allora si dovrebbe impostare la preferenza di `Compatibility`. La posizione su \"Interno\" di commutazione significherebbe che gli utenti esistenti che aggiornare la loro applicazione potrebbero essere Impossibile accedere ai loro file precedentemente memorizzati, a seconda del loro dispositivo.\n\nSe l'applicazione è nuova, o ha mai precedentemente memorizzati i file nel filesystem persistente, è generalmente consigliato l'impostazione `Internal`.\n\n### Operazioni ricorsive lento per /android_asset\n\nL'elencazione delle directory asset è veramente lento su Android. È possibile velocizzare e fino anche se, con l'aggiunta di `src/android/build-extras.gradle` alla radice del tuo progetto android (richiede anche cordova-android@4.0.0 o superiore).\n\n## iOS stranezze\n\n * `cordova.file.applicationStorageDirectory`è di sola lettura; tentativo di memorizzare i file all'interno della directory radice avrà esito negativo. Utilizzare uno degli altri `cordova.file.*` proprietà definite per iOS (solo `applicationDirectory` e `applicationStorageDirectory` sono di sola lettura).\n * `FileReader.readAsText(blob, encoding)` \n * Il `encoding` parametro non è supportato, e codifica UTF-8 è sempre attivo.\n\n### posizione di archiviazione persistente di iOS\n\nCi sono due percorsi validi per memorizzare i file persistenti su un dispositivo iOS: la directory documenti e la biblioteca. Precedenti versioni del plugin archiviati solo mai persistenti file nella directory documenti. Questo ha avuto l'effetto collaterale di tutti i file di un'applicazione che rende visibili in iTunes, che era spesso involontaria, soprattutto per le applicazioni che gestiscono un sacco di piccoli file, piuttosto che produrre documenti completi per l'esportazione, che è la destinazione della directory.\n\nOra è possibile scegliere se memorizzare i file nella directory di libreria, con una preferenza nel file `config. xml` dell'applicazione o documenti. Per fare questo, aggiungere una di queste due linee al `file config. xml`:\n\n \n \n \n \n\nSenza questa linea, il File del plugin utilizzerà la `Compatibility` come predefinito. Se è presente un tag di preferenza e non è uno di questi valori, l'applicazione non si avvia.\n\nSe l'applicazione è stato spedito in precedenza agli utenti, utilizzando un vecchio (pre-1.0) versione di questo plugin e ha i file memorizzati nel filesystem persistente, allora si dovrebbe impostare la preferenza di `Compatibility`. La posizione di commutazione alla `libreria` significherebbe che gli utenti esistenti che aggiornare la loro applicazione è in grado di accedere ai loro file precedentemente memorizzati.\n\nSe l'applicazione è nuova, o ha mai precedentemente memorizzati i file nel filesystem persistente, è generalmente consigliato l'impostazione della `Library`.\n\n## Firefox OS stranezze\n\nL'API di sistema del File non è supportato nativamente dal sistema operativo Firefox e viene implementato come uno spessore in cima indexedDB.\n\n * Non manca quando si rimuove le directory non vuota\n * Non supporta i metadati per le directory\n * Metodi `copyTo` e `moveTo` non supporta le directory\n\nSono supportati i seguenti percorsi di dati: * `applicationDirectory` - utilizza `xhr` per ottenere i file locali che sono confezionati con l'app. *`dataDirectory` - per i file di dati persistenti app specifiche. *`cacheDirectory` - file memorizzati nella cache che dovrebbe sopravvivere si riavvia app (applicazioni non devono basarsi sull'OS di eliminare i file qui).\n\n## Stranezze browser\n\n### Stranezze e osservazioni comuni\n\n * Ogni browser utilizza il proprio filesystem in modalità sandbox. IE e Firefox utilizzare IndexedDB come base. Tutti i browser utilizzano barra come separatore di directory in un percorso.\n * Le voci di directory devono essere creato successivamente. Ad esempio, la chiamata `fs.root.getDirectory (' dir1/dir2 ', {create:true}, successCallback, errorCallback)` non riuscirà se non esistesse dir1.\n * Il plugin richiede autorizzazione utente per utilizzare un archivio permanente presso il primo avvio dell'applicazione. \n * Plugin supporta `cdvfile://localhost` (risorse locali) solo. Cioè risorse esterne non sono supportate tramite `cdvfile`.\n * Il plugin non segue [\"Limitazioni di denominazione 8.3 File sistema API\"](http://www.w3.org/TR/2011/WD-file-system-api-20110419/#naming-restrictions).\n * BLOB e File' `close` la funzione non è supportata.\n * `FileSaver` e `BlobBuilder` non sono supportati da questo plugin e non hanno gli stub.\n * Il plugin non supporta `requestAllFileSystems`. Questa funzione manca anche nelle specifiche.\n * Entrate nella directory non verranno rimossi se si utilizza `create: true` bandiera per directory esistente.\n * Non sono supportati i file creati tramite il costruttore. È invece necessario utilizzare il metodo entry.file.\n * Ogni browser utilizza la propria forma per riferimenti URL blob.\n * `readAsDataURL` funzione è supportata, ma il mediatype in Chrome dipende dall'estensione di voce, mediatype in IE è sempre vuota (che è lo stesso come `text-plain` secondo la specifica), il mediatype in Firefox è sempre `application/octet-stream`. Ad esempio, se il contenuto è `abcdefg` quindi Firefox restituisce `dati: applicazione / octet-stream; base64, YWJjZGVmZw = =`, cioè restituisce `dati:; base64, YWJjZGVmZw = =`, Chrome restituisce `dati: < mediatype a seconda dell'estensione del nome della voce >; base64, YWJjZGVmZw = =`.\n * `toInternalURL` restituisce il percorso in forma `file:///persistent/path/to/entry` (Firefox, IE). Chrome restituisce il percorso nella forma `cdvfile://localhost/persistent/file`.\n\n### Stranezze di cromo\n\n * Cromo filesystem non è subito pronto dopo evento ready dispositivo. Come soluzione alternativa, è possibile iscriversi all'evento `filePluginIsReady`. Esempio: \n\n```javascript\nwindow.addEventListener('filePluginIsReady', function(){ console.log('File plugin is ready');}, false);\n```\n\nÈ possibile utilizzare la funzione `window.isFilePluginReadyRaised` per verificare se evento già è stato generato. -quote di filesystem TEMPORARY e PERSISTENT window.requestFileSystem non sono limitate in Chrome. -Per aumentare la memoria persistente in Chrome è necessario chiamare il metodo `window.initPersistentFileSystem`. Quota di archiviazione persistente è di 5 MB per impostazione predefinita. -Chrome richiede `-consentire-file-accesso-da-file` eseguire argomento a supporto API tramite protocollo `file:///`. -`File` oggetto non cambierà se si utilizza il flag `{create:true}` quando ottenendo un' esistente `entrata`. -eventi `cancelable` è impostata su true in Chrome. Ciò è in contrasto con la [specifica](http://dev.w3.org/2009/dap/file-system/file-writer.html). -funzione `toURL` Chrome restituisce `filesystem:`-premessi percorso a seconda dell'applicazione host. Ad esempio, `filesystem:file:///persistent/somefile.txt`, `filesystem:http://localhost:8080/persistent/somefile.txt`. -`toURL` risultato di funzione non contiene una barra finale in caso di voce di directory. Chrome risolve le directory con gli URL slash-trainati però correttamente. -`resolveLocalFileSystemURL` metodo richiede in ingresso `url` avere il prefisso del `file System`. Ad esempio, il parametro `url` per `resolveLocalFileSystemURL` dovrebbe essere nella forma `filesystem:file:///persistent/somefile.txt` in contrasto con la forma `file:///persistent/somefile.txt` in Android. -Obsoleto `toNativeURL` funzione non è supportata e non dispone di uno stub. -funzione `setMetadata` non è indicato nelle specifiche e non supportato. -INVALID_MODIFICATION_ERR (codice: 9) viene generata invece di SYNTAX_ERR(code: 8) su richiesta di un filesystem inesistente. -INVALID_MODIFICATION_ERR (codice: 9) viene generata invece di PATH_EXISTS_ERR(code: 12) sul tentativo di creare esclusivamente un file o una directory, che esiste già. -INVALID_MODIFICATION_ERR (codice: 9) viene generata invece di NO_MODIFICATION_ALLOWED_ERR(code: 6) sul tentativo di chiamare removeRecursively su file system root. -INVALID_MODIFICATION_ERR (codice: 9) viene generata invece di NOT_FOUND_ERR(code: 1) sul tentativo moveTo directory che non esiste.\n\n### Stranezze impl IndexedDB-basato (Firefox e IE)\n\n * `.` e `.` non sono supportati.\n * IE non supporta `file:///`-modalità; modalità solo ospitata è supportato (http://localhost:xxxx).\n * Dimensione filesystem Firefox non è limitata, ma ogni estensione 50MB sarà richiesta un'autorizzazione dell'utente. IE10 consente fino a 10mb di combinato AppCache e IndexedDB utilizzato nell'implementazione del filesystem senza chiedere conferma, una volta premuto quel livello che vi verrà chiesto se si desidera consentire ad essere aumentata fino a un max di 250 mb per ogni sito. Quindi la `size` parametro per la funzione `requestFileSystem` non influisce il filesystem in Firefox e IE.\n * `readAsBinaryString` funzione non è indicato nelle specifiche e non supportati in IE e non dispone di uno stub.\n * `file.Type` è sempre null.\n * Non è necessario creare la voce utilizzando il risultato del callback istanza DirectoryEntry che è stato eliminato. In caso contrario, si otterrà una 'voce di sospensione'.\n * Prima è possibile leggere un file che è stato appena scritto è necessario ottenere una nuova istanza di questo file.\n * supporta la funzione `setMetadata`, che non è indicato nelle specifiche `modificationTime` cambiamento di campo solo. \n * funzioni `copyTo` e `moveTo` non supporta le directory.\n * Le directory metadati non sono supportato.\n * Sia Entry.remove e directoryEntry.removeRecursively non fallire quando si rimuove le directory non vuota - directory da rimuovere vengono pulite invece insieme al contenuto.\n * `abort` e `truncate` le funzioni non sono supportate.\n * non vengono generati eventi di progresso. Ad esempio, questo gestore verrà non eseguito:\n\n```javascript\nwriter.onprogress = function() { /*commands*/ };\n```\n\n## Note di aggiornamento\n\nIn v 1.0.0 di questo plugin, le strutture `FileEntry` e `DirectoryEntry` sono cambiati, per essere più in linea con le specifiche pubblicate.\n\nVersioni precedenti (pre-1.0.0) del plugin archiviati il dispositivo-assoluto--percorso del file nella proprietà `fullPath` di oggetti della `voce`. In genere questi percorsi si sarebbe simile\n\n /var/mobile/Applications//Documents/path/to/file (iOS)\n /storage/emulated/0/path/to/file (Android)\n \n\nQuesti percorsi sono stati anche restituiti dal metodo `toURL()` degli oggetti `Entry`.\n\nCon v 1.0.0, l'attributo `fullPath` è il percorso del file, *rispetto alla radice del filesystem HTML*. Così, i percorsi sopra sarebbe ora sia rappresentato da un oggetto `FileEntry` con un `fullPath` di\n\n /path/to/file\n \n\nSe l'applicazione funziona con dispositivo-assoluto-percorsi, e precedentemente recuperato quei percorsi attraverso la proprietà `fullPath` della `voce` oggetti, è necessario aggiornare il codice per utilizzare `entry.toURL()` invece.\n\nPer indietro la compatibilità, il metodo `resolveLocalFileSystemURL()` verrà accettare un dispositivo-assoluto-percorso e restituirà un oggetto di `entrata` corrispondente ad essa, fintanto che il file esiste all'interno del filesystem la `temporanea` o `permanente`.\n\nQuesto particolare è stato un problema con il plugin di trasferimento File, che in precedenza utilizzati percorsi-dispositivo-assoluto (e ancora può accoglierli). Esso è stato aggiornato per funzionare correttamente con gli URL di FileSystem, così sostituendo `entry.fullPath` con `entry.toURL()` dovrebbe risolvere eventuali problemi ottenendo quel plugin per lavorare con i file nel dispositivo.\n\nIn v 1.1.0 il valore restituito di `toURL()` è stato cambiato (vedere \\[CB-6394\\] (https://issues.apache.org/jira/browse/CB-6394)) per restituire un URL assoluto 'file://'. ove possibile. Per assicurare un ' cdvfile:'-URL, è possibile utilizzare `toInternalURL()` ora. Questo metodo restituirà ora filesystem URL del modulo\n\n cdvfile://localhost/persistent/path/to/file\n \n\nche può essere utilizzato per identificare univocamente il file.\n\n## Elenco dei codici di errore e significati\n\nQuando viene generato un errore, uno dei seguenti codici da utilizzare.\n\n| Codice | Costante |\n| ------:|:----------------------------- |\n| 1 | `NOT_FOUND_ERR` |\n| 2 | `SECURITY_ERR` |\n| 3 | `ABORT_ERR` |\n| 4 | `NOT_READABLE_ERR` |\n| 5 | `ENCODING_ERR` |\n| 6 | `NO_MODIFICATION_ALLOWED_ERR` |\n| 7 | `INVALID_STATE_ERR` |\n| 8 | `SYNTAX_ERR` |\n| 9 | `INVALID_MODIFICATION_ERR` |\n| 10 | `QUOTA_EXCEEDED_ERR` |\n| 11 | `TYPE_MISMATCH_ERR` |\n| 12 | `PATH_EXISTS_ERR` |\n\n## Configurare il Plugin (opzionale)\n\nIl set di filesystem disponibili può essere configurato per ogni piattaforma. Sia iOS che Android riconoscere un Tag nel `file config. xml` che nomina il filesystem per essere installato. Per impostazione predefinita, tutte le radici del file system sono abilitate.\n\n \n \n \n\n### Android\n\n * `files`: directory di archiviazione di file interno dell'applicazione\n * `files-external`: directory di archiviazione dell'applicazione file esterno\n * `sdcard`: la directory di archiviazione di file esterni globale (questa è la radice della scheda SD, se uno è installato). È necessario disporre dell'autorizzazione `android.permission.WRITE_EXTERNAL_STORAGE` utilizzare questo.\n * `cache`: la cache interna directory applicazione\n * `cache-external`: directory di cache esterna dell'applicazione\n * `root`: il dispositivo intero filesystem\n\nAndroid supporta anche un filesystem speciale denominato \"documenti\", che rappresenta una sottodirectory \"/ documenti /\" all'interno del filesystem \"files\".\n\n### iOS\n\n * `library`: la directory dell'applicazione libreria\n * `documents`: la directory dell'applicazione documenti\n * `cache`: la Cache directory applicazione\n * `bundle`: bundle dell'applicazione; la posizione dell'app sul disco (sola lettura)\n * `root`: il dispositivo intero filesystem\n\nPer impostazione predefinita, la directory di libreria e documenti può essere sincronizzata a iCloud. È anche possibile richiedere due filesystem aggiuntivi, `library-nosync` e `documents-nosync`, che rappresentano una speciale directory non sincronizzati entro il `/Library` o filesystem `/Documents`."
},
{
"path": "plugins/cordova-plugin-file/doc/it/index.md",
"content": "\n\n# cordova-plugin-file\n\nQuesto plugin implementa un API File permettendo l'accesso di lettura/scrittura ai file che risiedono sul dispositivo.\n\nQuesto plugin si basa su diverse specifiche, tra cui: The HTML5 File API \n\nLe directory (ormai defunta) e il sistema delle estensioni più recenti: anche se la maggior parte del codice plugin è stato scritto quando una spec precedenti era corrente: \n\nImplementa inoltre FileWriter spec: \n\nPer l'utilizzo, fare riferimento a HTML5 Rocks' eccellente [articolo FileSystem.][1]\n\n [1]: http://www.html5rocks.com/en/tutorials/file/filesystem/\n\nPer una panoramica delle altre opzioni di archiviazione, consultare [Guida di archiviazione di Cordova][2].\n\n [2]: http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html\n\nQuesto plugin definisce oggetto global `cordova.file`.\n\nAnche se in ambito globale, non è disponibile fino a dopo l'evento `deviceready`.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(cordova.file);\n }\n \n\n## Installazione\n\n cordova plugin add cordova-plugin-file\n \n\n## Piattaforme supportate\n\n* Amazon fuoco OS\n* Android\n* BlackBerry 10\n* Firefox OS\n* iOS\n* Windows Phone 7 e 8 *\n* Windows 8 *\n* Browser\n\n* *Queste piattaforme non supportano `FileReader.readAsArrayBuffer` né `FileWriter.write(blob)`.*\n\n## Dove memorizzare i file\n\nA partire dalla v 1.2.0, vengono forniti gli URL per le directory importanti file di sistema. Ogni URL è nella forma *file:///path/to/spot/* e può essere convertito in un `DirectoryEntry` utilizzando `window.resolveLocalFileSystemURL()`.\n\n* `cordova.file.applicationDirectory`-Sola lettura directory dove è installato l'applicazione. (*iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.applicationStorageDirectory`-Directory radice di sandbox dell'applicazione; su iOS questa posizione è in sola lettura (ma sottodirectory specifiche [come `/Documents` ] sono di sola lettura). Tutti i dati contenuti all'interno è privato all'app. ( *iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.dataDirectory`-Archiviazione dati persistente e privati nella sandbox dell'applicazione utilizzando la memoria interna (su Android, se è necessario utilizzare la memoria esterna, utilizzare `.externalDataDirectory` ). IOS, questa directory non è sincronizzata con iCloud (utilizzare `.syncedDataDirectory` ). (*iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.cacheDirectory`-Directory per i file memorizzati nella cache di dati o qualsiasi file che app possibile ricreare facilmente. L'OS può eliminare questi file quando il dispositivo viene eseguito basso sull'archiviazione, tuttavia, apps non deve basarsi sul sistema operativo per cancellare i file qui. (*iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.externalApplicationStorageDirectory`-Spazio applicazione su storage esterno. (*Android*)\n\n* `cordova.file.externalDataDirectory`-Dove mettere i file di dati specifico app su storage esterno. (*Android*)\n\n* `cordova.file.externalCacheDirectory`-Cache applicazione su storage esterno. (*Android*)\n\n* `cordova.file.externalRootDirectory`-Radice di archiviazione esterna (scheda SD). (*Android*, *BlackBerry, 10*)\n\n* `cordova.file.tempDirectory`-Temp directory che l'OS è possibile cancellare a volontà. Non fare affidamento sul sistema operativo per cancellare questa directory; l'app deve sempre rimuovere file come applicabile. (*iOS*)\n\n* `cordova.file.syncedDataDirectory`-Contiene i file app specifiche che devono essere sincronizzati (per esempio a iCloud). (*iOS*)\n\n* `cordova.file.documentsDirectory`-I file privati per le app, ma che sono significativi per altre applicazioni (ad esempio i file di Office). (*iOS*)\n\n* `cordova.file.sharedDirectory`-File disponibili globalmente a tutte le applicazioni (*BlackBerry 10*)\n\n## Layout dei file di sistema\n\nAnche se tecnicamente un dettaglio di implementazione, può essere molto utile per conoscere come le proprietà `cordova.file.*` mappa di percorsi fisici su un dispositivo reale.\n\n### iOS File sistema Layout\n\n| Percorso dispositivo | `Cordova.file.*` | `iosExtraFileSystems` | r/w? | persistente? | OS cancella | sincronizzazione | privato |\n|:-------------------------------------------- |:--------------------------- |:--------------------- |:----:|:------------:|:-----------:|:----------------:|:-------:|\n| `/ var/mobile/Applications/< UUID > /` | applicationStorageDirectory | - | r | N/A | N/A | N/A | Sì |\n| `appname.app/` | applicationDirectory | bundle | r | N/A | N/A | N/A | Sì |\n| `www/` | - | - | r | N/A | N/A | N/A | Sì |\n| `Documents/` | documentsDirectory | documenti | r/w | Sì | No | Sì | Sì |\n| `NoCloud/` | - | nosync-documenti | r/w | Sì | No | No | Sì |\n| `Library` | - | libreria | r/w | Sì | No | Sì? | Sì |\n| `NoCloud/` | dataDirectory | nosync-libreria | r/w | Sì | No | No | Sì |\n| `Cloud/` | syncedDataDirectory | - | r/w | Sì | No | Sì | Sì |\n| `Caches/` | cacheDirectory | cache | r/w | Sì * | Sì * * *| | No | Sì |\n| `tmp/` | tempDirectory | - | r/w | No * * | Sì * * *| | No | Sì |\n\n* File persistono attraverso riavvii app e aggiornamenti, ma questa directory può essere azzerata ogni volta che desideri l'OS. L'app dovrebbe essere in grado di ricreare qualsiasi contenuto che potrebbe essere eliminato.\n\n* * File può persistere attraverso app riavvii, ma non fare affidamento su questo comportamento. I file non sono garantiti a persistere attraverso gli aggiornamenti. L'app deve rimuovere i file dalla directory quando è applicabile, come il sistema operativo non garantisce quando (o anche se) questi file vengono rimossi.\n\n* * *| Il sistema operativo può cancellare il contenuto di questa directory ogni volta che si sente è necessario, ma non fare affidamento su questo. Si dovrebbe cancellare questa directory come adatto per l'applicazione.\n\n### Layout sistema Android File\n\n| Percorso dispositivo | `Cordova.file.*` | `AndroidExtraFileSystems` | r/w? | persistente? | OS cancella | privato |\n|:--------------------------------- |:----------------------------------- |:------------------------- |:----:|:------------:|:-----------:|:-------:|\n| `File:///android_asset/` | applicationDirectory | | r | N/A | N/A | Sì |\n| `< app-id > /dati/dati / /` | applicationStorageDirectory | - | r/w | N/A | N/A | Sì |\n| `cache` | cacheDirectory | cache | r/w | Sì | Sì * | Sì |\n| `files` | dataDirectory | file | r/w | Sì | No | Sì |\n| `Documents` | | documenti | r/w | Sì | No | Sì |\n| `< sdcard > /` | externalRootDirectory | sdcard | r/w | Sì | No | No |\n| `Android/data//` | externalApplicationStorageDirectory | - | r/w | Sì | No | No |\n| `cache` | externalCacheDirectry | cache-esterno | r/w | Sì | No * * | No |\n| `files` | externalDataDirectory | file-esterno | r/w | Sì | No | No |\n\n* Il sistema operativo può cancellare periodicamente questa directory, ma non fare affidamento su questo comportamento. Cancellare il contenuto di questa directory come adatto per l'applicazione. Il contenuto di questa directory dovrebbe un utente eliminare manualmente la cache, vengono rimossi.\n\n* * Il sistema operativo non cancella questa directory automaticamente; Tu sei responsabile per la gestione dei contenuti da soli. Il contenuto della directory dovrebbe l'utente eliminare manualmente la cache, vengono rimossi.\n\n**Nota**: se la memorizzazione esterna non può essere montato, le proprietà `cordova.file.external*` sono `null`.\n\n### BlackBerry 10 File sistema Layout\n\n| Percorso dispositivo | `Cordova.file.*` | r/w? | persistente? | OS cancella | privato |\n|:--------------------------------------------------- |:--------------------------- |:----:|:------------:|:-----------:|:-------:|\n| `File:///accounts/1000/AppData/ < id app > /` | applicationStorageDirectory | r | N/A | N/A | Sì |\n| `app/native` | applicationDirectory | r | N/A | N/A | Sì |\n| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | No | Sì | Sì |\n| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | Sì | No | Sì |\n| `File:///accounts/1000/Removable/sdcard` | externalRemovableDirectory | r/w | Sì | No | No |\n| `File:///accounts/1000/Shared` | sharedDirectory | r/w | Sì | No | No |\n\n*Nota*: quando l'applicazione viene distribuita a lavorare perimetrale, tutti i percorsi sono relativi a /accounts/1000-enterprise.\n\n## Stranezze Android\n\n### Posizione di archiviazione persistente Android\n\nCi sono più percorsi validi per memorizzare i file persistenti su un dispositivo Android. Vedi [questa pagina][3] per un'ampia discussione delle varie possibilità.\n\n [3]: http://developer.android.com/guide/topics/data/data-storage.html\n\nVersioni precedenti del plugin avrebbe scelto il percorso dei file temporanei e permanenti su avvio, in base se il dispositivo ha sostenuto che la scheda SD (o partizione storage equivalente) è stato montato. Se è stata montata sulla scheda SD o una partizione di storage interno grande era disponibile (come sui dispositivi Nexus,) allora saranno memorizzati i file persistenti nella radice di quello spazio. Questo significava che tutte le apps di Cordova poteva vedere tutti i file disponibili sulla carta.\n\nSe la scheda SD non era disponibile, poi versioni precedenti vuoi memorizzare dati sotto `/data/data/`, che isola i apps da altro, ma può ancora causa dati da condividere tra gli utenti.\n\nOra è possibile scegliere se memorizzare i file nel percorso di archiviazione di file interno o utilizzando la logica precedente, con una preferenza nel file `config. xml` dell'applicazione. Per fare questo, aggiungere una di queste due linee al `file config. xml`:\n\n \n \n \n \n\nSenza questa linea, il File del plugin utilizzerà la `Compatibility` come predefinito. Se è presente un tag di preferenza e non è uno di questi valori, l'applicazione non si avvia.\n\nSe l'applicazione è stato spedito in precedenza agli utenti, utilizzando un vecchio (pre-1.0) versione di questo plugin e ha i file memorizzati nel filesystem persistente, allora si dovrebbe impostare la preferenza di `Compatibility`. La posizione su \"Interno\" di commutazione significherebbe che gli utenti esistenti che aggiornare la loro applicazione potrebbero essere Impossibile accedere ai loro file precedentemente memorizzati, a seconda del loro dispositivo.\n\nSe l'applicazione è nuova, o ha mai precedentemente memorizzati i file nel filesystem persistente, è generalmente consigliato l'impostazione `Internal`.\n\n## iOS stranezze\n\n* `cordova.file.applicationStorageDirectory`è di sola lettura; tentativo di memorizzare i file all'interno della directory radice avrà esito negativo. Utilizzare uno degli altri `cordova.file.*` proprietà definite per iOS (solo `applicationDirectory` e `applicationStorageDirectory` sono di sola lettura).\n* `FileReader.readAsText(blob, encoding)` \n * Il `encoding` parametro non è supportato, e codifica UTF-8 è sempre attivo.\n\n### posizione di archiviazione persistente di iOS\n\nCi sono due percorsi validi per memorizzare i file persistenti su un dispositivo iOS: la directory documenti e la biblioteca. Precedenti versioni del plugin archiviati solo mai persistenti file nella directory documenti. Questo ha avuto l'effetto collaterale di tutti i file di un'applicazione che rende visibili in iTunes, che era spesso involontaria, soprattutto per le applicazioni che gestiscono un sacco di piccoli file, piuttosto che produrre documenti completi per l'esportazione, che è la destinazione della directory.\n\nOra è possibile scegliere se memorizzare i file nella directory di libreria, con una preferenza nel file `config. xml` dell'applicazione o documenti. Per fare questo, aggiungere una di queste due linee al `file config. xml`:\n\n \n \n \n \n\nSenza questa linea, il File del plugin utilizzerà la `Compatibility` come predefinito. Se è presente un tag di preferenza e non è uno di questi valori, l'applicazione non si avvia.\n\nSe l'applicazione è stato spedito in precedenza agli utenti, utilizzando un vecchio (pre-1.0) versione di questo plugin e ha i file memorizzati nel filesystem persistente, allora si dovrebbe impostare la preferenza di `Compatibility`. La posizione di commutazione alla `libreria` significherebbe che gli utenti esistenti che aggiornare la loro applicazione è in grado di accedere ai loro file precedentemente memorizzati.\n\nSe l'applicazione è nuova, o ha mai precedentemente memorizzati i file nel filesystem persistente, è generalmente consigliato l'impostazione della `Library`.\n\n## Firefox OS stranezze\n\nL'API di sistema del File non è supportato nativamente dal sistema operativo Firefox e viene implementato come uno spessore in cima indexedDB.\n\n* Non manca quando si rimuove le directory non vuota\n* Non supporta i metadati per le directory\n* Metodi `copyTo` e `moveTo` non supporta le directory\n\nSono supportati i seguenti percorsi di dati: * `applicationDirectory` - utilizza `xhr` per ottenere i file locali che sono confezionati con l'app. *`dataDirectory` - per i file di dati persistenti app specifiche. *`cacheDirectory` - file memorizzati nella cache che dovrebbe sopravvivere si riavvia app (applicazioni non devono basarsi sull'OS di eliminare i file qui).\n\n## Stranezze browser\n\n### Stranezze e osservazioni comuni\n\n* Ogni browser utilizza il proprio filesystem in modalità sandbox. IE e Firefox utilizzare IndexedDB come base. Tutti i browser utilizzano barra come separatore di directory in un percorso.\n* Le voci di directory devono essere creato successivamente. Ad esempio, la chiamata `fs.root.getDirectory (' dir1/dir2 ', {create:true}, successCallback, errorCallback)` non riuscirà se non esistesse dir1.\n* Il plugin richiede autorizzazione utente per utilizzare un archivio permanente presso il primo avvio dell'applicazione. \n* Plugin supporta `cdvfile://localhost` (risorse locali) solo. Cioè risorse esterne non sono supportate tramite `cdvfile`.\n* Il plugin non segue [\"Limitazioni di denominazione 8.3 File sistema API\"][4].\n* BLOB e File' `close` la funzione non è supportata.\n* `FileSaver` e `BlobBuilder` non sono supportati da questo plugin e non hanno gli stub.\n* Il plugin non supporta `requestAllFileSystems`. Questa funzione manca anche nelle specifiche.\n* Entrate nella directory non verranno rimossi se si utilizza `create: true` bandiera per directory esistente.\n* Non sono supportati i file creati tramite il costruttore. È invece necessario utilizzare il metodo entry.file.\n* Ogni browser utilizza la propria forma per riferimenti URL blob.\n* `readAsDataURL` funzione è supportata, ma il mediatype in Chrome dipende dall'estensione di voce, mediatype in IE è sempre vuota (che è lo stesso come `text-plain` secondo la specifica), il mediatype in Firefox è sempre `application/octet-stream`. Ad esempio, se il contenuto è `abcdefg` quindi Firefox restituisce `dati: applicazione / octet-stream; base64, YWJjZGVmZw = =`, cioè restituisce `dati:; base64, YWJjZGVmZw = =`, Chrome restituisce `dati: < mediatype a seconda dell'estensione del nome della voce >; base64, YWJjZGVmZw = =`.\n* `toInternalURL` restituisce il percorso in forma `file:///persistent/path/to/entry` (Firefox, IE). Chrome restituisce il percorso nella forma `cdvfile://localhost/persistent/file`.\n\n [4]: http://www.w3.org/TR/2011/WD-file-system-api-20110419/#naming-restrictions\n\n### Stranezze di cromo\n\n* Cromo filesystem non è subito pronto dopo evento ready dispositivo. Come soluzione alternativa, è possibile iscriversi all'evento `filePluginIsReady`. Esempio: \n\n javascript\n window.addEventListener('filePluginIsReady', function(){ console.log('File plugin is ready');}, false);\n \n\nÈ possibile utilizzare la funzione `window.isFilePluginReadyRaised` per verificare se evento già è stato generato. -quote di filesystem TEMPORARY e PERSISTENT window.requestFileSystem non sono limitate in Chrome. -Per aumentare la memoria persistente in Chrome è necessario chiamare il metodo `window.initPersistentFileSystem`. Quota di archiviazione persistente è di 5 MB per impostazione predefinita. -Chrome richiede `-consentire-file-accesso-da-file` eseguire argomento a supporto API tramite protocollo `file:///`. -`File` oggetto non cambierà se si utilizza il flag `{create:true}` quando ottenendo un' esistente `entrata`. -eventi `cancelable` è impostata su true in Chrome. Ciò è in contrasto con la [specifica][5]. -funzione `toURL` Chrome restituisce `filesystem:`-premessi percorso a seconda dell'applicazione host. Ad esempio, `filesystem:file:///persistent/somefile.txt`, `filesystem:http://localhost:8080/persistent/somefile.txt`. -`toURL` risultato di funzione non contiene una barra finale in caso di voce di directory. Chrome risolve le directory con gli URL slash-trainati però correttamente. -`resolveLocalFileSystemURL` metodo richiede in ingresso `url` avere il prefisso del `file System`. Ad esempio, il parametro `url` per `resolveLocalFileSystemURL` dovrebbe essere nella forma `filesystem:file:///persistent/somefile.txt` in contrasto con la forma `file:///persistent/somefile.txt` in Android. -Obsoleto `toNativeURL` funzione non è supportata e non dispone di uno stub. -funzione `setMetadata` non è indicato nelle specifiche e non supportato. -INVALID_MODIFICATION_ERR (codice: 9) viene generata invece di SYNTAX_ERR(code: 8) su richiesta di un filesystem inesistente. -INVALID_MODIFICATION_ERR (codice: 9) viene generata invece di PATH_EXISTS_ERR(code: 12) sul tentativo di creare esclusivamente un file o una directory, che esiste già. -INVALID_MODIFICATION_ERR (codice: 9) viene generata invece di NO_MODIFICATION_ALLOWED_ERR(code: 6) sul tentativo di chiamare removeRecursively su file system root. -INVALID_MODIFICATION_ERR (codice: 9) viene generata invece di NOT_FOUND_ERR(code: 1) sul tentativo moveTo directory che non esiste.\n\n [5]: http://dev.w3.org/2009/dap/file-system/file-writer.html\n\n### Stranezze impl IndexedDB-basato (Firefox e IE)\n\n* `.` e `.` non sono supportati.\n* IE non supporta `file:///`-modalità; modalità solo ospitata è supportato (http://localhost:xxxx).\n* Dimensione filesystem Firefox non è limitata, ma ogni estensione 50MB sarà richiesta un'autorizzazione dell'utente. IE10 consente fino a 10mb di combinato AppCache e IndexedDB utilizzato nell'implementazione del filesystem senza chiedere conferma, una volta premuto quel livello che vi verrà chiesto se si desidera consentire ad essere aumentata fino a un max di 250 mb per ogni sito. Quindi la `size` parametro per la funzione `requestFileSystem` non influisce il filesystem in Firefox e IE.\n* `readAsBinaryString` funzione non è indicato nelle specifiche e non supportati in IE e non dispone di uno stub.\n* `file.Type` è sempre null.\n* Non è necessario creare la voce utilizzando il risultato del callback istanza DirectoryEntry che è stato eliminato. In caso contrario, si otterrà una 'voce di sospensione'.\n* Prima è possibile leggere un file che è stato appena scritto è necessario ottenere una nuova istanza di questo file.\n* supporta la funzione `setMetadata`, che non è indicato nelle specifiche `modificationTime` cambiamento di campo solo. \n* funzioni `copyTo` e `moveTo` non supporta le directory.\n* Le directory metadati non sono supportato.\n* Sia Entry.remove e directoryEntry.removeRecursively non fallire quando si rimuove le directory non vuota - directory da rimuovere vengono pulite invece insieme al contenuto.\n* `abort` e `truncate` le funzioni non sono supportate.\n* non vengono generati eventi di progresso. Ad esempio, questo gestore verrà non eseguito:\n\n javascript\n writer.onprogress = function() { /*commands*/ };\n \n\n## Note di aggiornamento\n\nIn v 1.0.0 di questo plugin, le strutture `FileEntry` e `DirectoryEntry` sono cambiati, per essere più in linea con le specifiche pubblicate.\n\nVersioni precedenti (pre-1.0.0) del plugin archiviati il dispositivo-assoluto--percorso del file nella proprietà `fullPath` di oggetti della `voce`. In genere questi percorsi si sarebbe simile\n\n /var/mobile/Applications//Documents/path/to/file (iOS)\n /storage/emulated/0/path/to/file (Android)\n \n\nQuesti percorsi sono stati anche restituiti dal metodo `toURL()` degli oggetti `Entry`.\n\nCon v 1.0.0, l'attributo `fullPath` è il percorso del file, *rispetto alla radice del filesystem HTML*. Così, i percorsi sopra sarebbe ora sia rappresentato da un oggetto `FileEntry` con un `fullPath` di\n\n /path/to/file\n \n\nSe l'applicazione funziona con dispositivo-assoluto-percorsi, e precedentemente recuperato quei percorsi attraverso la proprietà `fullPath` della `voce` oggetti, è necessario aggiornare il codice per utilizzare `entry.toURL()` invece.\n\nPer indietro la compatibilità, il metodo `resolveLocalFileSystemURL()` verrà accettare un dispositivo-assoluto-percorso e restituirà un oggetto di `entrata` corrispondente ad essa, fintanto che il file esiste all'interno del filesystem la `temporanea` o `permanente`.\n\nQuesto particolare è stato un problema con il plugin di trasferimento File, che in precedenza utilizzati percorsi-dispositivo-assoluto (e ancora può accoglierli). Esso è stato aggiornato per funzionare correttamente con gli URL di FileSystem, così sostituendo `entry.fullPath` con `entry.toURL()` dovrebbe risolvere eventuali problemi ottenendo quel plugin per lavorare con i file nel dispositivo.\n\nIn v 1.1.0 il valore restituito di `toURL()` è stato cambiato (vedere \\[CB-6394\\] (https://issues.apache.org/jira/browse/CB-6394)) per restituire un URL assoluto 'file://'. ove possibile. Per assicurare un ' cdvfile:'-URL, è possibile utilizzare `toInternalURL()` ora. Questo metodo restituirà ora filesystem URL del modulo\n\n cdvfile://localhost/persistent/path/to/file\n \n\nche può essere utilizzato per identificare univocamente il file.\n\n## Elenco dei codici di errore e significati\n\nQuando viene generato un errore, uno dei seguenti codici da utilizzare.\n\n| Codice | Costante |\n| ------:|:----------------------------- |\n| 1 | `NOT_FOUND_ERR` |\n| 2 | `SECURITY_ERR` |\n| 3 | `ABORT_ERR` |\n| 4 | `NOT_READABLE_ERR` |\n| 5 | `ENCODING_ERR` |\n| 6 | `NO_MODIFICATION_ALLOWED_ERR` |\n| 7 | `INVALID_STATE_ERR` |\n| 8 | `SYNTAX_ERR` |\n| 9 | `INVALID_MODIFICATION_ERR` |\n| 10 | `QUOTA_EXCEEDED_ERR` |\n| 11 | `TYPE_MISMATCH_ERR` |\n| 12 | `PATH_EXISTS_ERR` |\n\n## Configurare il Plugin (opzionale)\n\nIl set di filesystem disponibili può essere configurato per ogni piattaforma. Sia iOS che Android riconoscere un Tag nel `file config. xml` che nomina il filesystem per essere installato. Per impostazione predefinita, tutte le radici del file system sono abilitate.\n\n \n \n \n\n### Android\n\n* `files`: directory di archiviazione di file interno dell'applicazione\n* `files-external`: directory di archiviazione dell'applicazione file esterno\n* `sdcard`: la directory di archiviazione di file esterni globale (questa è la radice della scheda SD, se uno è installato). È necessario disporre dell'autorizzazione `android.permission.WRITE_EXTERNAL_STORAGE` utilizzare questo.\n* `cache`: la cache interna directory applicazione\n* `cache-external`: directory di cache esterna dell'applicazione\n* `root`: il dispositivo intero filesystem\n\nAndroid supporta anche un filesystem speciale denominato \"documenti\", che rappresenta una sottodirectory \"/ documenti /\" all'interno del filesystem \"files\".\n\n### iOS\n\n* `library`: la directory dell'applicazione libreria\n* `documents`: la directory dell'applicazione documenti\n* `cache`: la Cache directory applicazione\n* `bundle`: bundle dell'applicazione; la posizione dell'app sul disco (sola lettura)\n* `root`: il dispositivo intero filesystem\n\nPer impostazione predefinita, la directory di libreria e documenti può essere sincronizzata a iCloud. È anche possibile richiedere due filesystem aggiuntivi, `library-nosync` e `documents-nosync`, che rappresentano una speciale directory non sincronizzati entro il `/Library` o filesystem `/Documents`.\n"
},
{
"path": "plugins/cordova-plugin-file/doc/it/plugins.md",
"content": "\n\n# Note per gli sviluppatori di plugin\n\nQueste note sono destinate principalmente per gli sviluppatori di Android e iOS che vogliono scrivere plugin quale interfaccia con il sistema di file utilizzando il File plugin.\n\n## Lavorando con URL di sistema file di Cordova\n\nDalla versione 1.0.0, questo plugin ha utilizzato gli URL con un `cdvfile` schema per tutte le comunicazioni oltre il ponte, piuttosto che esporre i percorsi del file system di dispositivo raw a JavaScript.\n\nSul lato JavaScript, questo significa che gli oggetti FileEntry e DirectoryEntry dispongano di un attributo fullPath che è relativo alla directory principale del sistema di file HTML. Se API JavaScript del vostro plugin accetta un oggetto FileEntry o DirectoryEntry, è necessario chiamare `.toURL()` su quell'oggetto prima di passarlo attraverso il ponte in codice nativo.\n\n### Conversione cdvfile: / / URL ai percorsi fileystem\n\nPlugin che hanno bisogno di scrivere il filesystem può essere necessario convertire un URL di sistema del file ricevuto in un percorso effettivo filesystem. Ci sono diversi modi di fare questo, a seconda della piattaforma nativa.\n\nÈ importante ricordare che non tutti i `cdvfile://` URL sono mappabili ai veri file sul dispositivo. Alcuni URL può riferirsi a beni sul dispositivo che non sono rappresentate da file, o possono anche fare riferimento a risorse remote. A causa di queste possibilità, plugin dovrebbe sempre verificare se ottengono un risultato significativo indietro quando si tenta di convertire gli URL in percorsi.\n\n#### Android\n\nSu Android, il metodo più semplice per convertire un `cdvfile://` URL a un percorso di file System è quello di utilizzare `org.apache.cordova.CordovaResourceApi` . `CordovaResourceApi`dispone di diversi metodi che è possono gestire `cdvfile://` URL:\n\n webView è un membro del Plugin classe CordovaResourceApi resourceApi = webView.getResourceApi();\n \n Ottenere un URL file:/// che rappresenta questo file sul dispositivo, / / o lo stesso URL invariata se non può essere mappato a un file Uri fileURL = resourceApi.remapUri(Uri.parse(cdvfileURL));\n \n\nÈ anche possibile utilizzare direttamente il File plugin:\n\n importazione org.apache.cordova.file.FileUtils;\n importazione org.apache.cordova.file.FileSystem;\n importazione java.net.MalformedURLException;\n \n Ottenere il File plugin dal gestore plugin FileUtils filePlugin = (FileUtils)webView.pluginManager.getPlugin(\"File\");\n \n Dato un URL, ottenere un percorso per esso prova {String path = filePlugin.filesystemPathForURL(cdvfileURL);}} catch (MalformedURLException e) {/ / l'url del file System non è stato riconosciuto}\n \n\nConvertire da un percorso a un `cdvfile://` URL:\n\n importazione org.apache.cordova.file.LocalFilesystemURL;\n \n Ottenere un oggetto LocalFilesystemURL per un percorso di dispositivo, / / oppure null se non può essere rappresentata come un URL di cdvfile.\n LocalFilesystemURL url = filePlugin.filesystemURLforLocalPath(path);\n Ottenere la rappresentazione di stringa dell'URL oggetto String cdvfileURL = url.toString();\n \n\nSe il vostro plugin crea un file e si desidera restituire un oggetto FileEntry per esso, utilizzare il File plugin:\n\n Restituire una struttura JSON appropriato per restituire a JavaScript, / / o null se questo file non è rappresentabile come un URL di cdvfile.\n Voce di JSONObject = filePlugin.getEntryForFile(file);\n \n\n#### iOS\n\nCordova su iOS non utilizza lo stesso `CordovaResourceApi` concetto come Android. Su iOS, si dovrebbe utilizzare il plugin File per convertire tra URL e percorsi di file System.\n\n Ottenere un oggetto CDVFilesystem URL da una stringa CDVFilesystemURL * url = [CDVFilesystemURL fileSystemURLWithString:cdvfileURL];\n Ottenere un percorso per l'oggetto URL, o zero se non può essere mappato a un percorso di file NSString * = [filePlugin filesystemPathForURL:url];\n \n \n Ottenere un oggetto CDVFilesystem URL per un percorso di dispositivo, o / / nullo se non può essere rappresentata come un URL di cdvfile.\n CDVFilesystemURL * url = [filePlugin fileSystemURLforLocalPath:path];\n Ottenere la rappresentazione di stringa dell'URL oggetto NSString * cdvfileURL = [absoluteString url];\n \n\nSe il vostro plugin crea un file e si desidera restituire un oggetto FileEntry per esso, utilizzare il File plugin:\n\n Ottenere un oggetto CDVFilesystem URL per un percorso di dispositivo, o / / nullo se non può essere rappresentata come un URL di cdvfile.\n CDVFilesystemURL * url = [filePlugin fileSystemURLforLocalPath:path];\n Ottenere una struttura per tornare alla voce JavaScript NSDictionary * = [filePlugin makeEntryForLocalURL:url]\n \n\n#### JavaScript\n\nIn JavaScript, per ottenere un `cdvfile://` URL da un oggetto FileEntry o DirectoryEntry, semplicemente chiamare `.toURL()` su di esso:\n\n var cdvfileURL = entry.toURL();\n \n\nNei gestori di risposta del plugin, per convertire da una struttura FileEntry restituita in un oggetto reale di voce, il codice del gestore dovrebbe importare il File plugin e creare un nuovo oggetto:\n\n creare la voce appropriata a voce oggetto var;\n Se (entryStruct.isDirectory) {voce = new DirectoryEntry (entryStruct.name, entryStruct.fullPath, nuovo FileSystem(entryStruct.filesystemName));} altro {voce = FileEntry nuovo (entryStruct.name, entryStruct.fullPath, nuovo FileSystem(entryStruct.filesystemName));}"
},
{
"path": "plugins/cordova-plugin-file/doc/ja/README.md",
"content": "\n\n# cordova-plugin-file\n\n[](https://travis-ci.org/apache/cordova-plugin-file)\n\nこのプラグインは、デバイス上のファイルへの読み取り/書き込みアクセスを許可するファイル API を実装します。\n\nこのプラグインを含む、いくつかの仕様に基づいています：、HTML5 File API の\n\n（今は亡き) ディレクトリとシステムは、最新の拡張機能: プラグインのコードのほとんどはときに、以前の仕様に書かれていたが現在は： \n\nFileWriter 仕様も実装しています: \n\n使用法を参照してください HTML5 岩 ' 優秀な[ファイルシステム記事](http://www.html5rocks.com/en/tutorials/file/filesystem/)。\n\n他のストレージ オプションの概要については、コルドバの[ストレージ ・ ガイド](http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html)を参照してください。.\n\nこのプラグインでは、グローバル `cordova.file` オブジェクトを定義します。\n\nグローバル スコープではあるがそれがないまで `deviceready` イベントの後です。\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(cordova.file);\n }\n \n\n## インストール\n\n cordova plugin add cordova-plugin-file\n \n\n## サポートされているプラットフォーム\n\n * アマゾン火 OS\n * アンドロイド\n * ブラックベリー 10\n * Firefox の OS\n * iOS\n * Windows Phone 7 と 8 *\n * Windows 8 *\n * Windows*\n * ブラウザー\n\n\\* *These platforms do not support `FileReader.readAsArrayBuffer` nor `FileWriter.write(blob)`.*\n\n## ファイルを保存する場所\n\nV1.2.0、現在重要なファイル システム ディレクトリへの Url を提供しています。 各 URL はフォーム *file:///path/to/spot/* で、`window.resolveLocalFileSystemURL()` を使用する `DirectoryEntry` に変換することができます。.\n\n * `cordova.file.applicationDirectory`-読み取り専用のディレクトリは、アプリケーションがインストールされています。（*iOS*、*アンドロイド*、*ブラックベリー 10*)\n\n * `cordova.file.applicationStorageDirectory`-アプリケーションのサンド ボックス; のルート ディレクトリiOS でこの場所が読み取り専用 （特定のサブディレクトリが [のような `/Documents` ] は、読み取り/書き込み)。 内に含まれるすべてのデータは、アプリケーションにプライベートです。 （ *iOS*、*アンドロイド*、*ブラックベリー 10*)\n\n * `cordova.file.dataDirectory`内部メモリを使用して、アプリケーションのサンド ボックス内で永続なプライベート データ ストレージ （外部メモリを使用する必要がある場合使用して Android 上で `.externalDataDirectory` )。 IOS は、このディレクトリは iCloud と同期されません (使用する `.syncedDataDirectory` )。 （*iOS*、*アンドロイド*、*ブラックベリー 10*)\n\n * `cordova.file.cacheDirectory`-キャッシュされたデータ ファイルやアプリに簡単に再作成できる任意のファイルのディレクトリ。 ストレージ デバイスが不足したときに、OS がこれらのファイルを削除可能性があります、それにもかかわらず、アプリはここにファイルを削除する OS に依存しないでください。 （*iOS*、*アンドロイド*、*ブラックベリー 10*)\n\n * `cordova.file.externalApplicationStorageDirectory`外部ストレージのアプリケーション領域。（*アンドロイド*)\n\n * `cordova.file.externalDataDirectory`-外部ストレージ上のアプリ固有のデータ ファイルを配置する場所。（*アンドロイド*)\n\n * `cordova.file.externalCacheDirectory`外部ストレージにアプリケーション キャッシュ。（*アンドロイド*)\n\n * `cordova.file.externalRootDirectory`-外部ストレージ (SD カード) ルート。（*アンドロイド*、*ブラックベリー 10*)\n\n * `cordova.file.tempDirectory`-OS をクリアすることができます temp ディレクトリが。 このディレクトリ; オフに OS に依存しません。アプリが常に該当するファイルを削除します。 (*iOS*)\n\n * `cordova.file.syncedDataDirectory`-（例えば iCloud) に同期する必要がありますアプリケーション固有のファイルを保持します。(*iOS*)\n\n * `cordova.file.documentsDirectory`-ファイル、アプリケーションにプライベートは他のアプリケーション (Office ファイルなど） を意味です。(*iOS*)\n\n * `cordova.file.sharedDirectory`すべてのアプリケーション (*ブラックベリー 10*にグローバルに使用できるファイル)\n\n## ファイル ・ システム ・ レイアウト\n\n技術的に実装の詳細、非常にどのように `cordova.file.*` プロパティは、実際のデバイス上の物理パスにマップを知っておくと便利することができます。\n\n### iOS ファイル システムのレイアウト\n\n| デバイス ・ パス | `cordova.file.*` | `iosExtraFileSystems` | r/w ですか？ | 永続的なですか？ | OS を消去します | 同期 | プライベート |\n|:---------------------------------------------- |:--------------------------- |:--------------------- |:--------:|:---------:|:------------:|:------:|:------:|\n| `/var/モバイル/アプリケーション/< UUID >/` | applicationStorageDirectory | - | r | N/A | N/A | N/A | はい |\n| `appname.app/` | ディレクトリ | バンドル | r | N/A | N/A | N/A | はい |\n| `www/` | - | - | r | N/A | N/A | N/A | はい |\n| `Documents/` | documentsDirectory | ドキュメント | r/w | はい | いいえ | はい | はい |\n| `NoCloud/` | - | ドキュメント nosync | r/w | はい | いいえ | いいえ | はい |\n| `Library` | - | ライブラリ | r/w | はい | いいえ | はいですか？ | はい |\n| `NoCloud/` | dataDirectory | ライブラリ nosync | r/w | はい | いいえ | いいえ | はい |\n| `Cloud/` | syncedDataDirectory | - | r/w | はい | いいえ | はい | はい |\n| `Caches/` | cacheDirectory | キャッシュ | r/w | はい * | はい**\\* | いいえ | はい |\n| `tmp/` | tempDirectory | - | r/w | いいえ** | はい**\\* | いいえ | はい |\n\n\\ * アプリ再起動やアップグレード、永続化ファイルしますが、OS を希望するたびに、このディレクトリを削除することができます。アプリは削除可能性があります任意のコンテンツを再現することができるはず。\n\n**ファイルはアプリ再起動の間続くことがありますが、この動作に依存しないでください。 ファイルは、更新を維持するは保証されません。 アプリが該当する場合このディレクトリからファイルを削除する必要があります、これらのファイルが削除されるとき (または場合でも)、OS は保証しません。\n\n**\\ * OS はそれ、必要だと感じているときにこのディレクトリの内容を消去可能性があります、これに依存しないようにします。 この適切なディレクトリに、アプリケーションをオフにする必要があります。\n\n### 人造人間ファイル ・ システム ・ レイアウト\n\n| デバイス ・ パス | `cordova.file.*` | `AndroidExtraFileSystems` | r/w ですか？ | 永続的なですか？ | OS を消去します | プライベート |\n|:------------------------------------------------ |:----------------------------------- |:------------------------- |:--------:|:--------:|:---------:|:------:|\n| `file:///android_asset/` | ディレクトリ | | r | N/A | N/A | はい |\n| `/データ/データ/< app id >/` | applicationStorageDirectory | - | r/w | N/A | N/A | はい |\n| `cache` | cacheDirectory | キャッシュ | r/w | はい | はい\\ * | はい |\n| `files` | dataDirectory | ファイル | r/w | はい | いいえ | はい |\n| `Documents` | | ドキュメント | r/w | はい | いいえ | はい |\n| `< sd カード >/` | externalRootDirectory | sd カード | r/w | はい | いいえ | いいえ |\n| `Android/data//` | externalApplicationStorageDirectory | - | r/w | はい | いいえ | いいえ |\n| `cache` | externalCacheDirectry | 外部キャッシュ | r/w | はい | いいえ** | いいえ |\n| `files` | externalDataDirectory | 外部ファイル | r/w | はい | いいえ | いいえ |\n\n\\ * OS は定期的にこのディレクトリを消去可能性がありますが、この動作に依存しないでください。 アプリケーションの必要に応じてこのディレクトリの内容をオフにします。 ユーザーは手動でキャッシュを削除する必要があります、このディレクトリの内容が削除されます。\n\n** OS はこのディレクトリを自動的にはクリアされません内容を自分で管理する責任があります。 ユーザは手動でキャッシュを消去する必要があります、ディレクトリの内容が削除されます。\n\n**注**: 外部記憶装置をマウントできない場合は、`cordova.file.external*` プロパティを `null`.\n\n### ブラックベリー 10 ファイル ・ システム ・ レイアウト\n\n| デバイス ・ パス | `cordova.file.*` | r/w ですか？ | 永続的なですか？ | OS を消去します | プライベート |\n|:----------------------------------------------------------- |:--------------------------- |:--------:|:--------:|:---------:|:------:|\n| `file:///accounts/1000/appdata/< app id >/` | applicationStorageDirectory | r | N/A | N/A | はい |\n| `app/native` | ディレクトリ | r | N/A | N/A | はい |\n| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | いいえ | はい | はい |\n| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | はい | いいえ | はい |\n| `file:///accounts/1000/removable/sdcard` | externalRemovableDirectory | r/w | はい | いいえ | いいえ |\n| `file:///accounts/1000/shared` | sharedDirectory | r/w | はい | いいえ | いいえ |\n\n*注*: すべてのパスは/accounts/1000-enterprise 基準に境界を動作するようにアプリケーションを展開するとき。\n\n## Android の癖\n\n### Android の永続的なストレージの場所\n\nAndroid のデバイスに永続的なファイルを格納する複数の有効な場所があります。 さまざまな可能性について広範な議論のための [このページ](http://developer.android.com/guide/topics/data/data-storage.html) を参照してください。\n\n以前のバージョンのプラグインは、デバイスの SD カード （または同等のストレージ パーティション） マウントされていたと主張したかどうかに基づいて、起動時に一時と永続的なファイルの場所を選ぶでしょう。 SD カードがマウントされている場合、または大規模な内部ストレージ パーティションが利用可能な場合 (ようネクサス デバイス上） し、永続的なファイルは、その領域のルートに格納されます。 これはすべての Cordova アプリ見ることができる利用可能なファイルのすべてのカードに意味しました。\n\nSD カードがない場合、以前のバージョンがデータを格納する `/data/data/`、お互いからアプリを分離するが、まだ原因可能性がありますユーザー間で共有するデータ。\n\n内部ファイルの保存場所やアプリケーションの `config.xml` ファイルに優先順位を持つ以前のロジックを使用してファイルを保存するかどうかを選択することが可能です今。 これを行うに、`config.xml` に次の 2 行のいずれかを追加します。\n\n \n \n \n \n\nこの行がなければファイル プラグインはデフォルトとして `Compatibility` を使用します。優先タグが存在し、これらの値の 1 つではない場合、アプリケーションは起動しません。\n\nアプリケーションは、ユーザーに以前出荷されている場合、古い (前 1.0） を使用して、このプラグインのバージョンし、永続的なファイルシステムに保存されているファイルには `Compatibility` を設定する必要があります。 自分のアプリケーションをアップグレードする既存のユーザーを彼らの装置によって、以前に保存されたファイルにアクセスすることができることがあることを意味する「内部」に場所をスイッチングします。\n\nアプリケーションは、新しい、または永続的なファイルシステムにファイルが格納され以前は決して場合、`内部` 設定一般的に推奨されます。\n\n### /Android_asset の低速の再帰的な操作\n\nアセット ディレクトリの一覧表示は、人造人間本当に遅いです。 それをスピードアップすることができます`src/android/build-extras.gradle`を android プロジェクトのルートに追加することによって、最大 (また cordova-android@4.0.0 が必要ですまたはそれ以上)。\n\n## iOS の癖\n\n * `cordova.file.applicationStorageDirectory`読み取り専用;ルート ディレクトリ内のファイルを保存しようは失敗します。 他の 1 つを使用して `cordova.file.*` iOS のため定義されているプロパティ (のみ `applicationDirectory` と `applicationStorageDirectory` は読み取り専用)。\n * `FileReader.readAsText(blob, encoding)` \n * `encoding`パラメーターはサポートされていませんし、utf-8 エンコーディングが常に有効です。\n\n### iOS の永続的なストレージの場所\n\nIOS デバイスに永続的なファイルを格納する 2 つの有効な場所がある: ドキュメントとライブラリのディレクトリ。 プラグインの以前のバージョンは、唯一のこれまでドキュメント ディレクトリに永続的なファイルを格納されます。 これは、ディレクトリの目的は、輸出のための完全なドキュメントを作成するのではなくなかったがしばしば意図されていたり、特に多数の小さいファイルを処理するアプリケーションの場合、iTunes に表示されているすべてのアプリケーションのファイルを作るの副作用があった。\n\nドキュメントまたはアプリケーションの `config.xml` ファイルに優先順位のライブラリ ディレクトリにファイルを保存するかどうかを選択することが可能です今。 これを行うに、`config.xml` に次の 2 行のいずれかを追加します。\n\n \n \n \n \n\nこの行がなければファイル プラグインはデフォルトとして `Compatibility` を使用します。優先タグが存在し、これらの値の 1 つではない場合、アプリケーションは起動しません。\n\nアプリケーションは、ユーザーに以前出荷されている場合、古い (前 1.0） を使用して、このプラグインのバージョンし、永続的なファイルシステムに保存されているファイルには `Compatibility` を設定する必要があります。 自分のアプリケーションをアップグレードする既存のユーザーを以前に保存されたファイルにアクセスすることができるだろうことを意味する `Library` に場所をスイッチングします。\n\nアプリケーションは、新しい、または永続的なファイルシステムにファイルが格納され以前は決して場合、`Library` 設定一般的に推奨されます。\n\n## Firefox OS 癖\n\nファイル システム API Firefox OS でネイティブ サポートされていないと、indexedDB の上にシムとして実装されています。\n\n * 空でないディレクトリを削除するときに失敗しません\n * ディレクトリのメタデータをサポートしていません\n * 方法 `copyTo` と `moveTo` ディレクトリをサポートしていません\n\n次のデータ パスがサポートされています: * `applicationDirectory` - `xhr` を使用して、アプリケーションと共にパッケージ化されるローカル ファイルを取得します。 * `dataDirectory` - 永続的なアプリケーション固有のデータ ファイル。 * `cacheDirectory` - アプリケーションの再起動後も維持する必要がありますキャッシュ ファイル (アプリはここにファイルを削除する OS に依存しないでください)。\n\n## ブラウザーの癖\n\n### 共通の癖と発言\n\n * 各ブラウザーはサンド ボックス化されたファイルシステムを使用します。IE と Firefox IndexedDB をベースとして使用します。すべてのブラウザーは、パスにディレクトリの区切り記号としてスラッシュを使用します。\n * ディレクトリ エントリは連続して作成されなければなりません。 たとえば、コール `fs.root.getDirectory ('dir1 dir2'、{create:true}、successCallback、解り)` dir1 が存在しなかった場合は失敗します。\n * プラグインは、永続的なストレージ アプリケーションの最初の起動時に使用するユーザーのアクセス許可を要求します。 \n * プラグインは、`cdvfile://localhost` (ローカル リソース) をサポートしているだけです。すなわち外部リソースは、`cdvfile` を介してサポートされていません.\n * プラグインに [制限」のファイル システム API の 8.3 命名規則](http://www.w3.org/TR/2011/WD-file-system-api-20110419/#naming-restrictions) に従っていません。.\n * Blob およびファイル ' `close` 関数はサポートされていません。\n * `FileSaver` と `BlobBuilder` このプラグインでサポートされていないスタブを持っていません。\n * プラグインは、`requestAllFileSystems` をサポートしません。この関数は、仕様で行方不明にも。\n * ディレクトリ内のエントリを使用すると削除されません `create: true` 既存ディレクトリのフラグ。\n * コンス トラクターで作成されたファイルはサポートされていません。代わりに entry.file メソッドを使用する必要があります。\n * 各ブラウザーは blob URL 参照の独自のフォームを使用します。\n * `readAsDataURL` 関数はサポートされてがクロムメッキで mediatype エントリ名の拡張子によって異なります、IE でメディアの種類は、常に空 （`text-plain` に従って、仕様と同じである）、Firefox でメディアの種類は常に `アプリケーションまたはオクテット-ストリーム`。 たとえば、コンテンツが場合 `abcdefg` し Firefox を返します `データ: アプリケーション/オクテット ストリーム、base64、YWJjZGVmZw = =`、すなわちを返します `データ:; base64、YWJjZGVmZw = =`、クロムを返します `データ: < エントリ名の拡張子によって mediatype >; base64、YWJjZGVmZw = =`.\n * `toInternalURL` フォーム `file:///persistent/path/to/entry` （Firefox、IE） のパスを返します。 クロムの `cdvfile://localhost/persistent/file` フォームのパスを返します.\n\n### クロムの癖\n\n * デバイスの準備ができているイベント後クローム ファイルシステムはすぐに準備ができています。回避策としては `filePluginIsReady` イベントにサブスクライブできます。例: \n\n```javascript\nwindow.addEventListener('filePluginIsReady', function(){ console.log('File plugin is ready');}, false);\n```\n\n`window.isFilePluginReadyRaised` 関数を使用して、イベントが既に発生したかどうかを確認できます。 -Chrome に window.requestFileSystem 一時と永続的なファイル ・ システムのクォータの制限はありません。 -クロム内の永続ストレージを増加する `window.initPersistentFileSystem` メソッドを呼び出す必要があります。 永続的な記憶域のクォータは、既定では 5 MB です。 クロムが必要です `--許可-ファイル-アクセス--ファイルから` `file:///` プロトコル経由でサポート API に引数を実行します。 -`ファイル` オブジェクト フラグを使用する場合ない変更されます `{create:true}` 既存の `エントリ` を取得するとき。 -イベント `cancelable` プロパティを設定するクロムの場合は true。 これは [仕様](http://dev.w3.org/2009/dap/file-system/file-writer.html) に反して。 -クロムメッキで `網` 関数を返します `ファイルシステム：`-アプリケーションのホストによってパスのプレフィックスします。 たとえば、`filesystem:file:///persistent/somefile.txt`、`filesystem:http://localhost:8080/persistent/somefile.txt`。 -`toURL` の関数の結果にはディレクトリ エントリ場合末尾にスラッシュが含まれていません。 クロムは、スラッシュ後塵 url を持つディレクトリが正しく解決されるも。 -`resolveLocalFileSystemURL` メソッドは、受信 `url` が `ファイルシステム` のプレフィックスが必要です。 たとえば、`resolveLocalFileSystemURL` の `url` パラメーター フォーム `filesystem:file:///persistent/somefile.txt` で人造人間フォーム `file:///persistent/somefile.txt` とは対照的にする必要があります。 -廃止された `toNativeURL` 関数はサポートされていません、スタブはありません。 -`setMetadata` 関数は、仕様に記載されていないありサポートされていません。 -INVALID_MODIFICATION_ERR （コード: 9) の代わりにスローされた SYNTAX_ERR(code: 8) の非実在しないファイルシステムの依頼を。 -INVALID_MODIFICATION_ERR （コード: 9) の代わりにスローされた PATH_EXISTS_ERR(code: 12)、排他的なファイルまたはディレクトリを作成しようとするが既に存在します。 -INVALID_MODIFICATION_ERR （コード: 9) の代わりにスローされた NO_MODIFICATION_ALLOWED_ERR(code: 6) ルート ・ ファイル ・ システムで removeRecursively を呼び出すをしようとして。 -INVALID_MODIFICATION_ERR （コード: 9) の代わりにスローされた NOT_FOUND_ERR(code: 1) [moveto] ディレクトリが存在しないをしようとして。\n\n### IndexedDB ベース インプレ癖 （Firefox と IE）\n\n * `.` `です。` はサポートされていません。\n * IE は `file:///` をサポートしていません-モード;ホスト モードのみがサポートされている (http://localhost:xxxx) です。\n * Firefox のファイルシステムのサイズは無制限ですが各 50 MB の拡張機能がユーザーのアクセス許可を要求します。 IE10 は最大 10 mb の複合 AppCache と IndexedDB を求めず、サイトごとに 250 mb の最大値まで増加を許可するかどうかをたずねられますそのレベルに当ればファイルシステムの実装で使用することができます。 `RequestFileSystem` 関数の `size` パラメーターは、Firefox と IE のファイルシステムには影響しません。\n * `readAsBinaryString` 関数の仕様に記載されていない、IE でサポートされていないと、スタブを持っていません。\n * `file.type` は、常に null です。\n * 削除された DirectoryEntry インスタンスのコールバックの結果を使用してエントリを作成しないでください。それ以外の場合は、'ハンギングのエントリ' が表示されます。\n * ちょうど書かれていた、ファイルを読むことができます前にこのファイルの新しいインスタンスを取得する必要があります。\n * `setMetadata` 関数は、仕様に記載されていない `modificationTime` フィールド変更のみをサポートします。 \n * `copyTo` と `moveTo` 関数ディレクトリをサポートしていません。\n * ディレクトリのメタデータはサポートされていません。\n * 両方の Entry.remove と directoryEntry.removeRecursively は空でないディレクトリを削除するときを失敗しない - 削除されるディレクトリ コンテンツと共にを掃除している代わりに。\n * `abort` し、`truncate` 機能はサポートされていません。\n * 進行状況イベントは起動しません。たとえば、このハンドラーがない実行されます。\n\n```javascript\nwriter.onprogress = function() { /*commands*/ };\n```\n\n## ノートをアップグレードします。\n\nこのプラグインのデベロッパー、公開された仕様に合うように、`認証` と `DirectoryEntry` の構造が変更されました。\n\nプラグインの前 (pre 1.0.0) バージョンはデバイス絶対ファイル場所 `エントリ` オブジェクトの `fullPath` プロパティに格納されます。これらのパスはようになります通常\n\n /var/mobile/Applications//Documents/path/to/file (iOS)\n /storage/emulated/0/path/to/file (Android)\n \n\nこれらのパスはまた `Entry` オブジェクトの `toURL()` メソッドによって返されます。\n\nデベロッパー、`fullPath` 属性は *HTML ファイルシステムのルートに対する相対パス* のファイルへのパス。 したがって、上記のパスは今両方の `fullPath` と `FileEntry` オブジェクトで表される\n\n /path/to/file\n \n\nデバイス絶対パスとアプリケーション動作以前 `Entry` オブジェクトの `fullPath` プロパティを使用してこれらのパスを取得した場合は、代わりに `entry.toURL()` を使用するコードを更新する必要があります。\n\n下位互換性、`resolveLocalFileSystemURL()` メソッドは、デバイス絶対パスを受け入れるし、は、`TEMPORARY` または `PERSISTENT` ファイル ・ システム内でそのファイルが存在する限り、それに対応する `Entry` オブジェクトを返します。\n\nこれは特に以前デバイス絶対パスを使用してファイル転送のプラグインで問題となっている （そしてまだそれらを受け入れることができます）。 それがデバイス上のファイルで動作するプラグインを得る問題を解決する必要があります `entry.toURL()` で `entry.fullPath` を置き換えるので、ファイルシステムの Url で正常に動作にアップデートされました。\n\nV1.1.0 の `toURL()` の戻り値に変更されました (\\[CB-6394\\] (https://issues.apache.org/jira/browse/CB-6394) を参照) を絶対 'file://' で始まる URL を返します。 可能な限り。 確保するために、' cdvfile:'-`toInternalURL()` を今すぐ使用できます URL。 このメソッドは、フォームのファイルシステムの Url を返します今\n\n cdvfile://localhost/persistent/path/to/file\n \n\nこれはファイルを一意に識別するために使用できます。\n\n## エラー コードと意味のリスト\n\nエラーがスローされると、次のコードのいずれかが使用されます。\n\n| コード | 定数 |\n| ---:|:----------------------------- |\n| 1 | `NOT_FOUND_ERR` |\n| 2 | `SECURITY_ERR` |\n| 3 | `ABORT_ERR` |\n| 4 | `NOT_READABLE_ERR` |\n| 5 | `ENCODING_ERR` |\n| 6 | `NO_MODIFICATION_ALLOWED_ERR` |\n| 7 | `INVALID_STATE_ERR` |\n| 8 | `SYNTAX_ERR` |\n| 9 | `INVALID_MODIFICATION_ERR` |\n| 10 | `QUOTA_EXCEEDED_ERR` |\n| 11 | `TYPE_MISMATCH_ERR` |\n| 12 | `PATH_EXISTS_ERR` |\n\n## (省略可能) プラグインを構成します。\n\n利用可能なファイルシステムのセットは構成されたプラットフォームをすることができます。IOS と Android の両方を認識します。 タグ `config.xml` をインストールするファイルシステムの名前します。既定では、すべてのファイル システムのルートが有効になります。\n\n \n \n \n\n### アンドロイド\n\n * `files`： アプリケーションの内部ファイルのストレージ ディレクトリ\n * `files-external`: アプリケーションの外部のファイルのストレージ ディレクトリ\n * `sdcard`：、グローバル外部ストレージ ディレクトリをファイル (これは SD カードのルートがインストールされている場合)。 これを使用するには、`android.permission.WRITE_EXTERNAL_STORAGE` 権限が必要です。\n * `cache`： アプリケーションの内部キャッシュ ディレクトリ\n * `cache-external`： 外部キャッシュのアプリケーションのディレクトリ\n * `root`： デバイス全体のファイルシステム\n\nアンドロイドを「ファイル」ファイルシステム内の\"ドキュメント/\"サブディレクトリを表す\"ドキュメント\"という名前の特殊なファイルシステムもサポートしています。\n\n### iOS\n\n * `library`: ライブラリのアプリケーションのディレクトリ\n * `documents`: ドキュメントのアプリケーションのディレクトリ\n * `cache`: キャッシュのアプリケーションのディレクトリ\n * `bundle`: アプリケーションバンドル;アプリ自体 (読み取りのみ) ディスク上の場所\n * `root`： デバイス全体のファイルシステム\n\n既定では、ライブラリとドキュメント ディレクトリを iCloud に同期できます。 2 つの追加のファイルシステム、`library-nosync` および `documents-nosync` を表す、特別な非同期ディレクトリ内を要求することもできます、`/Library` または `Documents/` ファイルシステム。"
},
{
"path": "plugins/cordova-plugin-file/doc/ja/index.md",
"content": "\n\n# cordova-plugin-file\n\nこのプラグインは、デバイス上のファイルへの読み取り/書き込みアクセスを許可するファイル API を実装します。\n\nこのプラグインを含む、いくつかの仕様に基づいています：、HTML5 File API の\n\n（今は亡き) ディレクトリとシステムは、最新の拡張機能: プラグインのコードのほとんどはときに、以前の仕様に書かれていたが現在は： \n\nFileWriter 仕様も実装しています: \n\n使用法を参照してください HTML5 岩 ' 優秀な[ファイルシステム記事][1]。\n\n [1]: http://www.html5rocks.com/en/tutorials/file/filesystem/\n\n他のストレージ オプションの概要については、コルドバの[ストレージ ・ ガイド][2]を参照してください。.\n\n [2]: http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html\n\nこのプラグインでは、グローバル `cordova.file` オブジェクトを定義します。\n\nグローバル スコープではあるがそれがないまで `deviceready` イベントの後です。\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(cordova.file);\n }\n \n\n## インストール\n\n cordova plugin add cordova-plugin-file\n \n\n## サポートされているプラットフォーム\n\n* アマゾン火 OS\n* アンドロイド\n* ブラックベリー 10\n* Firefox の OS\n* iOS\n* Windows Phone 7 と 8 *\n* Windows 8 *\n* ブラウザー\n\n* *`FileReader.readAsArrayBuffer` も `FileWriter.write(blob)` もこれらのプラットフォームはサポートしていません*。\n\n## ファイルを保存する場所\n\nV1.2.0、現在重要なファイル システム ディレクトリへの Url を提供しています。 各 URL はフォーム *file:///path/to/spot/* で、`window.resolveLocalFileSystemURL()` を使用する `DirectoryEntry` に変換することができます。.\n\n* `cordova.file.applicationDirectory`-読み取り専用のディレクトリは、アプリケーションがインストールされています。（*iOS*、*アンドロイド*、*ブラックベリー 10*)\n\n* `cordova.file.applicationStorageDirectory`-アプリケーションのサンド ボックス; のルート ディレクトリiOS でこの場所が読み取り専用 （特定のサブディレクトリが [のような `/Documents` ] は、読み取り/書き込み)。 内に含まれるすべてのデータは、アプリケーションにプライベートです。 （ *iOS*、*アンドロイド*、*ブラックベリー 10*)\n\n* `cordova.file.dataDirectory`内部メモリを使用して、アプリケーションのサンド ボックス内で永続なプライベート データ ストレージ （外部メモリを使用する必要がある場合使用して Android 上で `.externalDataDirectory` )。 IOS は、このディレクトリは iCloud と同期されません (使用する `.syncedDataDirectory` )。 （*iOS*、*アンドロイド*、*ブラックベリー 10*)\n\n* `cordova.file.cacheDirectory`-キャッシュされたデータ ファイルやアプリに簡単に再作成できる任意のファイルのディレクトリ。 ストレージ デバイスが不足したときに、OS がこれらのファイルを削除可能性があります、それにもかかわらず、アプリはここにファイルを削除する OS に依存しないでください。 （*iOS*、*アンドロイド*、*ブラックベリー 10*)\n\n* `cordova.file.externalApplicationStorageDirectory`外部ストレージのアプリケーション領域。（*アンドロイド*)\n\n* `cordova.file.externalDataDirectory`-外部ストレージ上のアプリ固有のデータ ファイルを配置する場所。（*アンドロイド*)\n\n* `cordova.file.externalCacheDirectory`外部ストレージにアプリケーション キャッシュ。（*アンドロイド*)\n\n* `cordova.file.externalRootDirectory`-外部ストレージ (SD カード) ルート。（*アンドロイド*、*ブラックベリー 10*)\n\n* `cordova.file.tempDirectory`-OS をクリアすることができます temp ディレクトリが。 このディレクトリ; オフに OS に依存しません。アプリが常に該当するファイルを削除します。 (*iOS*)\n\n* `cordova.file.syncedDataDirectory`-（例えば iCloud) に同期する必要がありますアプリケーション固有のファイルを保持します。(*iOS*)\n\n* `cordova.file.documentsDirectory`-ファイル、アプリケーションにプライベートは他のアプリケーション (Office ファイルなど） を意味です。(*iOS*)\n\n* `cordova.file.sharedDirectory`すべてのアプリケーション (*ブラックベリー 10*にグローバルに使用できるファイル)\n\n## ファイル ・ システム ・ レイアウト\n\n技術的に実装の詳細、非常にどのように `cordova.file.*` プロパティは、実際のデバイス上の物理パスにマップを知っておくと便利することができます。\n\n### iOS ファイル システムのレイアウト\n\n| デバイス ・ パス | `cordova.file.*` | `iosExtraFileSystems` | r/w ですか？ | 永続的なですか？ | OS を消去します | 同期 | プライベート |\n|:------------------------------------ |:--------------------------- |:--------------------- |:--------:|:--------:|:----------:|:------:|:------:|\n| `/var/モバイル/アプリケーション/< UUID >/` | applicationStorageDirectory | - | r | N/A | N/A | N/A | はい |\n| `appname.app/` | ディレクトリ | バンドル | r | N/A | N/A | N/A | はい |\n| `www/` | - | - | r | N/A | N/A | N/A | はい |\n| `Documents/` | documentsDirectory | ドキュメント | r/w | はい | いいえ | はい | はい |\n| `NoCloud/` | - | ドキュメント nosync | r/w | はい | いいえ | いいえ | はい |\n| `Library` | - | ライブラリ | r/w | はい | いいえ | はいですか？ | はい |\n| `NoCloud/` | dataDirectory | ライブラリ nosync | r/w | はい | いいえ | いいえ | はい |\n| `Cloud/` | syncedDataDirectory | - | r/w | はい | いいえ | はい | はい |\n| `Caches/` | cacheDirectory | キャッシュ | r/w | はい * | はい * * *| | いいえ | はい |\n| `tmp/` | tempDirectory | - | r/w | いいえ * * | はい * * *| | いいえ | はい |\n\n* アプリを再起動し、アップグレードとの間でファイルを保持が、OS を希望するたびにこのディレクトリを削除することができます。アプリを削除可能性があります任意のコンテンツを再作成することができる必要があります。\n\n* * ファイル アプリケーション再起動を渡って続くことがありますが、この動作に依存しないでください。 ファイルは、更新を維持するは保証されません。 アプリが該当する場合このディレクトリからファイルを削除する必要があります、これらのファイルが削除されるとき (または場合でも)、OS は保証しません。\n\n* * *| OS はそれ、必要だと感じているときにこのディレクトリの内容を消去可能性がありますが、これに依存しません。 この適切なディレクトリに、アプリケーションをオフにする必要があります。\n\n### 人造人間ファイル ・ システム ・ レイアウト\n\n| デバイス ・ パス | `cordova.file.*` | `AndroidExtraFileSystems` | r/w ですか？ | 永続的なですか？ | OS を消去します | プライベート |\n|:--------------------------------- |:----------------------------------- |:------------------------- |:--------:|:--------:|:---------:|:------:|\n| `file:///android_asset/` | ディレクトリ | | r | N/A | N/A | はい |\n| `/データ/データ/< app id >/` | applicationStorageDirectory | - | r/w | N/A | N/A | はい |\n| `cache` | cacheDirectory | キャッシュ | r/w | はい | はい * | はい |\n| `files` | dataDirectory | ファイル | r/w | はい | いいえ | はい |\n| `Documents` | | ドキュメント | r/w | はい | いいえ | はい |\n| `< sd カード >/` | externalRootDirectory | sd カード | r/w | はい | いいえ | いいえ |\n| `Android/data//` | externalApplicationStorageDirectory | - | r/w | はい | いいえ | いいえ |\n| `cache` | externalCacheDirectry | 外部キャッシュ | r/w | はい | いいえ * * | いいえ |\n| `files` | externalDataDirectory | 外部ファイル | r/w | はい | いいえ | いいえ |\n\n* OS このディレクトリを定期的に消去可能性がありますが、この動作に依存しないでください。 アプリケーションの必要に応じてこのディレクトリの内容をオフにします。 ユーザーは手動でキャッシュを削除する必要があります、このディレクトリの内容が削除されます。\n\n* * OS はこのディレクトリは自動的にクリアされません自分でコンテンツを管理するために責任があります。 ユーザは手動でキャッシュを消去する必要があります、ディレクトリの内容が削除されます。\n\n**注**: 外部記憶装置をマウントできない場合は、`cordova.file.external*` プロパティを `null`.\n\n### ブラックベリー 10 ファイル ・ システム ・ レイアウト\n\n| デバイス ・ パス | `cordova.file.*` | r/w ですか？ | 永続的なですか？ | OS を消去します | プライベート |\n|:------------------------------------------------- |:--------------------------- |:--------:|:--------:|:---------:|:------:|\n| `file:///accounts/1000/appdata/< app id >/` | applicationStorageDirectory | r | N/A | N/A | はい |\n| `app/native` | ディレクトリ | r | N/A | N/A | はい |\n| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | いいえ | はい | はい |\n| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | はい | いいえ | はい |\n| `file:///accounts/1000/removable/sdcard` | externalRemovableDirectory | r/w | はい | いいえ | いいえ |\n| `file:///accounts/1000/shared` | sharedDirectory | r/w | はい | いいえ | いいえ |\n\n*注*: すべてのパスは/accounts/1000-enterprise 基準に境界を動作するようにアプリケーションを展開するとき。\n\n## Android の癖\n\n### Android の永続的なストレージの場所\n\nAndroid のデバイスに永続的なファイルを格納する複数の有効な場所があります。 さまざまな可能性について広範な議論のための [このページ][3] を参照してください。\n\n [3]: http://developer.android.com/guide/topics/data/data-storage.html\n\n以前のバージョンのプラグインは、デバイスの SD カード （または同等のストレージ パーティション） マウントされていたと主張したかどうかに基づいて、起動時に一時と永続的なファイルの場所を選ぶでしょう。 SD カードがマウントされている場合、または大規模な内部ストレージ パーティションが利用可能な場合 (ようネクサス デバイス上） し、永続的なファイルは、その領域のルートに格納されます。 これはすべての Cordova アプリ見ることができる利用可能なファイルのすべてのカードに意味しました。\n\nSD カードがない場合、以前のバージョンがデータを格納する `/data/data/`、お互いからアプリを分離するが、まだ原因可能性がありますユーザー間で共有するデータ。\n\n内部ファイルの保存場所やアプリケーションの `config.xml` ファイルに優先順位を持つ以前のロジックを使用してファイルを保存するかどうかを選択することが可能です今。 これを行うに、`config.xml` に次の 2 行のいずれかを追加します。\n\n \n \n \n \n\nこの行がなければファイル プラグインはデフォルトとして `Compatibility` を使用します。優先タグが存在し、これらの値の 1 つではない場合、アプリケーションは起動しません。\n\nアプリケーションは、ユーザーに以前出荷されている場合、古い (前 1.0） を使用して、このプラグインのバージョンし、永続的なファイルシステムに保存されているファイルには `Compatibility` を設定する必要があります。 自分のアプリケーションをアップグレードする既存のユーザーを彼らの装置によって、以前に保存されたファイルにアクセスすることができることがあることを意味する「内部」に場所をスイッチングします。\n\nアプリケーションは、新しい、または永続的なファイルシステムにファイルが格納され以前は決して場合、`内部` 設定一般的に推奨されます。\n\n## iOS の癖\n\n* `cordova.file.applicationStorageDirectory`読み取り専用;ルート ディレクトリ内のファイルを保存しようは失敗します。 他の 1 つを使用して `cordova.file.*` iOS のため定義されているプロパティ (のみ `applicationDirectory` と `applicationStorageDirectory` は読み取り専用)。\n* `FileReader.readAsText(blob, encoding)` \n * `encoding`パラメーターはサポートされていませんし、utf-8 エンコーディングが常に有効です。\n\n### iOS の永続的なストレージの場所\n\nIOS デバイスに永続的なファイルを格納する 2 つの有効な場所がある: ドキュメントとライブラリのディレクトリ。 プラグインの以前のバージョンは、唯一のこれまでドキュメント ディレクトリに永続的なファイルを格納されます。 これは、ディレクトリの目的は、輸出のための完全なドキュメントを作成するのではなくなかったがしばしば意図されていたり、特に多数の小さいファイルを処理するアプリケーションの場合、iTunes に表示されているすべてのアプリケーションのファイルを作るの副作用があった。\n\nドキュメントまたはアプリケーションの `config.xml` ファイルに優先順位のライブラリ ディレクトリにファイルを保存するかどうかを選択することが可能です今。 これを行うに、`config.xml` に次の 2 行のいずれかを追加します。\n\n \n \n \n \n\nこの行がなければファイル プラグインはデフォルトとして `Compatibility` を使用します。優先タグが存在し、これらの値の 1 つではない場合、アプリケーションは起動しません。\n\nアプリケーションは、ユーザーに以前出荷されている場合、古い (前 1.0） を使用して、このプラグインのバージョンし、永続的なファイルシステムに保存されているファイルには `Compatibility` を設定する必要があります。 自分のアプリケーションをアップグレードする既存のユーザーを以前に保存されたファイルにアクセスすることができるだろうことを意味する `Library` に場所をスイッチングします。\n\nアプリケーションは、新しい、または永続的なファイルシステムにファイルが格納され以前は決して場合、`Library` 設定一般的に推奨されます。\n\n## Firefox OS 癖\n\nファイル システム API Firefox OS でネイティブ サポートされていないと、indexedDB の上にシムとして実装されています。\n\n* 空でないディレクトリを削除するときに失敗しません\n* ディレクトリのメタデータをサポートしていません\n* 方法 `copyTo` と `moveTo` ディレクトリをサポートしていません\n\n次のデータ パスがサポートされています: * `applicationDirectory` - `xhr` を使用して、アプリケーションと共にパッケージ化されるローカル ファイルを取得します。 * `dataDirectory` - 永続的なアプリケーション固有のデータ ファイル。 * `cacheDirectory` - アプリケーションの再起動後も維持する必要がありますキャッシュ ファイル (アプリはここにファイルを削除する OS に依存しないでください)。\n\n## ブラウザーの癖\n\n### 共通の癖と発言\n\n* 各ブラウザーはサンド ボックス化されたファイルシステムを使用します。IE と Firefox IndexedDB をベースとして使用します。すべてのブラウザーは、パスにディレクトリの区切り記号としてスラッシュを使用します。\n* ディレクトリ エントリは連続して作成されなければなりません。 たとえば、コール `fs.root.getDirectory ('dir1 dir2'、{create:true}、successCallback、解り)` dir1 が存在しなかった場合は失敗します。\n* プラグインは、永続的なストレージ アプリケーションの最初の起動時に使用するユーザーのアクセス許可を要求します。 \n* プラグインは、`cdvfile://localhost` (ローカル リソース) をサポートしているだけです。すなわち外部リソースは、`cdvfile` を介してサポートされていません.\n* プラグインに [制限」のファイル システム API の 8.3 命名規則][4] に従っていません。.\n* Blob およびファイル ' `close` 関数はサポートされていません。\n* `FileSaver` と `BlobBuilder` このプラグインでサポートされていないスタブを持っていません。\n* プラグインは、`requestAllFileSystems` をサポートしません。この関数は、仕様で行方不明にも。\n* ディレクトリ内のエントリを使用すると削除されません `create: true` 既存ディレクトリのフラグ。\n* コンス トラクターで作成されたファイルはサポートされていません。代わりに entry.file メソッドを使用する必要があります。\n* 各ブラウザーは blob URL 参照の独自のフォームを使用します。\n* `readAsDataURL` 関数はサポートされてがクロムメッキで mediatype エントリ名の拡張子によって異なります、IE でメディアの種類は、常に空 （`text-plain` に従って、仕様と同じである）、Firefox でメディアの種類は常に `アプリケーションまたはオクテット-ストリーム`。 たとえば、コンテンツが場合 `abcdefg` し Firefox を返します `データ: アプリケーション/オクテット ストリーム、base64、YWJjZGVmZw = =`、すなわちを返します `データ:; base64、YWJjZGVmZw = =`、クロムを返します `データ: < エントリ名の拡張子によって mediatype >; base64、YWJjZGVmZw = =`.\n* `toInternalURL` フォーム `file:///persistent/path/to/entry` （Firefox、IE） のパスを返します。 クロムの `cdvfile://localhost/persistent/file` フォームのパスを返します.\n\n [4]: http://www.w3.org/TR/2011/WD-file-system-api-20110419/#naming-restrictions\n\n### クロムの癖\n\n* デバイスの準備ができているイベント後クローム ファイルシステムはすぐに準備ができています。回避策としては `filePluginIsReady` イベントにサブスクライブできます。例: \n\n javascript\n window.addEventListener('filePluginIsReady', function(){ console.log('File plugin is ready');}, false);\n \n\n`window.isFilePluginReadyRaised` 関数を使用して、イベントが既に発生したかどうかを確認できます。 -Chrome に window.requestFileSystem 一時と永続的なファイル ・ システムのクォータの制限はありません。 -クロム内の永続ストレージを増加する `window.initPersistentFileSystem` メソッドを呼び出す必要があります。 永続的な記憶域のクォータは、既定では 5 MB です。 クロムが必要です `--許可-ファイル-アクセス--ファイルから` `file:///` プロトコル経由でサポート API に引数を実行します。 -`ファイル` オブジェクト フラグを使用する場合ない変更されます `{create:true}` 既存の `エントリ` を取得するとき。 -イベント `cancelable` プロパティを設定するクロムの場合は true。 これは [仕様][5] に反して。 -クロムメッキで `網` 関数を返します `ファイルシステム：`-アプリケーションのホストによってパスのプレフィックスします。 たとえば、`filesystem:file:///persistent/somefile.txt`、`filesystem:http://localhost:8080/persistent/somefile.txt`。 -`toURL` の関数の結果にはディレクトリ エントリ場合末尾にスラッシュが含まれていません。 クロムは、スラッシュ後塵 url を持つディレクトリが正しく解決されるも。 -`resolveLocalFileSystemURL` メソッドは、受信 `url` が `ファイルシステム` のプレフィックスが必要です。 たとえば、`resolveLocalFileSystemURL` の `url` パラメーター フォーム `filesystem:file:///persistent/somefile.txt` で人造人間フォーム `file:///persistent/somefile.txt` とは対照的にする必要があります。 -廃止された `toNativeURL` 関数はサポートされていません、スタブはありません。 -`setMetadata` 関数は、仕様に記載されていないありサポートされていません。 -INVALID_MODIFICATION_ERR （コード: 9) の代わりにスローされた SYNTAX_ERR(code: 8) の非実在しないファイルシステムの依頼を。 -INVALID_MODIFICATION_ERR （コード: 9) の代わりにスローされた PATH_EXISTS_ERR(code: 12)、排他的なファイルまたはディレクトリを作成しようとするが既に存在します。 -INVALID_MODIFICATION_ERR （コード: 9) の代わりにスローされた NO_MODIFICATION_ALLOWED_ERR(code: 6) ルート ・ ファイル ・ システムで removeRecursively を呼び出すをしようとして。 -INVALID_MODIFICATION_ERR （コード: 9) の代わりにスローされた NOT_FOUND_ERR(code: 1) [moveto] ディレクトリが存在しないをしようとして。\n\n [5]: http://dev.w3.org/2009/dap/file-system/file-writer.html\n\n### IndexedDB ベース インプレ癖 （Firefox と IE）\n\n* `.` `です。` はサポートされていません。\n* IE は `file:///` をサポートしていません-モード;ホスト モードのみがサポートされている (http://localhost:xxxx) です。\n* Firefox のファイルシステムのサイズは無制限ですが各 50 MB の拡張機能がユーザーのアクセス許可を要求します。 IE10 は最大 10 mb の複合 AppCache と IndexedDB を求めず、サイトごとに 250 mb の最大値まで増加を許可するかどうかをたずねられますそのレベルに当ればファイルシステムの実装で使用することができます。 `RequestFileSystem` 関数の `size` パラメーターは、Firefox と IE のファイルシステムには影響しません。\n* `readAsBinaryString` 関数の仕様に記載されていない、IE でサポートされていないと、スタブを持っていません。\n* `file.type` は、常に null です。\n* 削除された DirectoryEntry インスタンスのコールバックの結果を使用してエントリを作成しないでください。それ以外の場合は、'ハンギングのエントリ' が表示されます。\n* ちょうど書かれていた、ファイルを読むことができます前にこのファイルの新しいインスタンスを取得する必要があります。\n* `setMetadata` 関数は、仕様に記載されていない `modificationTime` フィールド変更のみをサポートします。 \n* `copyTo` と `moveTo` 関数ディレクトリをサポートしていません。\n* ディレクトリのメタデータはサポートされていません。\n* 両方の Entry.remove と directoryEntry.removeRecursively は空でないディレクトリを削除するときを失敗しない - 削除されるディレクトリ コンテンツと共にを掃除している代わりに。\n* `abort` し、`truncate` 機能はサポートされていません。\n* 進行状況イベントは起動しません。たとえば、このハンドラーがない実行されます。\n\n javascript\n writer.onprogress = function() { /*commands*/ };\n \n\n## ノートをアップグレードします。\n\nこのプラグインのデベロッパー、公開された仕様に合うように、`認証` と `DirectoryEntry` の構造が変更されました。\n\nプラグインの前 (pre 1.0.0) バージョンはデバイス絶対ファイル場所 `エントリ` オブジェクトの `fullPath` プロパティに格納されます。これらのパスはようになります通常\n\n /var/mobile/Applications//Documents/path/to/file (iOS)\n /storage/emulated/0/path/to/file (Android)\n \n\nこれらのパスはまた `Entry` オブジェクトの `toURL()` メソッドによって返されます。\n\nデベロッパー、`fullPath` 属性は *HTML ファイルシステムのルートに対する相対パス* のファイルへのパス。 したがって、上記のパスは今両方の `fullPath` と `FileEntry` オブジェクトで表される\n\n /path/to/file\n \n\nデバイス絶対パスとアプリケーション動作以前 `Entry` オブジェクトの `fullPath` プロパティを使用してこれらのパスを取得した場合は、代わりに `entry.toURL()` を使用するコードを更新する必要があります。\n\n下位互換性、`resolveLocalFileSystemURL()` メソッドは、デバイス絶対パスを受け入れるし、は、`TEMPORARY` または `PERSISTENT` ファイル ・ システム内でそのファイルが存在する限り、それに対応する `Entry` オブジェクトを返します。\n\nこれは特に以前デバイス絶対パスを使用してファイル転送のプラグインで問題となっている （そしてまだそれらを受け入れることができます）。 それがデバイス上のファイルで動作するプラグインを得る問題を解決する必要があります `entry.toURL()` で `entry.fullPath` を置き換えるので、ファイルシステムの Url で正常に動作にアップデートされました。\n\nV1.1.0 の `toURL()` の戻り値に変更されました (\\[CB-6394\\] (https://issues.apache.org/jira/browse/CB-6394) を参照) を絶対 'file://' で始まる URL を返します。 可能な限り。 確保するために、' cdvfile:'-`toInternalURL()` を今すぐ使用できます URL。 このメソッドは、フォームのファイルシステムの Url を返します今\n\n cdvfile://localhost/persistent/path/to/file\n \n\nこれはファイルを一意に識別するために使用できます。\n\n## エラー コードと意味のリスト\n\nエラーがスローされると、次のコードのいずれかが使用されます。\n\n| コード | 定数 |\n| ---:|:----------------------------- |\n| 1 | `NOT_FOUND_ERR` |\n| 2 | `SECURITY_ERR` |\n| 3 | `ABORT_ERR` |\n| 4 | `NOT_READABLE_ERR` |\n| 5 | `ENCODING_ERR` |\n| 6 | `NO_MODIFICATION_ALLOWED_ERR` |\n| 7 | `INVALID_STATE_ERR` |\n| 8 | `SYNTAX_ERR` |\n| 9 | `INVALID_MODIFICATION_ERR` |\n| 10 | `QUOTA_EXCEEDED_ERR` |\n| 11 | `TYPE_MISMATCH_ERR` |\n| 12 | `PATH_EXISTS_ERR` |\n\n## (省略可能) プラグインを構成します。\n\n利用可能なファイルシステムのセットは構成されたプラットフォームをすることができます。IOS と Android の両方を認識します。 タグ `config.xml` をインストールするファイルシステムの名前します。既定では、すべてのファイル システムのルートが有効になります。\n\n \n \n \n\n### アンドロイド\n\n* `files`： アプリケーションの内部ファイルのストレージ ディレクトリ\n* `files-external`: アプリケーションの外部のファイルのストレージ ディレクトリ\n* `sdcard`：、グローバル外部ストレージ ディレクトリをファイル (これは SD カードのルートがインストールされている場合)。 これを使用するには、`android.permission.WRITE_EXTERNAL_STORAGE` 権限が必要です。\n* `cache`： アプリケーションの内部キャッシュ ディレクトリ\n* `cache-external`： 外部キャッシュのアプリケーションのディレクトリ\n* `root`： デバイス全体のファイルシステム\n\nアンドロイドを「ファイル」ファイルシステム内の\"ドキュメント/\"サブディレクトリを表す\"ドキュメント\"という名前の特殊なファイルシステムもサポートしています。\n\n### iOS\n\n* `library`: ライブラリのアプリケーションのディレクトリ\n* `documents`: ドキュメントのアプリケーションのディレクトリ\n* `cache`: キャッシュのアプリケーションのディレクトリ\n* `bundle`: アプリケーションバンドル;アプリ自体 (読み取りのみ) ディスク上の場所\n* `root`： デバイス全体のファイルシステム\n\n既定では、ライブラリとドキュメント ディレクトリを iCloud に同期できます。 2 つの追加のファイルシステム、`library-nosync` および `documents-nosync` を表す、特別な非同期ディレクトリ内を要求することもできます、`/Library` または `Documents/` ファイルシステム。\n"
},
{
"path": "plugins/cordova-plugin-file/doc/ja/plugins.md",
"content": "\n\n# プラグイン開発者のためのメモ\n\nこれらのノートは主に Android と iOS 開発者インタ フェース ファイルのプラグインを使用してファイル システムでプラグインを書きたい人向け。\n\n## コルドバのファイル システムの Url での作業\n\nバージョン 1.0.0 では、以来、このプラグインを含む Url を使用する `cdvfile` JavaScript に raw デバイス ファイル システムのパスを公開するのではなく、橋の上のすべての通信方式します。\n\nJavaScript 側では、これはファイルと DirectoryEntry オブジェクトに HTML ファイル システムのルートを基準として、fullPath 属性があることを意味します。 あなたのプラグインの JavaScript API がファイルまたは DirectoryEntry オブジェクトを受け入れる場合を呼び出す必要があります `.toURL()` 橋を渡ってそれをネイティブ コードに渡す前にそのオブジェクトの。\n\n### Cdvfile に変換する://fileystem のパスに Url\n\nファイルシステムへの書き込みする必要があるプラグインは、実際のファイルシステムの場所に受信したファイル システム URL に変換する必要があります。ネイティブ プラットフォームによって、これを行うための複数の方法があります。\n\nそれを覚えていることが重要ですすべて `cdvfile://` の Url がデバイス上の実際のファイルをマッピング可能な。 いくつかの Url は、ファイルでは表されないまたはリモート リソースを参照することができますもデバイス上の資産を参照できます。 これらの可能性のためのプラグインは、戻るときにパスに Url を変換しようとして、彼らは意味のある結果を得るかどうか常にテスト必要があります。\n\n#### アンドロイド\n\nアンドロイド, に変換する最も簡単な方法で、 `cdvfile://` を使用するファイルシステムのパスに URL は `org.apache.cordova.CordovaResourceApi` 。 `CordovaResourceApi`扱うことができるいくつかの方法は、 `cdvfile://` の Url:\n\n webView プラグイン クラス CordovaResourceApi resourceApi のメンバーである = webView.getResourceApi()。\n \n デバイスでこのファイルを表す file:///URL を取得//ファイル Uri fileURL にマップできない場合、同じ URL は変更されません = resourceApi.remapUri(Uri.parse(cdvfileURL));\n \n\nまた、ファイルのプラグインを直接使用することが可能です。\n\n インポート org.apache.cordova.file.FileUtils;\n インポート org.apache.cordova.file.FileSystem;\n インポート java.net.MalformedURLException;\n \n プラグイン マネージャーからファイルのプラグインを入手してコマンド filePlugin = (FileUtils)webView.pluginManager.getPlugin(\"File\");\n \n それを試みるためにパスを取得 URL を指定すると、{文字列パス = filePlugin.filesystemPathForURL(cdvfileURL);} キャッチ (MalformedURLException e) {/ファイルシステムの url が認識されませんでした/}\n \n\nパスから変換する、 `cdvfile://` URL:\n\n インポート org.apache.cordova.file.LocalFilesystemURL;\n \n デバイス ・ パスの LocalFilesystemURL オブジェクトを取得//cdvfile URL として表現できない場合は null。\n LocalFilesystemURL url = filePlugin.filesystemURLforLocalPath(path);\n URL オブジェクトの文字列 cdvfileURL の文字列表現を取得する = url.toString();\n \n\nあなたのプラグインは、ファイルを作成しをファイル オブジェクトを返す場合、ファイルのプラグインを使用します。\n\n JavaScript を返すときに適した JSON 構造を返す//このファイルは cdvfile URL として表現できない場合は null。\n JSONObject エントリ = filePlugin.getEntryForFile(file);\n \n\n#### iOS\n\nIOS のコルドバは同じを使用しない `CordovaResourceApi` アンドロイドとしての概念。IOS では、Url とファイルシステムのパスの間を変換するファイル プラグインを使用する必要があります。\n\n URL の文字列 CDVFilesystemURL * url から CDVFilesystem URL オブジェクトを取得 [CDVFilesystemURL fileSystemURLWithString:cdvfileURL];\n ファイル NSString * パスにマップできない場合は nil または URL オブジェクトのパスを取得 [filePlugin filesystemPathForURL:url];\n \n \n デバイス ・ パスの CDVFilesystem の URL オブジェクトを取得または//cdvfile URL として表現できない場合は nil です。\n CDVFilesystemURL の url = [filePlugin fileSystemURLforLocalPath:path];\n URL オブジェクト NSString * cdvfileURL の文字列表現を取得する = [url absoluteString];\n \n\nあなたのプラグインは、ファイルを作成しをファイル オブジェクトを返す場合、ファイルのプラグインを使用します。\n\n デバイス ・ パスの CDVFilesystem の URL オブジェクトを取得または//cdvfile URL として表現できない場合は nil です。\n CDVFilesystemURL の url = [filePlugin fileSystemURLforLocalPath:path];\n JavaScript NSDictionary * エントリに戻る構造を得る = [filePlugin makeEntryForLocalURL:url]\n \n\n#### Java スクリプトの設定\n\nJava スクリプトの設定を取得するに、 `cdvfile://` ファイルまたは DirectoryEntry オブジェクトからの URL を呼び出して、 `.toURL()` それを。\n\n var cdvfileURL = entry.toURL();\n \n\nプラグイン応答ハンドラーに返された FileEntry 構造体の実際のエントリ オブジェクトを変換する、ハンドラーのコード ファイルのプラグインをインポート、新しいオブジェクトを作成します。\n\n 適切なエントリ オブジェクト var エントリを作成します。\n 場合 (entryStruct.isDirectory) {エントリ = 新しい DirectoryEntry (entryStruct.name、entryStruct.fullPath、新しい FileSystem(entryStruct.filesystemName));} 他 {エントリ = 新しいファイル (entryStruct.name、entryStruct.fullPath、新しい FileSystem(entryStruct.filesystemName));}"
},
{
"path": "plugins/cordova-plugin-file/doc/ko/README.md",
"content": "\n\n# cordova-plugin-file\n\n[](https://travis-ci.org/apache/cordova-plugin-file)\n\n이 플러그인은 장치에 있는 파일에 대 한 읽기/쓰기 액세스를 허용 하는 파일 API를 구현 합니다.\n\n이 플러그인을 포함 한 몇 가지 사양에 따라: HTML5 파일 API는 \n\n(지금은 없어진) 디렉터리와 시스템 확장 최신: 플러그인 코드의 대부분은 때 이전 사양 작성 되었습니다 있지만 현재는: \n\n그것은 또한 FileWriter 사양 구현: \n\n사용을 참조 하십시오 HTML5 바위 ' 우수한 [파일 시스템 문서.](http://www.html5rocks.com/en/tutorials/file/filesystem/)\n\n다른 저장소 옵션에 대 한 개요, 코르도바의 [저장소 가이드](http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html) 를 참조합니다.\n\n이 플러그인 글로벌 `cordova.file` 개체를 정의합니다.\n\n전역 범위에 있지만 그것은 불가능까지 `deviceready` 이벤트 후.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(cordova.file);\n }\n \n\n## 설치\n\n cordova plugin add cordova-plugin-file\n \n\n## 지원 되는 플랫폼\n\n * 아마존 화재 운영 체제\n * 안 드 로이드\n * 블랙베리 10\n * Firefox 운영 체제\n * iOS\n * Windows Phone 7과 8 *\n * 윈도우 8 *\n * Windows*\n * 브라우저\n\n\\* *These platforms do not support `FileReader.readAsArrayBuffer` nor `FileWriter.write(blob)`.*\n\n## 파일을 저장할 위치를\n\nV1.2.0, 현재 중요 한 파일 시스템 디렉터리에 Url도 제공 됩니다. 각 URL 형태 *file:///path/to/spot/* 이며 `DirectoryEntry` `window.resolveLocalFileSystemURL()`를 사용 하 여 변환할 수 있습니다..\n\n * `cordova.file.applicationDirectory`-읽기 전용 디렉터리는 응용 프로그램을 설치 합니다. (*iOS*, *안 드 로이드*, *블랙베리 10*)\n\n * `cordova.file.applicationStorageDirectory`응용 프로그램의 샌드박스;의 루트 디렉터리 iOS에이 위치에는 읽기 전용 (특정 하위 디렉토리만 [같은 `/Documents` ]은 읽기 / 쓰기). 포함 된 모든 데이터는 응용 프로그램에 전용. ( *iOS*, *안 드 로이드*, *블랙베리 10*)\n\n * `cordova.file.dataDirectory`-내부 메모리를 사용 하 여 응용 프로그램의 샌드박스 내에서 영구 및 개인 데이터 스토리지 (안 드 로이드, 외부 메모리를 사용 해야 하는 경우 사용 하 여 `.externalDataDirectory` ). IOS에이 디렉터리 iCloud와 동기화 되지 되 (를 사용 하 여 `.syncedDataDirectory` ). (*iOS*, *안 드 로이드*, *블랙베리 10*)\n\n * `cordova.file.cacheDirectory`-디렉터리 캐시 데이터 파일 또는 모든 파일을 당신의 app를 다시 쉽게 만들 수 있습니다. 운영 체제 장치 저장소 부족 하면 이러한 파일을 삭제할 수 있습니다, 그리고 그럼에도 불구 하 고, 애플 리 케이 션 여기에 파일을 삭제 하려면 운영 체제에 의존 하지 말아야 합니다. (*iOS*, *안 드 로이드*, *블랙베리 10*)\n\n * `cordova.file.externalApplicationStorageDirectory`-응용 프로그램 외부 저장 공간입니다. (*안 드 로이드*)\n\n * `cordova.file.externalDataDirectory`-외부 저장소에 응용 프로그램 특정 데이터 파일을 넣어 어디. (*안 드 로이드*)\n\n * `cordova.file.externalCacheDirectory`외부 저장소에 응용 프로그램 캐시입니다. (*안 드 로이드*)\n\n * `cordova.file.externalRootDirectory`-외부 저장 (SD 카드) 루트입니다. (*안 드 로이드*, *블랙베리 10*)\n\n * `cordova.file.tempDirectory`-운영 체제에서 지울 수 있습니다 임시 디렉터리 것입니다. 이 디렉터리;를 운영 체제에 의존 하지 마십시오 귀하의 응용 프로그램 항상 해당 하는 경우 파일을 제거 해야 합니다. (*iOS*)\n\n * `cordova.file.syncedDataDirectory`-(ICloud)를 예를 들어 동기화 해야 하는 응용 프로그램 관련 파일을 보유 하 고 있습니다. (*iOS*)\n\n * `cordova.file.documentsDirectory`-파일 애플 리 케이 션, 하지만 그 개인은 다른 응용 프로그램 (예: Office 파일)에 의미입니다. (*iOS*)\n\n * `cordova.file.sharedDirectory`-모든 응용 프로그램 (*블랙베리 10* 에 전세계적으로 사용 가능한 파일)\n\n## 파일 시스템 레이아웃\n\n하지만 구현 세부 사항을 기술적으로 `cordova.file.*` 속성 실제 장치에 실제 경로에 매핑하는 방법을 아는 것이 매우 유용할 수 있습니다.\n\n### iOS 파일 시스템 레이아웃\n\n| 장치 경로 | `cordova.file.*` | `iosExtraFileSystems` | r/w? | 영구? | OS 지웁니다 | 동기화 | 개인 |\n|:---------------------------------------------- |:--------------------------- |:--------------------- |:----:|:--------:|:-------------:|:---:|:--:|\n| `/ var/모바일/응용 프로그램/< UUID > /` | applicationStorageDirectory | - | r | N/A | N/A | N/A | 예 |\n| `appname.app/` | applicationDirectory | 번들 | r | N/A | N/A | N/A | 예 |\n| `www/` | - | - | r | N/A | N/A | N/A | 예 |\n| `Documents/` | documentsDirectory | 문서 | r/w | 예 | 없음 | 예 | 예 |\n| `NoCloud/` | - | 문서 nosync | r/w | 예 | 없음 | 없음 | 예 |\n| `Library` | - | 라이브러리 | r/w | 예 | 없음 | 그래? | 예 |\n| `NoCloud/` | dataDirectory | 라이브러리 nosync | r/w | 예 | 없음 | 없음 | 예 |\n| `Cloud/` | syncedDataDirectory | - | r/w | 예 | 없음 | 예 | 예 |\n| `Caches/` | cacheDirectory | 캐시 | r/w | 예 * | Yes**\\* | 없음 | 예 |\n| `tmp/` | tempDirectory | - | r/w | No** | Yes**\\* | 없음 | 예 |\n\n\\ * 파일 응용 프로그램 다시 시작 및 업그레이드, 유지 하지만 때마다 OS 욕망이 디렉터리를 지울 수 있습니다. 앱 삭제 될 수 있습니다 모든 콘텐츠를 다시 만들 수 있어야 합니다.\n\n** 파일 응용 프로그램 다시 시작에서 지속 될 수 있습니다 하지만이 동작에 의존 하지 마십시오. 파일 여러 업데이트를 보장 하지 않습니다. 때 해당 앱이이 디렉터리에서 파일을 제거 해야, 이러한 파일을 제거할 때 (또는 경우에도) 운영 체제 보증 하지 않습니다으로.\n\n**\\ * OS 그것이 필요를 느낀다 언제 든 지이 디렉터리의 내용을 취소 수 있습니다 하지만 이것에 의존 하지 마십시오. 이 디렉터리를 응용 프로그램에 대 한 적절 한 선택을 취소 해야 합니다.\n\n### 안 드 로이드 파일 시스템 레이아웃\n\n| 장치 경로 | `cordova.file.*` | `AndroidExtraFileSystems` | r/w? | 영구? | OS 지웁니다 | 개인 |\n|:------------------------------------------------ |:----------------------------------- |:------------------------- |:----:|:---:|:--------:|:--:|\n| `file:///android_asset/` | applicationDirectory | | r | N/A | N/A | 예 |\n| `/data/데이터/< app id > /` | applicationStorageDirectory | - | r/w | N/A | N/A | 예 |\n| `cache` | cacheDirectory | 캐시 | r/w | 예 | 예\\* | 예 |\n| `files` | dataDirectory | 파일 | r/w | 예 | 없음 | 예 |\n| `Documents` | | 문서 | r/w | 예 | 없음 | 예 |\n| `< sdcard > /` | externalRootDirectory | sdcard | r/w | 예 | 없음 | 없음 |\n| `Android/data//` | externalApplicationStorageDirectory | - | r/w | 예 | 없음 | 없음 |\n| `cache` | externalCacheDirectry | 외부 캐시 | r/w | 예 | 없음** | 없음 |\n| `files` | externalDataDirectory | 파일 외부 | r/w | 예 | 없음 | 없음 |\n\n\\ * 운영 체제 정기적으로이 디렉터리 삭제 수 있지만이 동작에 의존 하지 마십시오. 이 응용 프로그램이 디렉터리의 내용을 취소 합니다. 사용자 수동으로 캐시 제거 해야,이 디렉터리의 내용은 제거 됩니다.\n\n** 운영 체제 자동으로;이 디렉터리를 삭제 하지 않습니다 내용을 직접 관리에 대 한 책임이 있습니다. 사용자 수동으로 캐시 제거 합니다, 디렉터리의 내용은 제거 됩니다.\n\n**참고**: 외부 저장소를 탑재할 수 없는 경우 `cordova.file.external*` 속성은 `null`.\n\n### 블랙베리 10 파일 시스템 레이아웃\n\n| 장치 경로 | `cordova.file.*` | r/w? | 영구? | OS 지웁니다 | 개인 |\n|:----------------------------------------------------------- |:--------------------------- |:----:|:---:|:-------:|:--:|\n| `file:///accounts/1000/appdata/ < app id > /` | applicationStorageDirectory | r | N/A | N/A | 예 |\n| `app/native` | applicationDirectory | r | N/A | N/A | 예 |\n| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | 없음 | 예 | 예 |\n| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | 예 | 없음 | 예 |\n| `file:///accounts/1000/removable/sdcard` | externalRemovableDirectory | r/w | 예 | 없음 | 없음 |\n| `file:///accounts/1000/shared` | sharedDirectory | r/w | 예 | 없음 | 없음 |\n\n*참고*: 모든 경로 /accounts/1000-enterprise를 기준으로 응용 프로그램 경계를 작동 하도록 배포 될 때.\n\n## 안 드 로이드 단점\n\n### 안 드 로이드 영구 저장 위치\n\n안 드 로이드 장치에 영구 파일을 저장할 여러 유효한 위치가 있다. 다양 한 가능성의 광범위 한 토론에 대 한 [이 페이지](http://developer.android.com/guide/topics/data/data-storage.html)를 참조 하십시오.\n\n플러그인의 이전 버전을 시작할 때, 장치는 SD 카드 (또는 해당 스토리지 파티션) 탑재 했다 주장 하는 여부에 따라 임시 및 영구 파일의 위치를 선택 합니다. SD 카드 마운트, 또는 큰 내부 스토리지 파티션에 사용할 수 있었습니다 (같은 넥서스 장치에) 그 후에 영구 파일 공간의 루트에 저장 됩니다. 이 모든 코르 도우 바 애플 리 케이 션 카드에 모두 사용할 수 있는 파일을 볼 수 있는 의미 합니다.\n\nSD 카드는 사용할 수 있는 경우 이전 버전에서 데이터 저장 `/data/data/`는 서로 다른 애플 리 케이 션을 분리 하지만 여전히 원인 데이터를 사용자 간에 공유할 수 있습니다.\n\n그것은 지금 내부 파일 저장 위치 또는 응용 프로그램의 `config.xml` 파일에 기본 설정으로 이전 논리를 사용 하 여 파일을 저장할 것인지를 선택할 수 있습니다. 이렇게 하려면 `config.xml`에이 두 줄 중 하나를 추가:\n\n \n \n \n \n\n이 줄이 없으면 파일 플러그인은 기본적으로 `Compatibility`을 사용 합니다. 기본 태그,이 이러한 값 중 하나가 아닌 경우에 응용 프로그램이 시작 되지 않습니다.\n\n이전 (사전 1.0)을 사용 하는 경우 응용 프로그램 사용자에 게 발송 되었다 이전,이 플러그인의 버전 영구 파일 시스템에 저장 된 파일은 그리고 `Compatibility` 환경 설정을 설정 해야 합니다. \"내부\"의 위치 전환 그들의 응용 프로그램을 업그레이드 기존 사용자의 그들의 장치에 따라 그들의 이전에 저장 된 파일에 액세스할 수 수 있다는 뜻입니다.\n\n경우 응용 프로그램은 새로운, 또는 이전 영구 파일 시스템에 파일을 저장, `Internal` 설정은 일반적으로 권장 됩니다.\n\n### /Android_asset에 대 한 느린 재귀 작업\n\n자산 디렉터리를 나열 하는 것은 안 드 로이드에 정말 느리다입니다. 속도 높일 수 있습니다 하지만, 안 드 로이드 프로젝트의 루트에 `src/android/build-extras.gradle` 를 추가 하 여 최대 (cordova-android@4.0.0 필요 이상).\n\n## iOS 단점\n\n * `cordova.file.applicationStorageDirectory`읽기 전용; 루트 디렉터리 내에서 파일을 저장 하려고에 실패 합니다. 다른 중 하나를 사용 하 여 `cordova.file.*` iOS에 대해 정의 된 속성 (만 `applicationDirectory` 와 `applicationStorageDirectory` 는 읽기 전용).\n * `FileReader.readAsText(blob, encoding)` \n * `encoding`매개 변수는 지원 되지 않습니다, 및 효과에 항상 u t F-8 인코딩을 합니다.\n\n### iOS 영구 저장소 위치\n\nIOS 디바이스에 영구 파일을 저장할 두 개의 유효한 위치가 있다: 문서 디렉터리 및 라이브러리 디렉터리. 플러그인의 이전 버전은 오직 문서 디렉토리에 영구 파일을 저장. 이 부작용 보다는 아니었다 수시로 특히 많은 작은 파일을 처리 하는 응용 프로그램에 대 한 의도, iTunes에 표시 모든 응용 프로그램 파일을 만드는 디렉터리의 용도 내보내기에 대 한 완전 한 문서를 생산 했다.\n\n그것은 지금 문서 또는 응용 프로그램의 `config.xml` 파일에 기본 설정으로 라이브러리 디렉토리에 파일을 저장할 것인지를 선택할 수 있습니다. 이렇게 하려면 `config.xml`에이 두 줄 중 하나를 추가:\n\n \n \n \n \n\n이 줄이 없으면 파일 플러그인은 기본적으로 `Compatibility`을 사용 합니다. 기본 태그,이 이러한 값 중 하나가 아닌 경우에 응용 프로그램이 시작 되지 않습니다.\n\n이전 (사전 1.0)을 사용 하는 경우 응용 프로그램 사용자에 게 발송 되었다 이전,이 플러그인의 버전 영구 파일 시스템에 저장 된 파일은 그리고 `Compatibility` 환경 설정을 설정 해야 합니다. `Library`에 위치를 스위칭 기존 사용자에 게 응용 프로그램을 업그레이 드의 그들의 이전에 저장 된 파일에 액세스할 수 것을 의미할 것입니다.\n\n경우 응용 프로그램은 새로운, 또는 이전 영구 파일 시스템에 파일을 저장, `Library` 설정은 일반적으로 권장 됩니다.\n\n## 파이어 폭스 OS 단점\n\n파일 시스템 API Firefox 운영 체제에서 기본적으로 지원 하지 및 indexedDB 위에 심으로 구현 됩니다.\n\n * 비어 있지 않은 디렉터리를 제거할 때 실패 하지 않습니다.\n * 디렉터리에 대 한 메타 데이터를 지원 하지 않습니다.\n * 메서드 `copyTo` 및 `moveTo` 디렉터리를 지원 하지 않습니다\n\n다음 데이터 경로 지원 됩니다: * `applicationDirectory`-`xhr`를 사용 하 여 로컬 파일을 응용 프로그램 패키지를 가져옵니다. * `dataDirectory`-영구 응용 프로그램 특정 데이터 파일에 대 한. * `cacheDirectory`-응용 프로그램 다시 시작 해야 하는 캐시 된 파일 (애플 리 케이 션은 여기에 파일을 삭제 하려면 운영 체제에 의존 하지 말아야).\n\n## 브라우저 만지면\n\n### 일반적인 단점 및 설명\n\n * 각 브라우저는 샌드박스 자체 파일 시스템을 사용합니다. IE와 파이어 폭스 기반으로 IndexedDB를 사용합니다. 모든 브라우저는 경로에서 디렉터리 구분 기호로 슬래시를 사용합니다.\n * 디렉터리 항목을 연속적으로 만들 수 있다. 예를 들어 전화 `fs.root.getDirectory ('dir1/dir2 ', {create:true}, successCallback, errorCallback)` d i r 1 존재 하지 않은 경우 실패 합니다.\n * 플러그인 응용 프로그램 처음 시작할 영구 저장소를 사용 하 여 사용자 권한을 요청 합니다. \n * 플러그인 지원 `cdvfile://localhost` (로컬 리소스)만. 즉, 외부 리소스는 `cdvfile`를 통해 지원 되지 않습니다..\n * 플러그인 [\"파일 시스템 API 8.3 명명 제한\"을](http://www.w3.org/TR/2011/WD-file-system-api-20110419/#naming-restrictions) 수행 하지 않습니다..\n * Blob 및 파일 ' `close` 함수는 지원 되지 않습니다.\n * `FileSaver` 및 `BlobBuilder`는이 플러그 접속식에 의해 지원 되지 않습니다 그리고 명세서를 필요가 없습니다.\n * 플러그인 `requestAllFileSystems`를 지원 하지 않습니다. 이 함수는 또한 사양에 빠진.\n * 사용 하는 경우 디렉터리에서 항목 제거 되지 것입니다 `create: true` 기존 디렉터리에 대 한 플래그.\n * 생성자를 통해 생성 된 파일은 지원 되지 않습니다. Entry.file 메서드를 대신 사용 해야 합니다.\n * 각 브라우저 blob URL 참조에 대 한 그것의 자신의 형태를 사용합니다.\n * `readAsDataURL` 기능을 지원 하지만 크롬에서 mediatype 항목 이름 확장명에 따라 달라 집니다, 그리고 mediatype IE에는 항상 빈 (`텍스트 일반` 사양에 따라 동일), 파이어 폭스에서 mediatype은 항상 `응용 프로그램/8 진수 스트림`. 예를 들어, 콘텐츠는 `abcdefg` 다음 파이어 폭스 반환 `데이터: 응용 프로그램 / 8 진수 스트림; base64, YWJjZGVmZw = =`, 즉 반환 `데이터:; base64, YWJjZGVmZw = =`, 반환 크롬 `데이터: < 항목 이름의 확장에 따라 mediatype >; base64, YWJjZGVmZw = =`.\n * `toInternalURL` 양식 `file:///persistent/path/to/entry` (파이어 폭스, 인터넷 익스플로러)에서 경로 반환합니다. 크롬 양식 `cdvfile://localhost/persistent/file`에 경로 반환합니다..\n\n### 크롬 특수\n\n * 크롬 파일 시스템 장치 준비 이벤트 후 즉시 준비 되지 않습니다. 문제를 해결 하려면 `filePluginIsReady` 이벤트를 구독할 수 있습니다. 예를 들어: \n\n```javascript\nwindow.addEventListener('filePluginIsReady', function(){ console.log('File plugin is ready');}, false);\n```\n\n`Window.isFilePluginReadyRaised` 함수를 사용 하 여 이벤트가 이미 발생 여부를 확인할 수 있습니다. -window.requestFileSystem 임시 및 영구 파일 시스템 할당량 크롬에 제한 되지 않습니다. -크롬에서 영구 저장소를 증가 하려면 `window.initPersistentFileSystem` 메서드를 호출 해야 합니다. 영구 저장소 할당량은 기본적으로 5 메가바이트입니다. -크롬 필요 `-허용-파일-액세스-에서-파일` `file:///` 프로토콜을 통해 지원 API 인수를 실행 합니다. -플래그를 사용 하면 `파일` 개체 하지 변경할 수 `{create:true}` 때 기존 `항목`. -행사 `cancelable` 속성이로 설정 된 크롬에서. 이 [사양](http://dev.w3.org/2009/dap/file-system/file-writer.html) 대조적 이다. -크롬에서 `toURL` 함수 반환 합니다 `파일 시스템:`-응용 프로그램 호스트에 따라 경로 앞에. 예를 들어, `filesystem:file:///persistent/somefile.txt`, `filesystem:http://localhost:8080/persistent/somefile.txt`. -`toURL` 함수 결과 디렉터리 항목의 경우에 후행 슬래시를 포함 하지 않습니다. 크롬 하지만 제대로 붙여 슬래시 url이 포함 된 디렉터리 해결합니다. -`resolveLocalFileSystemURL` 메서드 인바운드 `url`을 `파일 시스템` 접두사가 필요 합니다. 예를 들어, `url` 매개 변수 `resolveLocalFileSystemURL`에 대 한 안 드 로이드에서 양식 `file:///persistent/somefile.txt` 반대로 양식 `filesystem:file:///persistent/somefile.txt`에 있어야 합니다. -사용 되지 않는 `toNativeURL` 함수는 지원 되지 않습니다 및 stub에는 없습니다. -`setMetadata` 함수는 규격에 명시 되지 않은 및 지원 되지 않습니다. -INVALID_MODIFICATION_ERR (코드: 9) 대신 throw 됩니다 SYNTAX_ERR(code: 8) 비 existant 파일 시스템의 요청에. -INVALID_MODIFICATION_ERR (코드: 9) 대신 throw 됩니다 PATH_EXISTS_ERR(code: 12) 독점적으로 파일 또는 디렉터리를 만들 려,는 이미 존재 합니다. -INVALID_MODIFICATION_ERR (코드: 9) 대신 throw 됩니다 NO_MODIFICATION_ALLOWED_ERR(code: 6) 루트 파일 시스템에 removeRecursively을 호출 하려고 합니다. -INVALID_MODIFICATION_ERR (코드: 9) 대신 throw 됩니다 NOT_FOUND_ERR(code: 1) moveTo 디렉터리 존재 하지 않는 것을 시도에.\n\n### IndexedDB 기반 구현이 특수 (파이어 폭스와 IE)\n\n * `.` `.`는 지원 되지 않습니다.\n * IE `file:///`를 지원 하지 않습니다-모드; 호스트 모드 지원된 (http://localhost:xxxx)입니다.\n * 파이어 폭스 파일 시스템 크기 제한 이지만 각 50MB 확장 사용자 권한을 요청 합니다. IE10 최대 10 mb 결합 AppCache 및 IndexedDB 묻는 사이트 당 250 mb의 최대 최대 증가 될 수 있도록 하려는 경우 해당 수준에 충돌 한 번 메시지를 표시 하지 않고 파일 시스템의 구현에 사용을 허용 한다. 그래서 `size` 매개 변수 `requestFileSystem` 함수에 대 한 파이어 폭스와 IE에서 파일 시스템 영향을 주지 않습니다.\n * `readAsBinaryString` 함수 사양에 명시 되지 않은 IE에서 지원 되지 않으며 stub에는 없습니다.\n * `file.type`은 항상 null입니다.\n * 하지 항목 삭제 된 DirectoryEntry 인스턴스의 콜백 결과 사용 하 여 만들어야 합니다. 그렇지 않으면, '교수형 항목'을 얻을 것 이다.\n * 그냥 작성 된 파일을 읽을 수 있는이 파일의 새 인스턴스를 얻으려면 해야 합니다.\n * `setMetadata` 함수는 사양에 명시 되지 않은 지원 `modificationTime` 필드 변경에만 해당 합니다. \n * `copyTo` 및 `moveTo` 함수는 디렉터리를 지원 하지 않습니다.\n * 디렉터리 메타 데이터는 지원 되지 않습니다.\n * 둘 다 Entry.remove와 directoryEntry.removeRecursively 비어 있지 않은 디렉터리를 제거할 때 실패 하지 않습니다-디렉터리 제거 되는 대신 내용을 함께 청소.\n * `abort` 및 `truncate` 함수 지원 되지 않습니다.\n * 진행 이벤트가 발생 하지 합니다. 예를 들어,이 처리기 하지 실행 됩니다.\n\n```javascript\nwriter.onprogress = function() { /*commands*/ };\n```\n\n## 업그레이드 노트\n\n이 플러그인의 v1.0.0에 게시 된 사양에 맞춰 더 많은 것 `FileEntry` 및 `DirectoryEntry` 구조 변경 되었습니다.\n\n플러그인의 이전 (pre-1.0.0) 버전 장치 절대 파일 위치 `Entry` 개체의 `fullPath` 속성에 저장 됩니다. 이러한 경로 일반적으로 같습니다.\n\n /var/mobile/Applications//Documents/path/to/file (iOS)\n /storage/emulated/0/path/to/file (Android)\n \n\n이러한 경로 `항목` 개체의 `toURL()` 메서드에서 반환 했다.\n\nV1.0.0, `fullPath` 속성은 *HTML 파일 시스템의 루트에 상대적인* 파일의 경로를. 그래서, 위의 경로 지금 둘 다의 `fullPath`와 `FileEntry` 개체에 의해 표현 될 것 이다\n\n /path/to/file\n \n\n응용 프로그램 작동 장치 절대 경로, 이전 `항목` 개체의 `fullPath` 속성을 통해 그 경로 검색 하는 경우에, 당신은 대신 `entry.toURL()`를 사용 하 여 코드를 업데이트 해야 합니다.\n\n대 한 뒤 호환성, `resolveLocalFileSystemURL()` 메서드는 장치-절대-경로 수락 하 고 그 파일 중 `TEMPORARY` 또는 `PERSISTENT` 파일 시스템 내에서 존재 하는 경우, 해당 `Entry` 개체를 반환 합니다.\n\n이 특히 이전 장치 절대 경로 사용 하는 파일 전송 플러그인에 문제가 있다 (그리고 아직도 그들을 받아들일 수.) 그것은 `entry.toURL()`와 `entry.fullPath`를 대체 확인 장치에 파일을 사용 하는 플러그인을 지 고 그래서 파일 시스템 Url와 함께 제대로 작동 하려면 업데이트 되었습니다.\n\nV1.1.0에 `toURL()`의 반환 값 (\\[CB-6394\\] (https://issues.apache.org/jira/browse/CB-6394) 참조)로 바뀌었다 'file://' 절대 URL을 반환. 가능 하다 면. 보장 하는 ' cdvfile:'-URL `toInternalURL()`를 지금 사용할 수 있습니다. 이 메서드 이제 양식의 파일 Url을 반환 합니다.\n\n cdvfile://localhost/persistent/path/to/file\n \n\n어떤 파일을 고유 하 게 식별 하려면 사용할 수 있습니다.\n\n## 오류 코드 및 의미의 목록\n\n오류가 throw 됩니다 때 다음 코드 중 하나가 사용 됩니다.\n\n| 코드 | 상수 |\n| --:|:----------------------------- |\n| 1 | `NOT_FOUND_ERR` |\n| 2 | `SECURITY_ERR` |\n| 3 | `ABORT_ERR` |\n| 4 | `NOT_READABLE_ERR` |\n| 5 | `ENCODING_ERR` |\n| 6 | `NO_MODIFICATION_ALLOWED_ERR` |\n| 7 | `INVALID_STATE_ERR` |\n| 8 | `SYNTAX_ERR` |\n| 9 | `INVALID_MODIFICATION_ERR` |\n| 10 | `QUOTA_EXCEEDED_ERR` |\n| 11 | `TYPE_MISMATCH_ERR` |\n| 12 | `PATH_EXISTS_ERR` |\n\n## (선택 사항) 플러그인 구성\n\n사용 가능한 파일 시스템의 집합 플랫폼 당 구성된 될 수 있습니다. IOS와 안 드 로이드를 인식 한 `config.xml` 설치 될 파일 시스템 이름에 태그. 기본적으로 모든 파일 시스템 루트 사용할 수 있습니다.\n\n \n \n \n\n### 안 드 로이드\n\n * `files`: 응용 프로그램의 내부 파일 저장 디렉토리\n * `files-external`: 응용 프로그램의 외부 파일 저장 디렉토리\n * `sdcard`: 글로벌 외부 파일 저장 디렉토리 (이것은 SD 카드의 루트 설치 된 경우). 이것을 사용 하려면 `android.permission.WRITE_EXTERNAL_STORAGE` 권한이 있어야 합니다.\n * `cache`: 응용 프로그램의 내부 캐시 디렉터리\n * `cache-external`: 응용 프로그램의 외부 캐시 디렉터리\n * `root`: 전체 장치 파일 시스템\n\n안 드 로이드는 또한 \"파일\" 파일 시스템 내에서 \"/ 문서 /\" 하위 디렉토리를 나타내는 \"문서\" 라는 특별 한 파일을 지원 합니다.\n\n### iOS\n\n * `library`: 응용 프로그램의 라이브러리 디렉터리\n * `documents`: 응용 프로그램의 문서 디렉토리\n * `cache`: 응용 프로그램의 캐시 디렉터리\n * `bundle`: 응용 프로그램의 번들; (읽기 전용) 디스크에 응용 프로그램 자체의 위치\n * `root`: 전체 장치 파일 시스템\n\n기본적으로 라이브러리 및 문서 디렉토리 iCloud에 동기화 할 수 있습니다. 또한 2 개의 추가적인 파일 시스템, `library-nosync` 및 `documents-nosync`, 내 특별 한 동기화 되지 않은 디렉터리를 대표 하는 요청할 수 있습니다는 `/Library` 또는 `/Documents` 파일 시스템."
},
{
"path": "plugins/cordova-plugin-file/doc/ko/index.md",
"content": "\n\n# cordova-plugin-file\n\n이 플러그인은 장치에 있는 파일에 대 한 읽기/쓰기 액세스를 허용 하는 파일 API를 구현 합니다.\n\n이 플러그인을 포함 한 몇 가지 사양에 따라: HTML5 파일 API는 \n\n(지금은 없어진) 디렉터리와 시스템 확장 최신: 플러그인 코드의 대부분은 때 이전 사양 작성 되었습니다 있지만 현재는: \n\n그것은 또한 FileWriter 사양 구현: \n\n사용을 참조 하십시오 HTML5 바위 ' 우수한 [파일 시스템 문서.][1]\n\n [1]: http://www.html5rocks.com/en/tutorials/file/filesystem/\n\n다른 저장소 옵션에 대 한 개요, 코르도바의 [저장소 가이드][2] 를 참조합니다.\n\n [2]: http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html\n\n이 플러그인 글로벌 `cordova.file` 개체를 정의합니다.\n\n전역 범위에 있지만 그것은 불가능까지 `deviceready` 이벤트 후.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(cordova.file);\n }\n \n\n## 설치\n\n cordova plugin add cordova-plugin-file\n \n\n## 지원 되는 플랫폼\n\n* 아마존 화재 운영 체제\n* 안 드 로이드\n* 블랙베리 10\n* Firefox 운영 체제\n* iOS\n* Windows Phone 7과 8 *\n* 윈도우 8 *\n* 브라우저\n\n* *`FileReader.readAsArrayBuffer`도 `FileWriter.write(blob)`이 플랫폼을 지원 하지 않습니다.*\n\n## 파일을 저장할 위치를\n\nV1.2.0, 현재 중요 한 파일 시스템 디렉터리에 Url도 제공 됩니다. 각 URL 형태 *file:///path/to/spot/* 이며 `DirectoryEntry` `window.resolveLocalFileSystemURL()`를 사용 하 여 변환할 수 있습니다..\n\n* `cordova.file.applicationDirectory`-읽기 전용 디렉터리는 응용 프로그램을 설치 합니다. (*iOS*, *안 드 로이드*, *블랙베리 10*)\n\n* `cordova.file.applicationStorageDirectory`응용 프로그램의 샌드박스;의 루트 디렉터리 iOS에이 위치에는 읽기 전용 (특정 하위 디렉토리만 [같은 `/Documents` ]은 읽기 / 쓰기). 포함 된 모든 데이터는 응용 프로그램에 전용. ( *iOS*, *안 드 로이드*, *블랙베리 10*)\n\n* `cordova.file.dataDirectory`-내부 메모리를 사용 하 여 응용 프로그램의 샌드박스 내에서 영구 및 개인 데이터 스토리지 (안 드 로이드, 외부 메모리를 사용 해야 하는 경우 사용 하 여 `.externalDataDirectory` ). IOS에이 디렉터리 iCloud와 동기화 되지 되 (를 사용 하 여 `.syncedDataDirectory` ). (*iOS*, *안 드 로이드*, *블랙베리 10*)\n\n* `cordova.file.cacheDirectory`-디렉터리 캐시 데이터 파일 또는 모든 파일을 당신의 app를 다시 쉽게 만들 수 있습니다. 운영 체제 장치 저장소 부족 하면 이러한 파일을 삭제할 수 있습니다, 그리고 그럼에도 불구 하 고, 애플 리 케이 션 여기에 파일을 삭제 하려면 운영 체제에 의존 하지 말아야 합니다. (*iOS*, *안 드 로이드*, *블랙베리 10*)\n\n* `cordova.file.externalApplicationStorageDirectory`-응용 프로그램 외부 저장 공간입니다. (*안 드 로이드*)\n\n* `cordova.file.externalDataDirectory`-외부 저장소에 응용 프로그램 특정 데이터 파일을 넣어 어디. (*안 드 로이드*)\n\n* `cordova.file.externalCacheDirectory`외부 저장소에 응용 프로그램 캐시입니다. (*안 드 로이드*)\n\n* `cordova.file.externalRootDirectory`-외부 저장 (SD 카드) 루트입니다. (*안 드 로이드*, *블랙베리 10*)\n\n* `cordova.file.tempDirectory`-운영 체제에서 지울 수 있습니다 임시 디렉터리 것입니다. 이 디렉터리;를 운영 체제에 의존 하지 마십시오 귀하의 응용 프로그램 항상 해당 하는 경우 파일을 제거 해야 합니다. (*iOS*)\n\n* `cordova.file.syncedDataDirectory`-(ICloud)를 예를 들어 동기화 해야 하는 응용 프로그램 관련 파일을 보유 하 고 있습니다. (*iOS*)\n\n* `cordova.file.documentsDirectory`-파일 애플 리 케이 션, 하지만 그 개인은 다른 응용 프로그램 (예: Office 파일)에 의미입니다. (*iOS*)\n\n* `cordova.file.sharedDirectory`-모든 응용 프로그램 (*블랙베리 10* 에 전세계적으로 사용 가능한 파일)\n\n## 파일 시스템 레이아웃\n\n하지만 구현 세부 사항을 기술적으로 `cordova.file.*` 속성 실제 장치에 실제 경로에 매핑하는 방법을 아는 것이 매우 유용할 수 있습니다.\n\n### iOS 파일 시스템 레이아웃\n\n| 장치 경로 | `cordova.file.*` | `iosExtraFileSystems` | r/w? | 영구? | OS 지웁니다 | 동기화 | 개인 |\n|:------------------------------------ |:--------------------------- |:--------------------- |:----:|:------:|:---------:|:---:|:--:|\n| `/ var/모바일/응용 프로그램/< UUID > /` | applicationStorageDirectory | - | r | N/A | N/A | N/A | 예 |\n| `appname.app/` | applicationDirectory | 번들 | r | N/A | N/A | N/A | 예 |\n| `www/` | - | - | r | N/A | N/A | N/A | 예 |\n| `Documents/` | documentsDirectory | 문서 | r/w | 예 | 없음 | 예 | 예 |\n| `NoCloud/` | - | 문서 nosync | r/w | 예 | 없음 | 없음 | 예 |\n| `Library` | - | 라이브러리 | r/w | 예 | 없음 | 그래? | 예 |\n| `NoCloud/` | dataDirectory | 라이브러리 nosync | r/w | 예 | 없음 | 없음 | 예 |\n| `Cloud/` | syncedDataDirectory | - | r/w | 예 | 없음 | 예 | 예 |\n| `Caches/` | cacheDirectory | 캐시 | r/w | 예 * | 예 * * *| | 없음 | 예 |\n| `tmp/` | tempDirectory | - | r/w | 아니 * * | 예 * * *| | 없음 | 예 |\n\n* 파일 응용 프로그램 다시 시작 및 업그레이드, 유지 하지만 OS 욕망 언제 든 지이 디렉터리를 지울 수 있습니다. 앱 삭제 될 수 있습니다 모든 콘텐츠를 다시 만들 수 있어야 합니다.\n\n* * 파일 응용 프로그램 다시 시작에서 지속 될 수 있습니다 하지만이 동작에 의존 하지 마십시오. 파일 여러 업데이트를 보장 하지 않습니다. 때 해당 앱이이 디렉터리에서 파일을 제거 해야, 이러한 파일을 제거할 때 (또는 경우에도) 운영 체제 보증 하지 않습니다으로.\n\n* * *| OS 그것이 필요를 느낀다 언제 든 지이 디렉터리의 내용을 취소 될 수 있습니다 하지만 이것에 의존 하지 마십시오. 이 디렉터리를 응용 프로그램에 대 한 적절 한 선택을 취소 해야 합니다.\n\n### 안 드 로이드 파일 시스템 레이아웃\n\n| 장치 경로 | `cordova.file.*` | `AndroidExtraFileSystems` | r/w? | 영구? | OS 지웁니다 | 개인 |\n|:--------------------------------- |:----------------------------------- |:------------------------- |:----:|:---:|:-------:|:--:|\n| `file:///android_asset/` | applicationDirectory | | r | N/A | N/A | 예 |\n| `/data/데이터/< app id > /` | applicationStorageDirectory | - | r/w | N/A | N/A | 예 |\n| `cache` | cacheDirectory | 캐시 | r/w | 예 | 예 * | 예 |\n| `files` | dataDirectory | 파일 | r/w | 예 | 없음 | 예 |\n| `Documents` | | 문서 | r/w | 예 | 없음 | 예 |\n| `< sdcard > /` | externalRootDirectory | sdcard | r/w | 예 | 없음 | 없음 |\n| `Android/data//` | externalApplicationStorageDirectory | - | r/w | 예 | 없음 | 없음 |\n| `cache` | externalCacheDirectry | 외부 캐시 | r/w | 예 | 아니 * * | 없음 |\n| `files` | externalDataDirectory | 파일 외부 | r/w | 예 | 없음 | 없음 |\n\n* OS 수 있습니다 정기적으로이 디렉터리에 있지만이 동작에 의존 하지 마십시오. 이 응용 프로그램이 디렉터리의 내용을 취소 합니다. 사용자 수동으로 캐시 제거 해야,이 디렉터리의 내용은 제거 됩니다.\n\n* * OS 지워지지 않습니다이 디렉터리 자동으로; 콘텐츠를 관리 하기 위한 책임이 있습니다. 사용자 수동으로 캐시 제거 합니다, 디렉터리의 내용은 제거 됩니다.\n\n**참고**: 외부 저장소를 탑재할 수 없는 경우 `cordova.file.external*` 속성은 `null`.\n\n### 블랙베리 10 파일 시스템 레이아웃\n\n| 장치 경로 | `cordova.file.*` | r/w? | 영구? | OS 지웁니다 | 개인 |\n|:--------------------------------------------------- |:--------------------------- |:----:|:---:|:-------:|:--:|\n| `file:///accounts/1000/appdata/ < app id > /` | applicationStorageDirectory | r | N/A | N/A | 예 |\n| `app/native` | applicationDirectory | r | N/A | N/A | 예 |\n| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | 없음 | 예 | 예 |\n| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | 예 | 없음 | 예 |\n| `file:///accounts/1000/removable/sdcard` | externalRemovableDirectory | r/w | 예 | 없음 | 없음 |\n| `file:///accounts/1000/shared` | sharedDirectory | r/w | 예 | 없음 | 없음 |\n\n*참고*: 모든 경로 /accounts/1000-enterprise를 기준으로 응용 프로그램 경계를 작동 하도록 배포 될 때.\n\n## 안 드 로이드 단점\n\n### 안 드 로이드 영구 저장 위치\n\n안 드 로이드 장치에 영구 파일을 저장할 여러 유효한 위치가 있다. 다양 한 가능성의 광범위 한 토론에 대 한 [이 페이지][3]를 참조 하십시오.\n\n [3]: http://developer.android.com/guide/topics/data/data-storage.html\n\n플러그인의 이전 버전을 시작할 때, 장치는 SD 카드 (또는 해당 스토리지 파티션) 탑재 했다 주장 하는 여부에 따라 임시 및 영구 파일의 위치를 선택 합니다. SD 카드 마운트, 또는 큰 내부 스토리지 파티션에 사용할 수 있었습니다 (같은 넥서스 장치에) 그 후에 영구 파일 공간의 루트에 저장 됩니다. 이 모든 코르 도우 바 애플 리 케이 션 카드에 모두 사용할 수 있는 파일을 볼 수 있는 의미 합니다.\n\nSD 카드는 사용할 수 있는 경우 이전 버전에서 데이터 저장 `/data/data/`는 서로 다른 애플 리 케이 션을 분리 하지만 여전히 원인 데이터를 사용자 간에 공유할 수 있습니다.\n\n그것은 지금 내부 파일 저장 위치 또는 응용 프로그램의 `config.xml` 파일에 기본 설정으로 이전 논리를 사용 하 여 파일을 저장할 것인지를 선택할 수 있습니다. 이렇게 하려면 `config.xml`에이 두 줄 중 하나를 추가:\n\n \n \n \n \n\n이 줄이 없으면 파일 플러그인은 기본적으로 `Compatibility`을 사용 합니다. 기본 태그,이 이러한 값 중 하나가 아닌 경우에 응용 프로그램이 시작 되지 않습니다.\n\n이전 (사전 1.0)을 사용 하는 경우 응용 프로그램 사용자에 게 발송 되었다 이전,이 플러그인의 버전 영구 파일 시스템에 저장 된 파일은 그리고 `Compatibility` 환경 설정을 설정 해야 합니다. \"내부\"의 위치 전환 그들의 응용 프로그램을 업그레이드 기존 사용자의 그들의 장치에 따라 그들의 이전에 저장 된 파일에 액세스할 수 수 있다는 뜻입니다.\n\n경우 응용 프로그램은 새로운, 또는 이전 영구 파일 시스템에 파일을 저장, `Internal` 설정은 일반적으로 권장 됩니다.\n\n## iOS 단점\n\n* `cordova.file.applicationStorageDirectory`읽기 전용; 루트 디렉터리 내에서 파일을 저장 하려고에 실패 합니다. 다른 중 하나를 사용 하 여 `cordova.file.*` iOS에 대해 정의 된 속성 (만 `applicationDirectory` 와 `applicationStorageDirectory` 는 읽기 전용).\n* `FileReader.readAsText(blob, encoding)` \n * `encoding`매개 변수는 지원 되지 않습니다, 및 효과에 항상 u t F-8 인코딩을 합니다.\n\n### iOS 영구 저장소 위치\n\nIOS 디바이스에 영구 파일을 저장할 두 개의 유효한 위치가 있다: 문서 디렉터리 및 라이브러리 디렉터리. 플러그인의 이전 버전은 오직 문서 디렉토리에 영구 파일을 저장. 이 부작용 보다는 아니었다 수시로 특히 많은 작은 파일을 처리 하는 응용 프로그램에 대 한 의도, iTunes에 표시 모든 응용 프로그램 파일을 만드는 디렉터리의 용도 내보내기에 대 한 완전 한 문서를 생산 했다.\n\n그것은 지금 문서 또는 응용 프로그램의 `config.xml` 파일에 기본 설정으로 라이브러리 디렉토리에 파일을 저장할 것인지를 선택할 수 있습니다. 이렇게 하려면 `config.xml`에이 두 줄 중 하나를 추가:\n\n \n \n \n \n\n이 줄이 없으면 파일 플러그인은 기본적으로 `Compatibility`을 사용 합니다. 기본 태그,이 이러한 값 중 하나가 아닌 경우에 응용 프로그램이 시작 되지 않습니다.\n\n이전 (사전 1.0)을 사용 하는 경우 응용 프로그램 사용자에 게 발송 되었다 이전,이 플러그인의 버전 영구 파일 시스템에 저장 된 파일은 그리고 `Compatibility` 환경 설정을 설정 해야 합니다. `Library`에 위치를 스위칭 기존 사용자에 게 응용 프로그램을 업그레이 드의 그들의 이전에 저장 된 파일에 액세스할 수 것을 의미할 것입니다.\n\n경우 응용 프로그램은 새로운, 또는 이전 영구 파일 시스템에 파일을 저장, `Library` 설정은 일반적으로 권장 됩니다.\n\n## 파이어 폭스 OS 단점\n\n파일 시스템 API Firefox 운영 체제에서 기본적으로 지원 하지 및 indexedDB 위에 심으로 구현 됩니다.\n\n* 비어 있지 않은 디렉터리를 제거할 때 실패 하지 않습니다.\n* 디렉터리에 대 한 메타 데이터를 지원 하지 않습니다.\n* 메서드 `copyTo` 및 `moveTo` 디렉터리를 지원 하지 않습니다\n\n다음 데이터 경로 지원 됩니다: * `applicationDirectory`-`xhr`를 사용 하 여 로컬 파일을 응용 프로그램 패키지를 가져옵니다. * `dataDirectory`-영구 응용 프로그램 특정 데이터 파일에 대 한. * `cacheDirectory`-응용 프로그램 다시 시작 해야 하는 캐시 된 파일 (애플 리 케이 션은 여기에 파일을 삭제 하려면 운영 체제에 의존 하지 말아야).\n\n## 브라우저 만지면\n\n### 일반적인 단점 및 설명\n\n* 각 브라우저는 샌드박스 자체 파일 시스템을 사용합니다. IE와 파이어 폭스 기반으로 IndexedDB를 사용합니다. 모든 브라우저는 경로에서 디렉터리 구분 기호로 슬래시를 사용합니다.\n* 디렉터리 항목을 연속적으로 만들 수 있다. 예를 들어 전화 `fs.root.getDirectory ('dir1/dir2 ', {create:true}, successCallback, errorCallback)` d i r 1 존재 하지 않은 경우 실패 합니다.\n* 플러그인 응용 프로그램 처음 시작할 영구 저장소를 사용 하 여 사용자 권한을 요청 합니다. \n* 플러그인 지원 `cdvfile://localhost` (로컬 리소스)만. 즉, 외부 리소스는 `cdvfile`를 통해 지원 되지 않습니다..\n* 플러그인 [\"파일 시스템 API 8.3 명명 제한\"을][4] 수행 하지 않습니다..\n* Blob 및 파일 ' `close` 함수는 지원 되지 않습니다.\n* `FileSaver` 및 `BlobBuilder`는이 플러그 접속식에 의해 지원 되지 않습니다 그리고 명세서를 필요가 없습니다.\n* 플러그인 `requestAllFileSystems`를 지원 하지 않습니다. 이 함수는 또한 사양에 빠진.\n* 사용 하는 경우 디렉터리에서 항목 제거 되지 것입니다 `create: true` 기존 디렉터리에 대 한 플래그.\n* 생성자를 통해 생성 된 파일은 지원 되지 않습니다. Entry.file 메서드를 대신 사용 해야 합니다.\n* 각 브라우저 blob URL 참조에 대 한 그것의 자신의 형태를 사용합니다.\n* `readAsDataURL` 기능을 지원 하지만 크롬에서 mediatype 항목 이름 확장명에 따라 달라 집니다, 그리고 mediatype IE에는 항상 빈 (`텍스트 일반` 사양에 따라 동일), 파이어 폭스에서 mediatype은 항상 `응용 프로그램/8 진수 스트림`. 예를 들어, 콘텐츠는 `abcdefg` 다음 파이어 폭스 반환 `데이터: 응용 프로그램 / 8 진수 스트림; base64, YWJjZGVmZw = =`, 즉 반환 `데이터:; base64, YWJjZGVmZw = =`, 반환 크롬 `데이터: < 항목 이름의 확장에 따라 mediatype >; base64, YWJjZGVmZw = =`.\n* `toInternalURL` 양식 `file:///persistent/path/to/entry` (파이어 폭스, 인터넷 익스플로러)에서 경로 반환합니다. 크롬 양식 `cdvfile://localhost/persistent/file`에 경로 반환합니다..\n\n [4]: http://www.w3.org/TR/2011/WD-file-system-api-20110419/#naming-restrictions\n\n### 크롬 특수\n\n* 크롬 파일 시스템 장치 준비 이벤트 후 즉시 준비 되지 않습니다. 문제를 해결 하려면 `filePluginIsReady` 이벤트를 구독할 수 있습니다. 예를 들어: \n\n javascript\n window.addEventListener('filePluginIsReady', function(){ console.log('File plugin is ready');}, false);\n \n\n`Window.isFilePluginReadyRaised` 함수를 사용 하 여 이벤트가 이미 발생 여부를 확인할 수 있습니다. -window.requestFileSystem 임시 및 영구 파일 시스템 할당량 크롬에 제한 되지 않습니다. -크롬에서 영구 저장소를 증가 하려면 `window.initPersistentFileSystem` 메서드를 호출 해야 합니다. 영구 저장소 할당량은 기본적으로 5 메가바이트입니다. -크롬 필요 `-허용-파일-액세스-에서-파일` `file:///` 프로토콜을 통해 지원 API 인수를 실행 합니다. -플래그를 사용 하면 `파일` 개체 하지 변경할 수 `{create:true}` 때 기존 `항목`. -행사 `cancelable` 속성이로 설정 된 크롬에서. 이 [사양][5] 대조적 이다. -크롬에서 `toURL` 함수 반환 합니다 `파일 시스템:`-응용 프로그램 호스트에 따라 경로 앞에. 예를 들어, `filesystem:file:///persistent/somefile.txt`, `filesystem:http://localhost:8080/persistent/somefile.txt`. -`toURL` 함수 결과 디렉터리 항목의 경우에 후행 슬래시를 포함 하지 않습니다. 크롬 하지만 제대로 붙여 슬래시 url이 포함 된 디렉터리 해결합니다. -`resolveLocalFileSystemURL` 메서드 인바운드 `url`을 `파일 시스템` 접두사가 필요 합니다. 예를 들어, `url` 매개 변수 `resolveLocalFileSystemURL`에 대 한 안 드 로이드에서 양식 `file:///persistent/somefile.txt` 반대로 양식 `filesystem:file:///persistent/somefile.txt`에 있어야 합니다. -사용 되지 않는 `toNativeURL` 함수는 지원 되지 않습니다 및 stub에는 없습니다. -`setMetadata` 함수는 규격에 명시 되지 않은 및 지원 되지 않습니다. -INVALID_MODIFICATION_ERR (코드: 9) 대신 throw 됩니다 SYNTAX_ERR(code: 8) 비 existant 파일 시스템의 요청에. -INVALID_MODIFICATION_ERR (코드: 9) 대신 throw 됩니다 PATH_EXISTS_ERR(code: 12) 독점적으로 파일 또는 디렉터리를 만들 려,는 이미 존재 합니다. -INVALID_MODIFICATION_ERR (코드: 9) 대신 throw 됩니다 NO_MODIFICATION_ALLOWED_ERR(code: 6) 루트 파일 시스템에 removeRecursively을 호출 하려고 합니다. -INVALID_MODIFICATION_ERR (코드: 9) 대신 throw 됩니다 NOT_FOUND_ERR(code: 1) moveTo 디렉터리 존재 하지 않는 것을 시도에.\n\n [5]: http://dev.w3.org/2009/dap/file-system/file-writer.html\n\n### IndexedDB 기반 구현이 특수 (파이어 폭스와 IE)\n\n* `.` `.`는 지원 되지 않습니다.\n* IE `file:///`를 지원 하지 않습니다-모드; 호스트 모드 지원된 (http://localhost:xxxx)입니다.\n* 파이어 폭스 파일 시스템 크기 제한 이지만 각 50MB 확장 사용자 권한을 요청 합니다. IE10 최대 10 mb 결합 AppCache 및 IndexedDB 묻는 사이트 당 250 mb의 최대 최대 증가 될 수 있도록 하려는 경우 해당 수준에 충돌 한 번 메시지를 표시 하지 않고 파일 시스템의 구현에 사용을 허용 한다. 그래서 `size` 매개 변수 `requestFileSystem` 함수에 대 한 파이어 폭스와 IE에서 파일 시스템 영향을 주지 않습니다.\n* `readAsBinaryString` 함수 사양에 명시 되지 않은 IE에서 지원 되지 않으며 stub에는 없습니다.\n* `file.type`은 항상 null입니다.\n* 하지 항목 삭제 된 DirectoryEntry 인스턴스의 콜백 결과 사용 하 여 만들어야 합니다. 그렇지 않으면, '교수형 항목'을 얻을 것 이다.\n* 그냥 작성 된 파일을 읽을 수 있는이 파일의 새 인스턴스를 얻으려면 해야 합니다.\n* `setMetadata` 함수는 사양에 명시 되지 않은 지원 `modificationTime` 필드 변경에만 해당 합니다. \n* `copyTo` 및 `moveTo` 함수는 디렉터리를 지원 하지 않습니다.\n* 디렉터리 메타 데이터는 지원 되지 않습니다.\n* 둘 다 Entry.remove와 directoryEntry.removeRecursively 비어 있지 않은 디렉터리를 제거할 때 실패 하지 않습니다-디렉터리 제거 되는 대신 내용을 함께 청소.\n* `abort` 및 `truncate` 함수 지원 되지 않습니다.\n* 진행 이벤트가 발생 하지 합니다. 예를 들어,이 처리기 하지 실행 됩니다.\n\n javascript\n writer.onprogress = function() { /*commands*/ };\n \n\n## 업그레이드 노트\n\n이 플러그인의 v1.0.0에 게시 된 사양에 맞춰 더 많은 것 `FileEntry` 및 `DirectoryEntry` 구조 변경 되었습니다.\n\n플러그인의 이전 (pre-1.0.0) 버전 장치 절대 파일 위치 `Entry` 개체의 `fullPath` 속성에 저장 됩니다. 이러한 경로 일반적으로 같습니다.\n\n /var/mobile/Applications//Documents/path/to/file (iOS)\n /storage/emulated/0/path/to/file (Android)\n \n\n이러한 경로 `항목` 개체의 `toURL()` 메서드에서 반환 했다.\n\nV1.0.0, `fullPath` 속성은 *HTML 파일 시스템의 루트에 상대적인* 파일의 경로를. 그래서, 위의 경로 지금 둘 다의 `fullPath`와 `FileEntry` 개체에 의해 표현 될 것 이다\n\n /path/to/file\n \n\n응용 프로그램 작동 장치 절대 경로, 이전 `항목` 개체의 `fullPath` 속성을 통해 그 경로 검색 하는 경우에, 당신은 대신 `entry.toURL()`를 사용 하 여 코드를 업데이트 해야 합니다.\n\n대 한 뒤 호환성, `resolveLocalFileSystemURL()` 메서드는 장치-절대-경로 수락 하 고 그 파일 중 `TEMPORARY` 또는 `PERSISTENT` 파일 시스템 내에서 존재 하는 경우, 해당 `Entry` 개체를 반환 합니다.\n\n이 특히 이전 장치 절대 경로 사용 하는 파일 전송 플러그인에 문제가 있다 (그리고 아직도 그들을 받아들일 수.) 그것은 `entry.toURL()`와 `entry.fullPath`를 대체 확인 장치에 파일을 사용 하는 플러그인을 지 고 그래서 파일 시스템 Url와 함께 제대로 작동 하려면 업데이트 되었습니다.\n\nV1.1.0에 `toURL()`의 반환 값 (\\[CB-6394\\] (https://issues.apache.org/jira/browse/CB-6394) 참조)로 바뀌었다 'file://' 절대 URL을 반환. 가능 하다 면. 보장 하는 ' cdvfile:'-URL `toInternalURL()`를 지금 사용할 수 있습니다. 이 메서드 이제 양식의 파일 Url을 반환 합니다.\n\n cdvfile://localhost/persistent/path/to/file\n \n\n어떤 파일을 고유 하 게 식별 하려면 사용할 수 있습니다.\n\n## 오류 코드 및 의미의 목록\n\n오류가 throw 됩니다 때 다음 코드 중 하나가 사용 됩니다.\n\n| 코드 | 상수 |\n| --:|:----------------------------- |\n| 1 | `NOT_FOUND_ERR` |\n| 2 | `SECURITY_ERR` |\n| 3 | `ABORT_ERR` |\n| 4 | `NOT_READABLE_ERR` |\n| 5 | `ENCODING_ERR` |\n| 6 | `NO_MODIFICATION_ALLOWED_ERR` |\n| 7 | `INVALID_STATE_ERR` |\n| 8 | `SYNTAX_ERR` |\n| 9 | `INVALID_MODIFICATION_ERR` |\n| 10 | `QUOTA_EXCEEDED_ERR` |\n| 11 | `TYPE_MISMATCH_ERR` |\n| 12 | `PATH_EXISTS_ERR` |\n\n## (선택 사항) 플러그인 구성\n\n사용 가능한 파일 시스템의 집합 플랫폼 당 구성된 될 수 있습니다. IOS와 안 드 로이드를 인식 한 `config.xml` 설치 될 파일 시스템 이름에 태그. 기본적으로 모든 파일 시스템 루트 사용할 수 있습니다.\n\n \n \n \n\n### 안 드 로이드\n\n* `files`: 응용 프로그램의 내부 파일 저장 디렉토리\n* `files-external`: 응용 프로그램의 외부 파일 저장 디렉토리\n* `sdcard`: 글로벌 외부 파일 저장 디렉토리 (이것은 SD 카드의 루트 설치 된 경우). 이것을 사용 하려면 `android.permission.WRITE_EXTERNAL_STORAGE` 권한이 있어야 합니다.\n* `cache`: 응용 프로그램의 내부 캐시 디렉터리\n* `cache-external`: 응용 프로그램의 외부 캐시 디렉터리\n* `root`: 전체 장치 파일 시스템\n\n안 드 로이드는 또한 \"파일\" 파일 시스템 내에서 \"/ 문서 /\" 하위 디렉토리를 나타내는 \"문서\" 라는 특별 한 파일을 지원 합니다.\n\n### iOS\n\n* `library`: 응용 프로그램의 라이브러리 디렉터리\n* `documents`: 응용 프로그램의 문서 디렉토리\n* `cache`: 응용 프로그램의 캐시 디렉터리\n* `bundle`: 응용 프로그램의 번들; (읽기 전용) 디스크에 응용 프로그램 자체의 위치\n* `root`: 전체 장치 파일 시스템\n\n기본적으로 라이브러리 및 문서 디렉토리 iCloud에 동기화 할 수 있습니다. 또한 2 개의 추가적인 파일 시스템, `library-nosync` 및 `documents-nosync`, 내 특별 한 동기화 되지 않은 디렉터리를 대표 하는 요청할 수 있습니다는 `/Library` 또는 `/Documents` 파일 시스템.\n"
},
{
"path": "plugins/cordova-plugin-file/doc/ko/plugins.md",
"content": "\n\n# 플러그인 개발자를 위한 노트\n\n이 노트는 주로 파일 플러그인을 사용 하 여 파일 시스템 플러그인 인터페이스를 작성 하 고 싶은 안 드 로이드와 iOS 개발자를 위한 것입니다.\n\n## 코르 도우 바 파일 시스템 Url 사용\n\n버전 1.0.0, 이후이 플러그인과 Url 사용 하고있다는 `cdvfile` 교량, 모든 통신에 대 한 제도 보다는 자바 원시 장치 파일 시스템 경로 노출.\n\n자바 스크립트 측면에서 즉 그 FileEntry 및 DirectoryEntry 개체 fullPath 속성을 HTML 파일 시스템의 루트에 상대적입니다. FileEntry 또는 DirectoryEntry 개체를 수락 하는 플러그인의 자바 API를 호출 해야 `.toURL()` 다리에 걸쳐 네이티브 코드에 전달 하기 전에 해당 개체에.\n\n### Cdvfile 변환: / / fileystem 경로 Url\n\n플러그인 파일 시스템을 작성 하는 실제 파일 시스템 위치에 받은 파일 시스템 URL을 변환 할 수 있습니다. 이렇게, 네이티브 플랫폼에 따라 여러 방법이 있다.\n\n기억 하는 것이 중요 하다 모든 `cdvfile://` Url은 실제 파일 장치에 매핑. 일부 Url 파일에 의해 표현 되지 않는 또는 심지어 원격 리소스를 참조할 수 있는 장치에 자산을 참조할 수 있습니다. 이러한 가능성 때문에 플러그인 경로를 Url을 변환 하려고 할 때 다시 의미 있는 결과 얻을 지 여부를 항상 테스트 해야 합니다.\n\n#### 안 드 로이드\n\n안 드 로이드, 변환 하는 간단한 방법에는 `cdvfile://` URL을 파일 시스템 경로 사용 하는 `org.apache.cordova.CordovaResourceApi` . `CordovaResourceApi`처리할 수 있는 여러 가지 방법에는 `cdvfile://` Url:\n\n webView 플러그인 클래스 CordovaResourceApi resourceApi의 멤버인 = webView.getResourceApi();\n \n 장치에이 파일을 나타내는 file:/// URL 얻기 / / 같은 URL 변경 파일 Uri fileURL에 매핑할 수 없는 경우 또는 = resourceApi.remapUri(Uri.parse(cdvfileURL));\n \n\n그것은 또한 파일 플러그인을 직접 사용할 수 있습니다:\n\n 가져오기 org.apache.cordova.file.FileUtils;\n 가져오기 org.apache.cordova.file.FileSystem;\n 가져오기 java.net.MalformedURLException;\n \n 플러그인 관리자에서 파일 플러그인을 얻을 FileUtils filePlugin = (FileUtils)webView.pluginManager.getPlugin(\"File\");\n \n 그것 시도 대 한 경로 얻을 URL을 감안할 때, {문자열 경로 = filePlugin.filesystemPathForURL(cdvfileURL);} catch (MalformedURLException e) {/ / 파일 시스템 url 인식 되지 않았습니다}\n \n\n경로를 변환 하는 `cdvfile://` URL:\n\n 가져오기 org.apache.cordova.file.LocalFilesystemURL;\n \n 장치 경로 대 한 LocalFilesystemURL 개체를 가져오기 / / cdvfile URL로 나타낼 수 없는 경우 null.\n LocalFilesystemURL url = filePlugin.filesystemURLforLocalPath(path);\n URL 개체 문자열 cdvfileURL의 문자열 표현을 = url.toString();\n \n\n플러그인 파일을 만들고 그것에 대 한 FileEntry 개체를 반환 하려면, 파일 플러그인을 사용.\n\n JSON 구조를 JavaScript에 반환을 위한 적당 한 반환 / /이 파일은 cdvfile URL로 표현 하는 경우 null.\n JSONObject 항목 = filePlugin.getEntryForFile(file);\n \n\n#### iOS\n\nIOS에서 코르도바 같은 사용 하지 않는 `CordovaResourceApi` 안 드 로이드 개념. Ios, Url 및 파일 시스템 경로 사이 변환 파일 플러그인을 사용 해야 합니다.\n\n URL 문자열 CDVFilesystemURL * url에서 CDVFilesystem URL 개체를 가져오기 = [CDVFilesystemURL fileSystemURLWithString:cdvfileURL];\n 파일 NSString * 경로에 매핑할 수 없는 경우 URL 개체 또는 없음에 대 한 경로 얻을 = [filePlugin filesystemPathForURL:url];\n \n \n 장치 경로 대 한 CDVFilesystem URL 개체를 가져오기 또는 / / 없음 cdvfile URL로 나타낼 수 없는 경우.\n CDVFilesystemURL * url = [filePlugin fileSystemURLforLocalPath:path];\n URL 개체 NSString * cdvfileURL의 문자열 표현을 = [url absoluteString];\n \n\n플러그인 파일을 만들고 그것에 대 한 FileEntry 개체를 반환 하려면, 파일 플러그인을 사용.\n\n 장치 경로 대 한 CDVFilesystem URL 개체를 가져오기 또는 / / 없음 cdvfile URL로 나타낼 수 없는 경우.\n CDVFilesystemURL * url = [filePlugin fileSystemURLforLocalPath:path];\n 자바 스크립트 NSDictionary * 항목으로 돌아가려면 구조를 얻을 = [filePlugin makeEntryForLocalURL:url]\n \n\n#### 자바 스크립트\n\n자바 스크립트에는 `cdvfile://` FileEntry 또는 DirectoryEntry 개체에서 URL 호출 `.toURL()` 그것에:\n\n var cdvfileURL = entry.toURL();\n \n\n플러그인 응답 처리기에서 실제 항목 개체로 반환 된 FileEntry 구조에서 변환 처리기 코드 해야 파일 플러그인 가져오고 새 개체를 만들:\n\n 적절 한 항목 개체 var 항목;\n 경우 (entryStruct.isDirectory) {항목 = 새 DirectoryEntry (entryStruct.name, entryStruct.fullPath, 새로운 FileSystem(entryStruct.filesystemName));} 다른 {항목 = 새로운 FileEntry (entryStruct.name, entryStruct.fullPath, 새로운 FileSystem(entryStruct.filesystemName));}"
},
{
"path": "plugins/cordova-plugin-file/doc/pl/README.md",
"content": "\n\n# cordova-plugin-file\n\n[](https://travis-ci.org/apache/cordova-plugin-file)\n\nTen plugin implementuje API pliku, dzięki czemu dostęp do odczytu i zapisu do plików znajdujących się na urządzeniu.\n\nTen plugin jest oparty na kilka specyfikacje, w tym: HTML5 File API \n\nKatalogi (nieistniejącego już) i System Najnowsze rozszerzenia: , chociaż większość z ten plugin kod został napisany podczas wcześniejszych specyfikacji były aktualne: \n\nTo również implementuje specyfikację FileWriter: \n\nWykorzystania, prosimy odnieść się do skały HTML5 doskonałe [plików art.](http://www.html5rocks.com/en/tutorials/file/filesystem/)\n\nOmówienie innych opcji przechowywania odnoszą się do Cordova z [magazynu przewodnik](http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html).\n\nTen plugin określa globalne `cordova.file` obiektu.\n\nChociaż w globalnym zasięgu, to nie dostępne dopiero po `deviceready` imprezie.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(cordova.file);\n }\n \n\n## Instalacja\n\n cordova plugin add cordova-plugin-file\n \n\n## Obsługiwane platformy\n\n * Amazon Fire OS\n * Android\n * BlackBerry 10\n * Firefox OS\n * iOS\n * Windows Phone 7 i 8 *\n * Windows 8 *\n * Windows*\n * Przeglądarka\n\n\\* *These platforms do not support `FileReader.readAsArrayBuffer` nor `FileWriter.write(blob)`.*\n\n## Gdzie przechowywać pliki\n\nOd v1.2.0 znajdują się adresy URL do katalogów ważne systemu plików. Każdy adres URL jest w formie *file:///path/to/spot/* i mogą być konwertowane na `DirectoryEntry` za pomocą `window.resolveLocalFileSystemURL()`.\n\n * `cordova.file.applicationDirectory`-Tylko do odczytu katalogu gdzie jest zainstalowana aplikacja. (*iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.applicationStorageDirectory`-Katalogu obszaru izolowanego aplikacji; na iOS to miejsce jest tylko do odczytu (ale podkatalogów określonego [jak `/Documents` ] są odczytu i zapisu). Wszystkie dane zawarte w jest prywatną do aplikacji. ( *iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.dataDirectory`-Trwałe i prywatne dane magazynowanie w izolowanym aplikacji przy użyciu pamięci wewnętrznej (na Android, jeśli trzeba użyć zewnętrznej pamięci, należy użyć `.externalDataDirectory` ). Na iOS, Katalog ten nie jest zsynchronizowane z iCloud (za pomocą `.syncedDataDirectory` ). (*iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.cacheDirectory`-Katalog dla plików buforowanych danych lub pliki, które aplikacji ponownie można łatwo tworzyć. System operacyjny może usunąć te pliki, gdy urządzenie działa niski na przechowywanie, niemniej jednak aplikacje nie powinny polegać na OS, aby usunąć pliki tutaj. (*iOS*, *Android*, *BlackBerry 10*)\n\n * `cordova.file.externalApplicationStorageDirectory`-Stosowania przestrzeni na zewnętrznej pamięci masowej. (*Android*)\n\n * `cordova.file.externalDataDirectory`-Gdzie umieścić pliki danych specyficznych dla aplikacji na zewnętrznej pamięci masowej. (*Android*)\n\n * `cordova.file.externalCacheDirectory`-Pamięci podręcznej aplikacji na zewnętrznej pamięci masowej. (*Android*)\n\n * `cordova.file.externalRootDirectory`-Korzeń zewnętrznej pamięci masowej (karty SD). (*Android*, *BlackBerry 10*)\n\n * `cordova.file.tempDirectory`-Temp katalogu systemu operacyjnego można wyczyścić w będzie. Nie należy polegać na OS wobec usunąć ten katalog; aplikacji należy zawsze usunąć pliki jako obowiązujące. (*iOS*)\n\n * `cordova.file.syncedDataDirectory`-Posiada pliki specyficzne dla aplikacji, które powinny być zsynchronizowane (np. do iCloud). (*iOS*)\n\n * `cordova.file.documentsDirectory`-Pliki prywatne do aplikacji, ale że mają znaczenie dla innych aplikacji (np. plików pakietu Office). (*iOS*)\n\n * `cordova.file.sharedDirectory`-Pliki dostępne na całym świecie do wszystkich aplikacji (*BlackBerry 10*)\n\n## Plik System układy\n\nChociaż technicznie implementacyjnym, może być bardzo przydatne wiedzieć, jak `cordova.file.*` właściwości mapy fizycznej ścieżki na prawdziwe urządzenie.\n\n### iOS układ systemu plików\n\n| Ścieżka urządzenia | `Cordova.File.*` | `iosExtraFileSystems` | r/w? | trwałe? | Czyści OS | Synchronizacja | prywatne |\n|:---------------------------------------------- |:--------------------------- |:--------------------- |:----:|:--------:|:-------------:|:--------------:|:--------:|\n| `/ var/mobile/Applications/< UUID > /` | applicationStorageDirectory | - | r | N/D! | N/D! | N/D! | Tak |\n| `appname.app/` | applicationDirectory | pakiet | r | N/D! | N/D! | N/D! | Tak |\n| `www/` | - | - | r | N/D! | N/D! | N/D! | Tak |\n| `Documents/` | documentsDirectory | dokumenty | r/w | Tak | Nr | Tak | Tak |\n| `NoCloud/` | - | dokumenty nosync | r/w | Tak | Nr | Nr | Tak |\n| `Library` | - | Biblioteka | r/w | Tak | Nr | Tak? | Tak |\n| `NoCloud/` | dataDirectory | Biblioteka nosync | r/w | Tak | Nr | Nr | Tak |\n| `Cloud/` | syncedDataDirectory | - | r/w | Tak | Nr | Tak | Tak |\n| `Caches/` | cacheDirectory | pamięci podręcznej | r/w | Tak * | Yes**\\* | Nr | Tak |\n| `tmp/` | tempDirectory | - | r/w | No** | Yes**\\* | Nr | Tak |\n\n\\ * Pliki utrzymywały aplikacja zostanie ponownie uruchomiony i uaktualnienia, ale w tym katalogu mogą być rozliczone przy każdym OS pragnień. Aplikacji należy umożliwić odtworzenie treści, które mogą być usunięte.\n\n** Plików może utrzymywać się po ponownym uruchomieniu aplikacji, ale nie opierają się na tym zachowaniu. Pliki nie są gwarantowane w aktualizacji. Aplikacji należy usunąć pliki z tego katalogu, gdy ma to zastosowanie, ponieważ system operacyjny nie gwarantuje Kiedy (lub nawet jeśli) te pliki zostaną usunięte.\n\n**\\ * System operacyjny może wyczyścić zawartość tego katalogu, gdy czuje, że jest to konieczne, ale nie powoływać się na to. Należy wyczyścić ten katalog jako odpowiednie dla aplikacji.\n\n### Układ systemu Android plików\n\n| Ścieżka urządzenia | `Cordova.File.*` | `AndroidExtraFileSystems` | r/w? | trwałe? | Czyści OS | prywatne |\n|:------------------------------------------------ |:----------------------------------- |:------------------------------- |:----:|:-------:|:---------:|:--------:|\n| `file:///android_asset/` | applicationDirectory | | r | N/D! | N/D! | Tak |\n| `/Data/danych/< Aplikacja id > /` | applicationStorageDirectory | - | r/w | N/D! | N/D! | Tak |\n| `cache` | cacheDirectory | pamięci podręcznej | r/w | Tak | Yes\\ * | Tak |\n| `files` | dataDirectory | pliki | r/w | Tak | Nr | Tak |\n| `Documents` | | dokumenty | r/w | Tak | Nr | Tak |\n| `< sdcard > /` | externalRootDirectory | sdcard | r/w | Tak | Nr | Nr |\n| `Android/data//` | externalApplicationStorageDirectory | - | r/w | Tak | Nr | Nr |\n| `cache` | externalCacheDirectry | zewnętrznych pamięci podręcznej | r/w | Tak | No** | Nr |\n| `files` | externalDataDirectory | zewnętrznych plików | r/w | Tak | Nr | Nr |\n\n\\ * OS może okresowo usunąć ten katalog, ale nie opierają się na tym zachowaniu. Wyczyść zawartość tego katalogu jako odpowiednie dla danej aplikacji. Należy użytkownik przeczyścić pamięć podręczną ręcznie, zawartość w tym katalogu są usuwane.\n\n** OS nie usunąć ten katalog automatycznie; Jesteś odpowiedzialny za zarządzanie zawartość siebie. Należy użytkownik przeczyścić pamięć podręczną ręcznie, zawartość katalogu są usuwane.\n\n**Uwaga**: Jeśli nie mogą być montowane pamięci masowej, właściwości `cordova.file.external*` są `wartości null`.\n\n### Układ systemu plików blackBerry 10\n\n| Ścieżka urządzenia | `Cordova.File.*` | r/w? | trwałe? | Czyści OS | prywatne |\n|:----------------------------------------------------------- |:--------------------------- |:----:|:-------:|:---------:|:--------:|\n| `file:///accounts/1000/AppData/ < id aplikacji > /` | applicationStorageDirectory | r | N/D! | N/D! | Tak |\n| `app/native` | applicationDirectory | r | N/D! | N/D! | Tak |\n| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | Nr | Tak | Tak |\n| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | Tak | Nr | Tak |\n| `file:///accounts/1000/Removable/sdcard` | externalRemovableDirectory | r/w | Tak | Nr | Nr |\n| `file:///accounts/1000/Shared` | sharedDirectory | r/w | Tak | Nr | Nr |\n\n*Uwaga*: gdy aplikacja jest rozmieszczana do pracy obwodu, wszystkie ścieżki są względne do /accounts/1000-enterprise.\n\n## Dziwactwa Androida\n\n### Lokalizacja przechowywania trwałych Android\n\nIstnieje wiele prawidłowe lokalizacje do przechowywania trwałych plików na telefonie z systemem Android. Zobacz [tę stronę](http://developer.android.com/guide/topics/data/data-storage.html) do szerokiej dyskusji o różnych możliwościach.\n\nPoprzednie wersje pluginu wybrać lokalizację plików tymczasowych i trwałe podczas uruchamiania, czy urządzenie twierdził, że karta SD (lub równoważne magazynowanie podzia³) był montowany w oparciu. Czy karta SD została zamontowana, czy duży wewnętrzny magazynowanie podzia³ był dostępny (takie jak na Nexus urządzenia,) a następnie trwałe pliki będą przechowywane w katalogu głównego tego miejsca. Oznaczało to, że wszystkie aplikacje Cordova może Zobacz wszystkie pliki dostępne na karcie.\n\nJeśli karta SD nie był dostępny, a następnie poprzednie wersje będzie przechowywać dane w `/data/data/`, która izoluje aplikacje od siebie, ale nadal może spowodować danych, które mają być współużytkowane przez użytkowników.\n\nTeraz jest możliwe, aby zdecydować, czy do przechowywania plików w lokalizacji magazynu plików, lub przy użyciu poprzednich logiki, z preferencją w aplikacji w pliku `config.xml`. Aby to zrobić, Dodaj jedną z tych dwóch linii do `pliku config.xml`:\n\n \n \n \n \n\nBez tej linii wtyczki pliku będzie używać `Compatibility` jako domyślny. Jeśli znacznik preferencji jest obecny i to nie jedną z tych wartości, aplikacja nie zostanie uruchomiona.\n\nJeśli aplikacja wcześniej zostało wysłane do użytkowników, przy użyciu starszych (pre-1.0) wersję tego pluginu i ma zapisane na dysku pliki w trwałych plików, a następnie należy ustawić preferencje do `Compatibility`. Przełączania lokalizacji do \"Internal\" oznacza, że istniejących użytkowników, którzy ich aplikacja może być niesłabnący wobec dostęp ich wcześniej zapisane pliki, w zależności od ich urządzenie.\n\nJeśli aplikacja jest nowy, lub ma nigdy wcześniej przechowywane pliki w systemie plików trwałe, ustawienie `Internal` generalnie jest zalecane.\n\n### Powolny cyklicznych operacji dla /android_asset\n\nLista katalogów aktywów jest bardzo powolny na Android. Można przyspieszyć to się jednak przez dodanie `src/android/build-extras.gradle` do katalogu głównego projektu android (również wymaga cordova-android@4.0.0 lub większej).\n\n## Dziwactwa iOS\n\n * `cordova.file.applicationStorageDirectory`jest tylko do odczytu; próby przechowywania plików w katalogu głównym zakończy się niepowodzeniem. Użyj jednego z innych `cordova.file.*` właściwości zdefiniowane dla iOS (tylko `applicationDirectory` i `applicationStorageDirectory` są tylko do odczytu).\n * `FileReader.readAsText(blob, encoding)` \n * `encoding`Parametr nie jest obsługiwana, i kodowanie UTF-8 jest zawsze w efekcie.\n\n### iOS lokalizacja przechowywania trwałych\n\nIstnieją dwa ważne miejsca trwałe pliki na urządzenia iOS: katalogu dokumentów i katalogu biblioteki. Poprzednie wersje pluginu tylko kiedykolwiek przechowywane trwałe pliki w katalogu dokumentów. To miał ten efekt uboczny od rozpoznawalności wszystkie pliki aplikacji w iTunes, który był często niezamierzone, zwłaszcza dla aplikacji, które obsługują wiele małych plików, zamiast produkuje kompletne dokumenty do wywozu, który jest przeznaczenie katalogu.\n\nTeraz jest możliwe, aby zdecydować, czy do przechowywania plików w dokumentach lub katalogu biblioteki, z preferencją w pliku `config.xml` aplikacji. Aby to zrobić, Dodaj jedną z tych dwóch linii do `pliku config.xml`:\n\n \n \n \n \n\nBez tej linii wtyczki pliku będzie używać `Compatibility` jako domyślny. Jeśli znacznik preferencji jest obecny i to nie jedną z tych wartości, aplikacja nie zostanie uruchomiona.\n\nJeśli aplikacja wcześniej zostało wysłane do użytkowników, przy użyciu starszych (pre-1.0) wersję tego pluginu i ma zapisane na dysku pliki w trwałych plików, a następnie należy ustawić preferencje do `Compatibility`. Przełączania lokalizacji do `Library` oznaczałoby, że istniejących użytkowników, którzy ich aplikacja będzie niesłabnący wobec dostęp ich wcześniej zapisane pliki.\n\nJeśli aplikacja jest nowy, lub nigdy wcześniej przechowywane pliki w trwałych plików, ustawień `Library` ogólnie jest zalecane.\n\n## Firefox OS dziwactwa\n\nAPI systemu plików nie jest obsługiwany macierzyście przez Firefox OS i jest zaimplementowany jako podkładki na indexedDB.\n\n * Nie usuwając niepuste katalogi\n * Nie obsługuje metadane dla katalogów\n * Metody `copyTo` i `moveTo` nie obsługuje katalogi\n\nObsługiwane są następujące ścieżki danych: * `applicationDirectory` - używa `xhr`, aby uzyskać lokalne pliki, które są pakowane z aplikacji. * `dataDirectory` - na trwałe dane specyficzne dla aplikacji pliki. * `cacheDirectory` - buforowanych plików, które powinny przetrwać ponowne uruchomienie aplikacji (aplikacje nie powinny polegać na OS, aby usunąć pliki tutaj).\n\n## Quirks przeglądarki\n\n### Wspólne dziwactw i uwagi\n\n * Każda przeglądarka używa własnej piaskownicy plików. IE i Firefox Użyj IndexedDB jako podstawa. Wszystkie przeglądarki za pomocą ukośnika jako separatora katalogu ścieżka.\n * Wpisy w katalogu mają być tworzone sukcesywnie. Na przykład wywołanie `fs.root.getDirectory (' dir1/dir2 ', {create:true}, successCallback, errorCallback)` zakończy się niepowodzeniem, jeśli nie istnieje dir1.\n * Plugin żądania użytkownika uprawnień do używania trwałe przechowywanie przy pierwszym uruchomieniu aplikacji. \n * Wtyczka obsługuje `cdvfile://localhost` (lokalne zasoby) tylko. Czyli zewnętrznych zasobów nie są obsługiwane przez `cdvfile`.\n * Plugin nie następować po [\"Plik API systemu nazw 8.3 ograniczenia\"](http://www.w3.org/TR/2011/WD-file-system-api-20110419/#naming-restrictions).\n * Obiektu BLOB i pliku \"`close` funkcja nie jest obsługiwana.\n * `FileSaver` i `BlobBuilder` nie są obsługiwane przez ten plugin i nie ma artykułów.\n * Plugin nie obsługuje `requestAllFileSystems`. Ta funkcja jest również brak w specyfikacji.\n * Wpisy w katalogu nie zostaną usunięte, jeśli używasz `create: true` flaga dla istniejącego katalogu.\n * Pliki utworzone za pomocą konstruktora nie są obsługiwane. Zamiast tego należy użyć metody entry.file.\n * Każda przeglądarka używa własnej postaci URL odwołania blob.\n * `readAsDataURL` funkcja jest obsługiwana, ale mediatype w Chrome zależy od wejścia z rozszerzeniem, mediatype w IE zawsze jest pusty (który jest taki sam jak `zwykły tekst` według specyfikacji), mediatype w Firefox jest zawsze `aplikacji/oktet strumień`. Na przykład, jeśli treść jest `abcdefg` Firefox wraca z `danych: stosowanie / octet-stream, base64, YWJjZGVmZw ==`, czyli zwraca `danych:; base64, YWJjZGVmZw ==`, Chrome zwraca `danych: < mediatype w zależności od rozszerzenia nazwy; > base64, YWJjZGVmZw ==`.\n * `toInternalURL` zwraca ścieżkę w postaci `file:///persistent/path/to/entry` (Firefox, IE). Chrom zwraca ścieżkę w postaci `cdvfile://localhost/persistent/file`.\n\n### Dziwactwa chrom\n\n * Chrom plików nie jest od razu gotowy po gotowe urządzenia. Jako rozwiązanie alternatywne można subskrybować zdarzenia `filePluginIsReady`. Przykład: \n\n```javascript\nwindow.addEventListener('filePluginIsReady', function(){ console.log('File plugin is ready');}, false);\n```\n\nFunkcja `window.isFilePluginReadyRaised` służy do sprawdzenia, czy zdarzenie już została podniesiona. -kwoty plików tymczasowych i trwałe window.requestFileSystem nie są ograniczone w Chrome. -W celu zwiększenia trwałego magazynu w Chrome, należy wywołać metodę `window.initPersistentFileSystem`. Domyślnie trwałe dyskowa jest 5 MB. -Chrome wymaga `--pozwalają--dostęp z plików` uruchomić argument na poparcie API za pośrednictwem protokołu `file:///`. -`Plik` obiekt będzie nie zmieniło jeśli flaga `{create:true}` gdy już istniejący `wpis`. -wydarzenia `zwrotu` właściwość jest zestaw true w Chrome. Jest to sprzeczne ze [specyfikacji](http://dev.w3.org/2009/dap/file-system/file-writer.html). -Funkcja `toURL` w Chrome zwraca `plików:`-poprzedzona ścieżką w zależności od aplikacji hosta. Na przykład, `filesystem:file:///persistent/somefile.txt`, `filesystem:http://localhost:8080/persistent/somefile.txt`. -wynik funkcji `toURL` nie zawierają ukośnika w wpis w katalogu. Chrom usuwa katalogi z ciąć doczepiane adresów URL poprawnie choć. -Metoda `resolveLocalFileSystemURL` wymaga przychodzących `url` mają prefiks `plików`. Na przykład parametr `adresu url` do `resolveLocalFileSystemURL` powinny być w formie `filesystem:file:///persistent/somefile.txt`, w przeciwieństwie do formularza `file:///persistent/somefile.txt` w Android. -Przestarzałe `toNativeURL` funkcja nie jest obsługiwana i nie tylko. -Funkcja `setMetadata` jest nie podane w specyfikacji i nie jest obsługiwane. -INVALID_MODIFICATION_ERR (kod: 9) jest generowany zamiast SYNTAX_ERR(code: 8) na żądanie nieistniejącą plików. -INVALID_MODIFICATION_ERR (kod: 9) jest generowany zamiast PATH_EXISTS_ERR(code: 12) próbuje stworzyć wyłącznie pliku lub katalogu, który już istnieje. -INVALID_MODIFICATION_ERR (kod: 9) jest generowany zamiast NO_MODIFICATION_ALLOWED_ERR(code: 6) na próby wywołania removeRecursively w głównym systemie plików. -INVALID_MODIFICATION_ERR (kod: 9) jest generowany zamiast NOT_FOUND_ERR(code: 1) na trudny do katalogu moveTo, który nie istnieje.\n\n### Na bazie IndexedDB impl dziwactw (Firefox i IE)\n\n * `.` i `.` nie są obsługiwane.\n * IE obsługuje `file:///`-tryb; tylko obsługiwane tryb jest obsługiwany (http://localhost:xxxx).\n * Rozmiar plików Firefox nie jest ograniczona, ale każde rozszerzenie 50MB zwróci użytkownikowi uprawnienia. IE10 pozwala maksymalnie 10mb połączone \"appcache\" i IndexedDB używane w implementacji systemu plików bez monitowania, gdy trafisz na tym poziomie, które uzyskasz, jeśli chcesz mogła ona zostać zwiększony do max 250mb na stronie. Więc `rozmiar` parametru funkcja `requestFileSystem` nie wpływa na system plików Firefox i IE.\n * `readAsBinaryString` funkcja nie jest określona w specyfikacji i nie obsługiwane w IE i nie tylko.\n * `File.Type` ma zawsze wartość null.\n * Nie należy utworzyć wpis za pomocą DirectoryEntry wystąpienie wynik wywołania zwrotnego, który został usunięty. W przeciwnym razie dostaniesz wpisem\"wiszące\".\n * Zanim będzie można przeczytać plik, który został napisany tylko trzeba uzyskać nowe wystąpienie tego pliku.\n * Funkcja `setMetadata`, która nie jest określona w specyfikacji obsługuje tylko zmian pola `modificationTime`. \n * `copyTo` i `moveTo` funkcji nie obsługuje katalogi.\n * Metadanych w katalogów nie jest obsługiwana.\n * Zarówno Entry.remove i directoryEntry.removeRecursively nie usuwając niepuste katalogi - katalogi są usuwane są czyszczone z treści zamiast.\n * `abort` i `truncate` funkcje nie są obsługiwane.\n * zdarzenia postępu nie są zwalniani. Na przykład to obsługa będzie nie wykonywane:\n\n```javascript\nwriter.onprogress = function() { /*commands*/ };\n```\n\n## Uaktualniania notatek\n\nW v1.0.0 tego pluginu struktury `FileEntry` i `DirectoryEntry` zmieniły się więcej zgodnie z opublikowaną specyfikacją.\n\nPoprzednie wersje (pre-1.0.0) plugin przechowywane urządzenia bezwzględna plik lokalizacja we właściwości `fullPath` `wpis` obiektów. Te ścieżki zazwyczaj będzie wyglądać\n\n /var/mobile/Applications//Documents/path/to/file (iOS)\n /storage/emulated/0/path/to/file (Android)\n \n\nTe ścieżki były także zwracany przez metodę `toURL()` `Entry` obiektów.\n\nZ v1.0.0 atrybut `fullPath` jest ścieżką do pliku, *względem katalogu głównego systemu plików HTML*. Tak powyżej ścieżki będzie teraz zarówno być reprezentowane przez obiekt `FileEntry` z `fullPath` o\n\n /path/to/file\n \n\nJeśli aplikacja działa z ścieżki bezwzględnej urządzeń, i możesz wcześniej źródło tych ścieżek przez właściwość `fullPath` `wpis` obiektów, należy zaktualizować kod, aby zamiast tego użyj `entry.toURL()`.\n\nDla wstecznej kompatybilności, Metoda `resolveLocalFileSystemURL()` będzie zaakceptować urządzenia ścieżka bezwzględna i zwróci obiekt `Entry` odpowiadający, tak długo, jak ten plik istnieje w albo `TEMPORARY` lub `PERSISTENT` systemy plików.\n\nTo szczególnie został problem z pluginem transferu plików, które poprzednio używane ścieżki bezwzględnej urządzeń (i wciąż można je przyjąć). Została zaktualizowana do pracy poprawnie z adresów URL plików, więc wymiana `entry.fullPath` z `entry.toURL()` powinno rozwiązać wszelkie problemy dostawanie ten plugin do pracy z plików w pamięci urządzenia.\n\nW v1.1.0 wartość zwracana przez `toURL()` został zmieniony (patrz \\[CB-6394\\] (https://issues.apache.org/jira/browse/CB-6394)) zwraca adres URL absolutnej \"file://\". wszędzie tam, gdzie jest to możliwe. Aby zapewnić ' cdvfile:'-URL można użyć `toInternalURL()` teraz. Ta metoda zwróci teraz adresy URL plików formularza\n\n cdvfile://localhost/persistent/path/to/file\n \n\nktóry służy do jednoznacznej identyfikacji pliku.\n\n## Wykaz kodów błędów i ich znaczenie\n\nGdy błąd jest generowany, jeden z następujących kodów będzie służyć.\n\n| Kod | Stała |\n| ---:|:----------------------------- |\n| 1 | `NOT_FOUND_ERR` |\n| 2 | `SECURITY_ERR` |\n| 3 | `ABORT_ERR` |\n| 4 | `NOT_READABLE_ERR` |\n| 5 | `ENCODING_ERR` |\n| 6 | `NO_MODIFICATION_ALLOWED_ERR` |\n| 7 | `INVALID_STATE_ERR` |\n| 8 | `SYNTAX_ERR` |\n| 9 | `INVALID_MODIFICATION_ERR` |\n| 10 | `QUOTA_EXCEEDED_ERR` |\n| 11 | `TYPE_MISMATCH_ERR` |\n| 12 | `PATH_EXISTS_ERR` |\n\n## Konfigurowanie wtyczka (opcjonalny)\n\nZestaw dostępnych plików może być skonfigurowany na platformie. Zarówno iOS i Android Tag w `pliku config.xml`, których nazwy plików do instalacji. Domyślnie włączone są wszystkie korzenie systemu plików.\n\n \n \n \n\n### Android\n\n * `files`: katalogu przechowywania plików aplikacji\n * `files-external`: katalog aplikacji zewnętrznych plików\n * `sdcard`: katalog globalny plik zewnętrzny (to jest głównym karty SD, jeśli jedna jest zainstalowana). Musi mieć uprawnienia `android.permission.WRITE_EXTERNAL_STORAGE` wobec używać ten.\n * `cache`: katalogu wewnętrznej pamięci podręcznej aplikacji\n * `cache-external`: katalogu aplikacji zewnętrznych pamięci podręcznej\n * `root`: całe urządzenie systemu plików\n\nAndroid obsługuje również specjalnych plików o nazwie \"dokumenty\", który reprezentuje podkatalog \"/ dokumenty /\" w ramach systemu plików \"pliki\".\n\n### iOS\n\n * `library`: katalog biblioteki aplikacji\n * `documents`: dokumenty katalogu aplikacji\n * `cache`: katalogu pamięci podręcznej aplikacji\n * `bundle`: pakiet aplikacji; Lokalizacja aplikacji na dysku (tylko do odczytu)\n * `root`: całe urządzenie systemu plików\n\nDomyślnie katalogi biblioteki i dokumenty mogą być synchronizowane iCloud. Można również zażądać dwóch dodatkowych plików, `library-nosync` i `documents-nosync`, które stanowią specjalny katalog nie zsynchronizowane w `/Library` lub systemu plików `/Documents`."
},
{
"path": "plugins/cordova-plugin-file/doc/pl/index.md",
"content": "\n\n# cordova-plugin-file\n\nTen plugin implementuje API pliku, dzięki czemu dostęp do odczytu i zapisu do plików znajdujących się na urządzeniu.\n\nTen plugin jest oparty na kilka specyfikacje, w tym: HTML5 File API \n\nKatalogi (nieistniejącego już) i System Najnowsze rozszerzenia: , chociaż większość z ten plugin kod został napisany podczas wcześniejszych specyfikacji były aktualne: \n\nTo również implementuje specyfikację FileWriter: \n\nWykorzystania, prosimy odnieść się do skały HTML5 doskonałe [plików art.][1]\n\n [1]: http://www.html5rocks.com/en/tutorials/file/filesystem/\n\nOmówienie innych opcji przechowywania odnoszą się do Cordova z [magazynu przewodnik][2].\n\n [2]: http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html\n\nTen plugin określa globalne `cordova.file` obiektu.\n\nChociaż w globalnym zasięgu, to nie dostępne dopiero po `deviceready` imprezie.\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(cordova.file);\n }\n \n\n## Instalacja\n\n cordova plugin add cordova-plugin-file\n \n\n## Obsługiwane platformy\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* Firefox OS\n* iOS\n* Windows Phone 7 i 8 *\n* Windows 8 *\n* Przeglądarka\n\n* *Nie obsługują tych platform, `FileReader.readAsArrayBuffer` ani `FileWriter.write(blob)`.*\n\n## Gdzie przechowywać pliki\n\nOd v1.2.0 znajdują się adresy URL do katalogów ważne systemu plików. Każdy adres URL jest w formie *file:///path/to/spot/* i mogą być konwertowane na `DirectoryEntry` za pomocą `window.resolveLocalFileSystemURL()`.\n\n* `cordova.file.applicationDirectory`-Tylko do odczytu katalogu gdzie jest zainstalowana aplikacja. (*iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.applicationStorageDirectory`-Katalogu obszaru izolowanego aplikacji; na iOS to miejsce jest tylko do odczytu (ale podkatalogów określonego [jak `/Documents` ] są odczytu i zapisu). Wszystkie dane zawarte w jest prywatną do aplikacji. ( *iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.dataDirectory`-Trwałe i prywatne dane magazynowanie w izolowanym aplikacji przy użyciu pamięci wewnętrznej (na Android, jeśli trzeba użyć zewnętrznej pamięci, należy użyć `.externalDataDirectory` ). Na iOS, Katalog ten nie jest zsynchronizowane z iCloud (za pomocą `.syncedDataDirectory` ). (*iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.cacheDirectory`-Katalog dla plików buforowanych danych lub pliki, które aplikacji ponownie można łatwo tworzyć. System operacyjny może usunąć te pliki, gdy urządzenie działa niski na przechowywanie, niemniej jednak aplikacje nie powinny polegać na OS, aby usunąć pliki tutaj. (*iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.externalApplicationStorageDirectory`-Stosowania przestrzeni na zewnętrznej pamięci masowej. (*Android*)\n\n* `cordova.file.externalDataDirectory`-Gdzie umieścić pliki danych specyficznych dla aplikacji na zewnętrznej pamięci masowej. (*Android*)\n\n* `cordova.file.externalCacheDirectory`-Pamięci podręcznej aplikacji na zewnętrznej pamięci masowej. (*Android*)\n\n* `cordova.file.externalRootDirectory`-Korzeń zewnętrznej pamięci masowej (karty SD). (*Android*, *BlackBerry 10*)\n\n* `cordova.file.tempDirectory`-Temp katalogu systemu operacyjnego można wyczyścić w będzie. Nie należy polegać na OS wobec usunąć ten katalog; aplikacji należy zawsze usunąć pliki jako obowiązujące. (*iOS*)\n\n* `cordova.file.syncedDataDirectory`-Posiada pliki specyficzne dla aplikacji, które powinny być zsynchronizowane (np. do iCloud). (*iOS*)\n\n* `cordova.file.documentsDirectory`-Pliki prywatne do aplikacji, ale że mają znaczenie dla innych aplikacji (np. plików pakietu Office). (*iOS*)\n\n* `cordova.file.sharedDirectory`-Pliki dostępne na całym świecie do wszystkich aplikacji (*BlackBerry 10*)\n\n## Plik System układy\n\nChociaż technicznie implementacyjnym, może być bardzo przydatne wiedzieć, jak `cordova.file.*` właściwości mapy fizycznej ścieżki na prawdziwe urządzenie.\n\n### iOS układ systemu plików\n\n| Ścieżka urządzenia | `Cordova.File.*` | `iosExtraFileSystems` | r/w? | trwałe? | Czyści OS | Synchronizacja | prywatne |\n|:-------------------------------------------- |:--------------------------- |:--------------------- |:----:|:-------:|:-----------:|:--------------:|:--------:|\n| `/ var/mobile/Applications/< UUID > /` | applicationStorageDirectory | - | r | N/D! | N/D! | N/D! | Tak |\n| `appname.app/` | applicationDirectory | pakiet | r | N/D! | N/D! | N/D! | Tak |\n| `www/` | - | - | r | N/D! | N/D! | N/D! | Tak |\n| `Documents/` | documentsDirectory | dokumenty | r/w | Tak | Nr | Tak | Tak |\n| `NoCloud/` | - | dokumenty nosync | r/w | Tak | Nr | Nr | Tak |\n| `Library` | - | Biblioteka | r/w | Tak | Nr | Tak? | Tak |\n| `NoCloud/` | dataDirectory | Biblioteka nosync | r/w | Tak | Nr | Nr | Tak |\n| `Cloud/` | syncedDataDirectory | - | r/w | Tak | Nr | Tak | Tak |\n| `Caches/` | cacheDirectory | pamięci podręcznej | r/w | Tak * | Tak * * *| | Nr | Tak |\n| `tmp/` | tempDirectory | - | r/w | Nie * * | Tak * * *| | Nr | Tak |\n\n* Pliki utrzymywały aplikacja zostanie ponownie uruchomiony i uaktualnienia, ale w tym katalogu mogą być rozliczone, gdy OS pragnienia. Aplikacji powinny być w stanie odtworzyć zawartość, która może być usunięta.\n\n* * Plików może utrzymywać się po ponownym uruchomieniu aplikacji, ale nie opierają się na tym zachowaniu. Pliki nie są gwarantowane w aktualizacji. Aplikacji należy usunąć pliki z tego katalogu, gdy ma to zastosowanie, ponieważ system operacyjny nie gwarantuje Kiedy (lub nawet jeśli) te pliki zostaną usunięte.\n\n* * *| System operacyjny może wyczyścić zawartość w tym katalogu, gdy czuje, że jest to konieczne, ale nie powoływać się na to. Należy wyczyścić ten katalog jako odpowiednie dla aplikacji.\n\n### Układ systemu Android plików\n\n| Ścieżka urządzenia | `Cordova.File.*` | `AndroidExtraFileSystems` | r/w? | trwałe? | Czyści OS | prywatne |\n|:--------------------------------------- |:----------------------------------- |:------------------------------- |:----:|:-------:|:---------:|:--------:|\n| `file:///android_asset/` | applicationDirectory | | r | N/D! | N/D! | Tak |\n| `/Data/danych/< Aplikacja id > /` | applicationStorageDirectory | - | r/w | N/D! | N/D! | Tak |\n| `cache` | cacheDirectory | pamięci podręcznej | r/w | Tak | Tak * | Tak |\n| `files` | dataDirectory | pliki | r/w | Tak | Nr | Tak |\n| `Documents` | | dokumenty | r/w | Tak | Nr | Tak |\n| `< sdcard > /` | externalRootDirectory | sdcard | r/w | Tak | Nr | Nr |\n| `Android/data//` | externalApplicationStorageDirectory | - | r/w | Tak | Nr | Nr |\n| `cache` | externalCacheDirectry | zewnętrznych pamięci podręcznej | r/w | Tak | Nie * * | Nr |\n| `files` | externalDataDirectory | zewnętrznych plików | r/w | Tak | Nr | Nr |\n\n* System operacyjny może okresowo usunąć ten katalog, ale nie opierają się na tym zachowaniu. Wyczyść zawartość tego katalogu jako odpowiednie dla danej aplikacji. Należy użytkownik przeczyścić pamięć podręczną ręcznie, zawartość w tym katalogu są usuwane.\n\n* * System operacyjny nie usunąć ten katalog automatycznie; Jesteś odpowiedzialny za zarządzanie zawartość siebie. Należy użytkownik przeczyścić pamięć podręczną ręcznie, zawartość katalogu są usuwane.\n\n**Uwaga**: Jeśli nie mogą być montowane pamięci masowej, właściwości `cordova.file.external*` są `wartości null`.\n\n### Układ systemu plików blackBerry 10\n\n| Ścieżka urządzenia | `Cordova.File.*` | r/w? | trwałe? | Czyści OS | prywatne |\n|:--------------------------------------------------------- |:--------------------------- |:----:|:-------:|:---------:|:--------:|\n| `file:///accounts/1000/AppData/ < id aplikacji > /` | applicationStorageDirectory | r | N/D! | N/D! | Tak |\n| `app/native` | applicationDirectory | r | N/D! | N/D! | Tak |\n| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | Nr | Tak | Tak |\n| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | Tak | Nr | Tak |\n| `file:///accounts/1000/Removable/sdcard` | externalRemovableDirectory | r/w | Tak | Nr | Nr |\n| `file:///accounts/1000/Shared` | sharedDirectory | r/w | Tak | Nr | Nr |\n\n*Uwaga*: gdy aplikacja jest rozmieszczana do pracy obwodu, wszystkie ścieżki są względne do /accounts/1000-enterprise.\n\n## Dziwactwa Androida\n\n### Lokalizacja przechowywania trwałych Android\n\nIstnieje wiele prawidłowe lokalizacje do przechowywania trwałych plików na telefonie z systemem Android. Zobacz [tę stronę][3] do szerokiej dyskusji o różnych możliwościach.\n\n [3]: http://developer.android.com/guide/topics/data/data-storage.html\n\nPoprzednie wersje pluginu wybrać lokalizację plików tymczasowych i trwałe podczas uruchamiania, czy urządzenie twierdził, że karta SD (lub równoważne magazynowanie podzia³) był montowany w oparciu. Czy karta SD została zamontowana, czy duży wewnętrzny magazynowanie podzia³ był dostępny (takie jak na Nexus urządzenia,) a następnie trwałe pliki będą przechowywane w katalogu głównego tego miejsca. Oznaczało to, że wszystkie aplikacje Cordova może Zobacz wszystkie pliki dostępne na karcie.\n\nJeśli karta SD nie był dostępny, a następnie poprzednie wersje będzie przechowywać dane w `/data/data/`, która izoluje aplikacje od siebie, ale nadal może spowodować danych, które mają być współużytkowane przez użytkowników.\n\nTeraz jest możliwe, aby zdecydować, czy do przechowywania plików w lokalizacji magazynu plików, lub przy użyciu poprzednich logiki, z preferencją w aplikacji w pliku `config.xml`. Aby to zrobić, Dodaj jedną z tych dwóch linii do `pliku config.xml`:\n\n \n \n \n \n\nBez tej linii wtyczki pliku będzie używać `Compatibility` jako domyślny. Jeśli znacznik preferencji jest obecny i to nie jedną z tych wartości, aplikacja nie zostanie uruchomiona.\n\nJeśli aplikacja wcześniej zostało wysłane do użytkowników, przy użyciu starszych (pre-1.0) wersję tego pluginu i ma zapisane na dysku pliki w trwałych plików, a następnie należy ustawić preferencje do `Compatibility`. Przełączania lokalizacji do \"Internal\" oznacza, że istniejących użytkowników, którzy ich aplikacja może być niesłabnący wobec dostęp ich wcześniej zapisane pliki, w zależności od ich urządzenie.\n\nJeśli aplikacja jest nowy, lub ma nigdy wcześniej przechowywane pliki w systemie plików trwałe, ustawienie `Internal` generalnie jest zalecane.\n\n## Dziwactwa iOS\n\n* `cordova.file.applicationStorageDirectory`jest tylko do odczytu; próby przechowywania plików w katalogu głównym zakończy się niepowodzeniem. Użyj jednego z innych `cordova.file.*` właściwości zdefiniowane dla iOS (tylko `applicationDirectory` i `applicationStorageDirectory` są tylko do odczytu).\n* `FileReader.readAsText(blob, encoding)` \n * `encoding`Parametr nie jest obsługiwana, i kodowanie UTF-8 jest zawsze w efekcie.\n\n### iOS lokalizacja przechowywania trwałych\n\nIstnieją dwa ważne miejsca trwałe pliki na urządzenia iOS: katalogu dokumentów i katalogu biblioteki. Poprzednie wersje pluginu tylko kiedykolwiek przechowywane trwałe pliki w katalogu dokumentów. To miał ten efekt uboczny od rozpoznawalności wszystkie pliki aplikacji w iTunes, który był często niezamierzone, zwłaszcza dla aplikacji, które obsługują wiele małych plików, zamiast produkuje kompletne dokumenty do wywozu, który jest przeznaczenie katalogu.\n\nTeraz jest możliwe, aby zdecydować, czy do przechowywania plików w dokumentach lub katalogu biblioteki, z preferencją w pliku `config.xml` aplikacji. Aby to zrobić, Dodaj jedną z tych dwóch linii do `pliku config.xml`:\n\n \n \n \n \n\nBez tej linii wtyczki pliku będzie używać `Compatibility` jako domyślny. Jeśli znacznik preferencji jest obecny i to nie jedną z tych wartości, aplikacja nie zostanie uruchomiona.\n\nJeśli aplikacja wcześniej zostało wysłane do użytkowników, przy użyciu starszych (pre-1.0) wersję tego pluginu i ma zapisane na dysku pliki w trwałych plików, a następnie należy ustawić preferencje do `Compatibility`. Przełączania lokalizacji do `Library` oznaczałoby, że istniejących użytkowników, którzy ich aplikacja będzie niesłabnący wobec dostęp ich wcześniej zapisane pliki.\n\nJeśli aplikacja jest nowy, lub nigdy wcześniej przechowywane pliki w trwałych plików, ustawień `Library` ogólnie jest zalecane.\n\n## Firefox OS dziwactwa\n\nAPI systemu plików nie jest obsługiwany macierzyście przez Firefox OS i jest zaimplementowany jako podkładki na indexedDB.\n\n* Nie usuwając niepuste katalogi\n* Nie obsługuje metadane dla katalogów\n* Metody `copyTo` i `moveTo` nie obsługuje katalogi\n\nObsługiwane są następujące ścieżki danych: * `applicationDirectory` - używa `xhr`, aby uzyskać lokalne pliki, które są pakowane z aplikacji. * `dataDirectory` - na trwałe dane specyficzne dla aplikacji pliki. * `cacheDirectory` - buforowanych plików, które powinny przetrwać ponowne uruchomienie aplikacji (aplikacje nie powinny polegać na OS, aby usunąć pliki tutaj).\n\n## Quirks przeglądarki\n\n### Wspólne dziwactw i uwagi\n\n* Każda przeglądarka używa własnej piaskownicy plików. IE i Firefox Użyj IndexedDB jako podstawa. Wszystkie przeglądarki za pomocą ukośnika jako separatora katalogu ścieżka.\n* Wpisy w katalogu mają być tworzone sukcesywnie. Na przykład wywołanie `fs.root.getDirectory (' dir1/dir2 ', {create:true}, successCallback, errorCallback)` zakończy się niepowodzeniem, jeśli nie istnieje dir1.\n* Plugin żądania użytkownika uprawnień do używania trwałe przechowywanie przy pierwszym uruchomieniu aplikacji. \n* Wtyczka obsługuje `cdvfile://localhost` (lokalne zasoby) tylko. Czyli zewnętrznych zasobów nie są obsługiwane przez `cdvfile`.\n* Plugin nie następować po [\"Plik API systemu nazw 8.3 ograniczenia\"][4].\n* Obiektu BLOB i pliku \"`close` funkcja nie jest obsługiwana.\n* `FileSaver` i `BlobBuilder` nie są obsługiwane przez ten plugin i nie ma artykułów.\n* Plugin nie obsługuje `requestAllFileSystems`. Ta funkcja jest również brak w specyfikacji.\n* Wpisy w katalogu nie zostaną usunięte, jeśli używasz `create: true` flaga dla istniejącego katalogu.\n* Pliki utworzone za pomocą konstruktora nie są obsługiwane. Zamiast tego należy użyć metody entry.file.\n* Każda przeglądarka używa własnej postaci URL odwołania blob.\n* `readAsDataURL` funkcja jest obsługiwana, ale mediatype w Chrome zależy od wejścia z rozszerzeniem, mediatype w IE zawsze jest pusty (który jest taki sam jak `zwykły tekst` według specyfikacji), mediatype w Firefox jest zawsze `aplikacji/oktet strumień`. Na przykład, jeśli treść jest `abcdefg` Firefox wraca z `danych: stosowanie / octet-stream, base64, YWJjZGVmZw ==`, czyli zwraca `danych:; base64, YWJjZGVmZw ==`, Chrome zwraca `danych: < mediatype w zależności od rozszerzenia nazwy; > base64, YWJjZGVmZw ==`.\n* `toInternalURL` zwraca ścieżkę w postaci `file:///persistent/path/to/entry` (Firefox, IE). Chrom zwraca ścieżkę w postaci `cdvfile://localhost/persistent/file`.\n\n [4]: http://www.w3.org/TR/2011/WD-file-system-api-20110419/#naming-restrictions\n\n### Dziwactwa chrom\n\n* Chrom plików nie jest od razu gotowy po gotowe urządzenia. Jako rozwiązanie alternatywne można subskrybować zdarzenia `filePluginIsReady`. Przykład: \n\n javascript\n window.addEventListener('filePluginIsReady', function(){ console.log('File plugin is ready');}, false);\n \n\nFunkcja `window.isFilePluginReadyRaised` służy do sprawdzenia, czy zdarzenie już została podniesiona. -kwoty plików tymczasowych i trwałe window.requestFileSystem nie są ograniczone w Chrome. -W celu zwiększenia trwałego magazynu w Chrome, należy wywołać metodę `window.initPersistentFileSystem`. Domyślnie trwałe dyskowa jest 5 MB. -Chrome wymaga `--pozwalają--dostęp z plików` uruchomić argument na poparcie API za pośrednictwem protokołu `file:///`. -`Plik` obiekt będzie nie zmieniło jeśli flaga `{create:true}` gdy już istniejący `wpis`. -wydarzenia `zwrotu` właściwość jest zestaw true w Chrome. Jest to sprzeczne ze [specyfikacji][5]. -Funkcja `toURL` w Chrome zwraca `plików:`-poprzedzona ścieżką w zależności od aplikacji hosta. Na przykład, `filesystem:file:///persistent/somefile.txt`, `filesystem:http://localhost:8080/persistent/somefile.txt`. -wynik funkcji `toURL` nie zawierają ukośnika w wpis w katalogu. Chrom usuwa katalogi z ciąć doczepiane adresów URL poprawnie choć. -Metoda `resolveLocalFileSystemURL` wymaga przychodzących `url` mają prefiks `plików`. Na przykład parametr `adresu url` do `resolveLocalFileSystemURL` powinny być w formie `filesystem:file:///persistent/somefile.txt`, w przeciwieństwie do formularza `file:///persistent/somefile.txt` w Android. -Przestarzałe `toNativeURL` funkcja nie jest obsługiwana i nie tylko. -Funkcja `setMetadata` jest nie podane w specyfikacji i nie jest obsługiwane. -INVALID_MODIFICATION_ERR (kod: 9) jest generowany zamiast SYNTAX_ERR(code: 8) na żądanie nieistniejącą plików. -INVALID_MODIFICATION_ERR (kod: 9) jest generowany zamiast PATH_EXISTS_ERR(code: 12) próbuje stworzyć wyłącznie pliku lub katalogu, który już istnieje. -INVALID_MODIFICATION_ERR (kod: 9) jest generowany zamiast NO_MODIFICATION_ALLOWED_ERR(code: 6) na próby wywołania removeRecursively w głównym systemie plików. -INVALID_MODIFICATION_ERR (kod: 9) jest generowany zamiast NOT_FOUND_ERR(code: 1) na trudny do katalogu moveTo, który nie istnieje.\n\n [5]: http://dev.w3.org/2009/dap/file-system/file-writer.html\n\n### Na bazie IndexedDB impl dziwactw (Firefox i IE)\n\n* `.` i `.` nie są obsługiwane.\n* IE obsługuje `file:///`-tryb; tylko obsługiwane tryb jest obsługiwany (http://localhost:xxxx).\n* Rozmiar plików Firefox nie jest ograniczona, ale każde rozszerzenie 50MB zwróci użytkownikowi uprawnienia. IE10 pozwala maksymalnie 10mb połączone \"appcache\" i IndexedDB używane w implementacji systemu plików bez monitowania, gdy trafisz na tym poziomie, które uzyskasz, jeśli chcesz mogła ona zostać zwiększony do max 250mb na stronie. Więc `rozmiar` parametru funkcja `requestFileSystem` nie wpływa na system plików Firefox i IE.\n* `readAsBinaryString` funkcja nie jest określona w specyfikacji i nie obsługiwane w IE i nie tylko.\n* `File.Type` ma zawsze wartość null.\n* Nie należy utworzyć wpis za pomocą DirectoryEntry wystąpienie wynik wywołania zwrotnego, który został usunięty. W przeciwnym razie dostaniesz wpisem\"wiszące\".\n* Zanim będzie można przeczytać plik, który został napisany tylko trzeba uzyskać nowe wystąpienie tego pliku.\n* Funkcja `setMetadata`, która nie jest określona w specyfikacji obsługuje tylko zmian pola `modificationTime`. \n* `copyTo` i `moveTo` funkcji nie obsługuje katalogi.\n* Metadanych w katalogów nie jest obsługiwana.\n* Zarówno Entry.remove i directoryEntry.removeRecursively nie usuwając niepuste katalogi - katalogi są usuwane są czyszczone z treści zamiast.\n* `abort` i `truncate` funkcje nie są obsługiwane.\n* zdarzenia postępu nie są zwalniani. Na przykład to obsługa będzie nie wykonywane:\n\n javascript\n writer.onprogress = function() { /*commands*/ };\n \n\n## Uaktualniania notatek\n\nW v1.0.0 tego pluginu struktury `FileEntry` i `DirectoryEntry` zmieniły się więcej zgodnie z opublikowaną specyfikacją.\n\nPoprzednie wersje (pre-1.0.0) plugin przechowywane urządzenia bezwzględna plik lokalizacja we właściwości `fullPath` `wpis` obiektów. Te ścieżki zazwyczaj będzie wyglądać\n\n /var/mobile/Applications//Documents/path/to/file (iOS)\n /storage/emulated/0/path/to/file (Android)\n \n\nTe ścieżki były także zwracany przez metodę `toURL()` `Entry` obiektów.\n\nZ v1.0.0 atrybut `fullPath` jest ścieżką do pliku, *względem katalogu głównego systemu plików HTML*. Tak powyżej ścieżki będzie teraz zarówno być reprezentowane przez obiekt `FileEntry` z `fullPath` o\n\n /path/to/file\n \n\nJeśli aplikacja działa z ścieżki bezwzględnej urządzeń, i możesz wcześniej źródło tych ścieżek przez właściwość `fullPath` `wpis` obiektów, należy zaktualizować kod, aby zamiast tego użyj `entry.toURL()`.\n\nDla wstecznej kompatybilności, Metoda `resolveLocalFileSystemURL()` będzie zaakceptować urządzenia ścieżka bezwzględna i zwróci obiekt `Entry` odpowiadający, tak długo, jak ten plik istnieje w albo `TEMPORARY` lub `PERSISTENT` systemy plików.\n\nTo szczególnie został problem z pluginem transferu plików, które poprzednio używane ścieżki bezwzględnej urządzeń (i wciąż można je przyjąć). Została zaktualizowana do pracy poprawnie z adresów URL plików, więc wymiana `entry.fullPath` z `entry.toURL()` powinno rozwiązać wszelkie problemy dostawanie ten plugin do pracy z plików w pamięci urządzenia.\n\nW v1.1.0 wartość zwracana przez `toURL()` został zmieniony (patrz \\[CB-6394\\] (https://issues.apache.org/jira/browse/CB-6394)) zwraca adres URL absolutnej \"file://\". wszędzie tam, gdzie jest to możliwe. Aby zapewnić ' cdvfile:'-URL można użyć `toInternalURL()` teraz. Ta metoda zwróci teraz adresy URL plików formularza\n\n cdvfile://localhost/persistent/path/to/file\n \n\nktóry służy do jednoznacznej identyfikacji pliku.\n\n## Wykaz kodów błędów i ich znaczenie\n\nGdy błąd jest generowany, jeden z następujących kodów będzie służyć.\n\n| Kod | Stała |\n| ---:|:----------------------------- |\n| 1 | `NOT_FOUND_ERR` |\n| 2 | `SECURITY_ERR` |\n| 3 | `ABORT_ERR` |\n| 4 | `NOT_READABLE_ERR` |\n| 5 | `ENCODING_ERR` |\n| 6 | `NO_MODIFICATION_ALLOWED_ERR` |\n| 7 | `INVALID_STATE_ERR` |\n| 8 | `SYNTAX_ERR` |\n| 9 | `INVALID_MODIFICATION_ERR` |\n| 10 | `QUOTA_EXCEEDED_ERR` |\n| 11 | `TYPE_MISMATCH_ERR` |\n| 12 | `PATH_EXISTS_ERR` |\n\n## Konfigurowanie wtyczka (opcjonalny)\n\nZestaw dostępnych plików może być skonfigurowany na platformie. Zarówno iOS i Android Tag w `pliku config.xml`, których nazwy plików do instalacji. Domyślnie włączone są wszystkie korzenie systemu plików.\n\n \n \n \n\n### Android\n\n* `files`: katalogu przechowywania plików aplikacji\n* `files-external`: katalog aplikacji zewnętrznych plików\n* `sdcard`: katalog globalny plik zewnętrzny (to jest głównym karty SD, jeśli jedna jest zainstalowana). Musi mieć uprawnienia `android.permission.WRITE_EXTERNAL_STORAGE` wobec używać ten.\n* `cache`: katalogu wewnętrznej pamięci podręcznej aplikacji\n* `cache-external`: katalogu aplikacji zewnętrznych pamięci podręcznej\n* `root`: całe urządzenie systemu plików\n\nAndroid obsługuje również specjalnych plików o nazwie \"dokumenty\", który reprezentuje podkatalog \"/ dokumenty /\" w ramach systemu plików \"pliki\".\n\n### iOS\n\n* `library`: katalog biblioteki aplikacji\n* `documents`: dokumenty katalogu aplikacji\n* `cache`: katalogu pamięci podręcznej aplikacji\n* `bundle`: pakiet aplikacji; Lokalizacja aplikacji na dysku (tylko do odczytu)\n* `root`: całe urządzenie systemu plików\n\nDomyślnie katalogi biblioteki i dokumenty mogą być synchronizowane iCloud. Można również zażądać dwóch dodatkowych plików, `library-nosync` i `documents-nosync`, które stanowią specjalny katalog nie zsynchronizowane w `/Library` lub systemu plików `/Documents`.\n"
},
{
"path": "plugins/cordova-plugin-file/doc/pl/plugins.md",
"content": "\n\n# Uwagi dla programistów wtyczki\n\nTe notatki są przeznaczone przede wszystkim dla Androida i iOS deweloperów, którzy chcieli pisac pluginy które interfejs z systemu plików za pomocą wtyczki pliku.\n\n## Praca z Cordova pliku system adresów URL\n\nOd wersji 1.0.0, ten plugin ma używane adresy URL z `cdvfile` system dla wszystkich komunikacji przez most, a nie narażać urządzenia raw ścieżki systemu plików JavaScript.\n\nNa stronie JavaScript oznacza to, że FileEntry i DirectoryEntry obiekty mają fullPath atrybut, który jest głównym systemie plików HTML. Jeśli twój plugin JavaScript API akceptuje obiektu FileEntry lub DirectoryEntry, należy zadzwonić `.toURL()` dla tego obiektu przed przekazaniem Altpradl do kodu macierzystego.\n\n### Konwersja cdvfile: / / URL do ścieżki fileystem\n\nWtyczek, które trzeba pisać do systemu plików może chcesz przekonwertować odebranych plików systemu adres URL lokalizacji rzeczywistych plików. Istnieje wiele sposobów robi to, w zależności od macierzystego platformy.\n\nWażne jest, aby pamiętać, że nie wszystkie `cdvfile://` adresy URL są można zmapować na prawdziwe pliki w urządzeniu. Niektóre adresy URL może odnosić się do aktywów na urządzeniu, które nie są reprezentowane przez pliki, lub nawet może odnosić się do zasobów zdalnych. Ze względu na te możliwości wtyczki należy zawsze sprawdzić, czy się znaczącego wyniku powrót podczas próby konwersji adresów URL do ścieżki.\n\n#### Androida\n\nNa Android, najprostsza metoda konwersji `cdvfile://` URL do ścieżki systemu plików jest użycie `org.apache.cordova.CordovaResourceApi` . `CordovaResourceApi`jest kilka metod, które mogą obsługiwać `cdvfile://` adresów URL:\n\n Widok sieci Web jest członkiem Plugin klasy CordovaResourceApi resourceApi = webView.getResourceApi();\n \n Uzyskać URL file:/// reprezentujących ten plik na urządzeniu / / lub ten sam adres URL niezmienione, jeśli nie mogą być mapowane do pliku fileURL Uri = resourceApi.remapUri(Uri.parse(cdvfileURL));\n \n\nJest również możliwe, aby korzystać z wtyczki pliku bezpośrednio:\n\n org.apache.cordova.file.FileUtils przywóz;\n org.apache.cordova.file.FileSystem przywóz;\n java.net.MalformedURLException przywóz;\n \n Uzyskać pliku plugin manager wtyczki FileUtils filePlugin = (FileUtils)webView.pluginManager.getPlugin(\"File\");\n \n Biorąc pod uwagę adres URL, uzyskać ścieżkę dla to spróbuj {String ścieżka = filePlugin.filesystemPathForURL(cdvfileURL);} catch (MalformedURLException e) {/ / url plików nie było uznane}\n \n\nDo przeliczenia ścieżki do `cdvfile://` URL:\n\n org.apache.cordova.file.LocalFilesystemURL przywóz;\n \n Uzyskanie obiektu LocalFilesystemURL na ścieżkę urządzenia / / lub null, jeśli nie może być reprezentowana jako adres URL cdvfile.\n LocalFilesystemURL url = filePlugin.filesystemURLforLocalPath(path);\n Dostać reprezentację ciąg adresu URL obiektu String cdvfileURL = url.toString();\n \n\nJeśli twój plugin tworzy plik, i chcesz zwraca obiekt FileEntry dla niego, użyj pliku plugin:\n\n Zwraca JSON struktura nadaje się do powrotu do JavaScript, / / lub null, jeśli ten plik nie jest reprezentować jako adres URL cdvfile.\n Wpis JSONObject = filePlugin.getEntryForFile(file);\n \n\n#### iOS\n\nCordova na iOS nie korzystać z tego samego `CordovaResourceApi` koncepcji jak Android. Na iOS należy użyć pliku plugin do konwersji między adresach URL i ścieżkach plików.\n\n Uzyskać obiekt CDVFilesystem URL URL url ciąg CDVFilesystemURL * = [CDVFilesystemURL fileSystemURLWithString:cdvfileURL];\n Uzyskać ścieżkę dla URL obiektu, stawka zerowa, jeśli nie mogą być mapowane do ścieżki pliku NSString * = [filePlugin filesystemPathForURL:url];\n \n \n Dostać CDVFilesystem URL obiektu na ścieżkę urządzenia lub / / zerowe, jeśli nie może być reprezentowana jako adres URL cdvfile.\n CDVFilesystemURL * url = [filePlugin fileSystemURLforLocalPath:path];\n Dostać reprezentację ciąg adresu URL obiektu NSString * cdvfileURL = [url absoluteString];\n \n\nJeśli twój plugin tworzy plik, i chcesz zwraca obiekt FileEntry dla niego, użyj pliku plugin:\n\n Dostać CDVFilesystem URL obiektu na ścieżkę urządzenia lub / / zerowe, jeśli nie może być reprezentowana jako adres URL cdvfile.\n CDVFilesystemURL * url = [filePlugin fileSystemURLforLocalPath:path];\n Struktura wrócić do JavaScript NSDictionary * wpis = [filePlugin makeEntryForLocalURL:url]\n \n\n#### JavaScript\n\nW JavaScript, aby uzyskać `cdvfile://` adres URL z obiektu FileEntry lub DirectoryEntry, wystarczy zadzwonić `.toURL()` na to:\n\n var cdvfileURL = entry.toURL();\n \n\nW plugin reakcji obsługi przerobić od zwróconych struktury FileEntry do rzeczywistego obiektu wejścia, kod obsługi należy zaimportować pliku plugin i utworzyć nowy obiekt:\n\n utworzyć odpowiedni wpis obiektu var wpis;\n Jeśli (entryStruct.isDirectory) {wpis = nowy DirectoryEntry (entryStruct.name, entryStruct.fullPath, nowe FileSystem(entryStruct.filesystemName));} jeszcze {wpis = nowy FileEntry (entryStruct.name, entryStruct.fullPath, nowe FileSystem(entryStruct.filesystemName));}"
},
{
"path": "plugins/cordova-plugin-file/doc/plugins.md",
"content": "\n\nNotes for plugin developers\n===========================\n\nThese notes are primarily intended for Android and iOS developers who want to write plugins which interface with the file system using the File plugin.\n\nWorking with Cordova file system URLs\n-------------------------------------\n\nSince version 1.0.0, this plugin has used URLs with a `cdvfile` scheme for all communication over the bridge, rather than exposing raw device file system paths to JavaScript. \n\nOn the JavaScript side, this means that FileEntry and DirectoryEntry objects have a fullPath attribute which is relative to the root of the HTML file system. If your plugin's JavaScript API accepts a FileEntry or DirectoryEntry object, you should call `.toURL()` on that object before passing it across the bridge to native code.\n\n### Converting cdvfile:// URLs to fileystem paths\n\nPlugins which need to write to the filesystem may want to convert a received file system URL to an actual filesystem location. There are multiple ways of doing this, depending on the native platform.\n\nIt is important to remember that not all `cdvfile://` URLs are mappable to real files on the device. Some URLs can refer to assets on device which are not represented by files, or can even refer to remote resources. Because of these possibilities, plugins should always test whether they get a meaningful result back when trying to convert URLs to paths.\n\n#### Android\n\nOn Android, the simplest method to convert a `cdvfile://` URL to a filesystem path is to use `org.apache.cordova.CordovaResourceApi`. `CordovaResourceApi` has several methods which can handle `cdvfile://` URLs:\n\n // webView is a member of the Plugin class\n CordovaResourceApi resourceApi = webView.getResourceApi();\n\n // Obtain a file:/// URL representing this file on the device,\n // or the same URL unchanged if it cannot be mapped to a file\n Uri fileURL = resourceApi.remapUri(Uri.parse(cdvfileURL));\n\nIt is also possible to use the File plugin directly:\n\n import org.apache.cordova.file.FileUtils;\n import org.apache.cordova.file.FileSystem;\n import java.net.MalformedURLException;\n\n // Get the File plugin from the plugin manager\n FileUtils filePlugin = (FileUtils)webView.pluginManager.getPlugin(\"File\");\n\n // Given a URL, get a path for it\n try {\n String path = filePlugin.filesystemPathForURL(cdvfileURL);\n } catch (MalformedURLException e) {\n // The filesystem url wasn't recognized\n }\n\nTo convert from a path to a `cdvfile://` URL:\n\n import org.apache.cordova.file.LocalFilesystemURL;\n\n // Get a LocalFilesystemURL object for a device path,\n // or null if it cannot be represented as a cdvfile URL.\n LocalFilesystemURL url = filePlugin.filesystemURLforLocalPath(path);\n // Get the string representation of the URL object\n String cdvfileURL = url.toString();\n\nIf your plugin creates a file, and you want to return a FileEntry object for it, use the File plugin:\n\n // Return a JSON structure suitable for returning to JavaScript,\n // or null if this file is not representable as a cdvfile URL.\n JSONObject entry = filePlugin.getEntryForFile(file);\n\n#### iOS\n\nCordova on iOS does not use the same `CordovaResourceApi` concept as Android. On iOS, you should use the File plugin to convert between URLs and filesystem paths.\n\n // Get a CDVFilesystem URL object from a URL string\n CDVFilesystemURL* url = [CDVFilesystemURL fileSystemURLWithString:cdvfileURL];\n // Get a path for the URL object, or nil if it cannot be mapped to a file\n NSString* path = [filePlugin filesystemPathForURL:url];\n \n\n // Get a CDVFilesystem URL object for a device path, or\n // nil if it cannot be represented as a cdvfile URL.\n CDVFilesystemURL* url = [filePlugin fileSystemURLforLocalPath:path];\n // Get the string representation of the URL object\n NSString* cdvfileURL = [url absoluteString];\n\nIf your plugin creates a file, and you want to return a FileEntry object for it, use the File plugin:\n\n // Get a CDVFilesystem URL object for a device path, or\n // nil if it cannot be represented as a cdvfile URL.\n CDVFilesystemURL* url = [filePlugin fileSystemURLforLocalPath:path];\n // Get a structure to return to JavaScript\n NSDictionary* entry = [filePlugin makeEntryForLocalURL:url]\n\n#### JavaScript\n\nIn JavaScript, to get a `cdvfile://` URL from a FileEntry or DirectoryEntry object, simply call `.toURL()` on it:\n\n var cdvfileURL = entry.toURL();\n\nIn plugin response handlers, to convert from a returned FileEntry structure to an actual Entry object, your handler code should import the File plugin and create a new object:\n\n // create appropriate Entry object\n var entry;\n if (entryStruct.isDirectory) {\n entry = new DirectoryEntry(entryStruct.name, entryStruct.fullPath, new FileSystem(entryStruct.filesystemName));\n } else {\n entry = new FileEntry(entryStruct.name, entryStruct.fullPath, new FileSystem(entryStruct.filesystemName));\n }\n\n"
},
{
"path": "plugins/cordova-plugin-file/doc/ru/index.md",
"content": "\n\n# cordova-plugin-file\n\nЭтот плагин реализует API файла, позволяя доступ на чтение и запись в файлы, находящиеся на устройстве.\n\nЭтот плагин основан на нескольких спецификации, в том числе: HTML5 API файла \n\n(Ныне несуществующей) каталоги и систему расширений Последнее: , хотя большая часть кода, плагин был написан, когда ранее спец был текущим: \n\nОн также реализует уничтожал spec: \n\nДля использования, пожалуйста, обратитесь к HTML5 скалы отличные [файловой системы статьи.][1]\n\n [1]: http://www.html5rocks.com/en/tutorials/file/filesystem/\n\nОбзор других вариантов хранения найти Cordova [хранения руководства][2].\n\n [2]: http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html\n\n## Установка\n\n cordova plugin add cordova-plugin-file\n \n\n## Поддерживаемые платформы\n\n* Amazon Fire OS\n* Android\n* BlackBerry 10\n* Firefox OS\n* iOS\n* Windows Phone 7 и 8 *\n* Windows 8 *\n\n* *Эти платформы не поддерживают `FileReader.readAsArrayBuffer` , ни `FileWriter.write(blob)` .*\n\n## Где хранить файлы\n\nПо состоянию на v1.2.0 приведены URL-адреса для важных файлов в системные каталоги. Каждый URL-адрес в виде *file:///path/to/spot/*и может быть преобразован в `DirectoryEntry` с помощью`window.resolveLocalFileSystemURL()`.\n\n* `cordova.file.applicationDirectory`-Каталог только для чтения, где установлено приложение. (*iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.applicationStorageDirectory`-Корневой каталог приложения в песочнице; на iOS это место только для чтения (но определенных подкаталогов [как `/Documents` ], чтения записи). Все данные, содержащиеся в частных в приложение. ( *iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.dataDirectory`-Хранения стойкие и частных данных в приложения в песочнице с использованием внутренней памяти (на Android, если необходимо использовать внешнюю память, использовать `.externalDataDirectory` ). На iOS, этот каталог не синхронизируется с iCloud (использование `.syncedDataDirectory` ). (*iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.cacheDirectory`-Каталог для кэшированных данных файлов или все файлы, которые ваше приложение может повторно создать легко. ОС может удалить эти файлы, когда устройства хватает на хранение, тем не менее, приложения не должны опираться на OS, чтобы удалить файлы здесь. (*iOS*, *Android*, *BlackBerry 10*)\n\n* `cordova.file.externalApplicationStorageDirectory`-Пространство приложения на внешнем хранилище. (*Android*)\n\n* `cordova.file.externalDataDirectory`-Куда положить файлы данных конкретного приложения на внешнем хранилище. (*Android*)\n\n* `cordova.file.externalCacheDirectory`-Применение кэш на внешние накопители. (*Android*)\n\n* `cordova.file.externalRootDirectory`-Корень внешние накопители (SD карта). (*Android*, *BlackBerry 10*)\n\n* `cordova.file.tempDirectory`-Временный каталог, что ОС можно снять на будет. Не следует полагаться на OS, чтобы очистить этот каталог; Ваше приложение всегда следует удалять файлы в соответствующих случаях. (*iOS*)\n\n* `cordova.file.syncedDataDirectory`-Содержит файлы приложения, которые должны быть синхронизированы (например, к iCloud). (*iOS*)\n\n* `cordova.file.documentsDirectory`-Файлы для приложения, но это являются значимыми для других приложений (например, файлы Office). (*iOS*)\n\n* `cordova.file.sharedDirectory`-Файлы глобально доступной для всех приложений (*BlackBerry 10*)\n\n## Макеты файловой системы\n\nХотя технически деталь реализации, она может быть очень полезно знать как `cordova.file.*` карта свойства физические пути на реальном устройстве.\n\n### iOS расположения файловой системы\n\n| Путь к устройству | `Cordova.File.*` | `iosExtraFileSystems` | r/w? | стойкие? | Очищает ОС | Синхронизация | частные |\n|:---------------------------------------------- |:--------------------------- |:--------------------- |:----:|:--------:|:----------:|:-------------:|:-------:|\n| `/ var/мобильного/применения/< UUID > /` | applicationStorageDirectory | - | r | Н/Д | Н/Д | Н/Д | Да |\n| `appname.app/` | applicationDirectory | расслоение | r | Н/Д | Н/Д | Н/Д | Да |\n| `www/` | - | - | r | Н/Д | Н/Д | Н/Д | Да |\n| `Documents/` | documentsDirectory | документы | r/w | Да | Нет | Да | Да |\n| `NoCloud/` | - | документы nosync | r/w | Да | Нет | Нет | Да |\n| `Library` | - | Библиотека | r/w | Да | Нет | Да? | Да |\n| `NoCloud/` | dataDirectory | Библиотека nosync | r/w | Да | Нет | Нет | Да |\n| `Cloud/` | syncedDataDirectory | - | r/w | Да | Нет | Да | Да |\n| `Caches/` | cacheDirectory | кэш | r/w | Да * | Да * * *| | Нет | Да |\n| `tmp/` | tempDirectory | - | r/w | Не * * | Да * * *| | Нет | Да |\n\n* Файлы сохраняются приложения перезагрузки и обновления, но этот каталог может быть очищен, когда ОС желаний. Ваше приложение должно иметь возможность воссоздать любое содержание, которое может быть удалено.\n\n* * Файлы могут сохраняться перезагрузками app, но не полагайтесь на это поведение. Для продолжения обновления файлов не гарантируется. Приложение должно удалить файлы из этого каталога, когда это применимо, как операционная система не гарантирует когда (или даже если) эти файлы будут удалены.\n\n* * *| ОС может очистить содержимое этого каталога, когда он считает это необходимым, но не полагайтесь на это. Необходимо снять этот каталог в зависимости от вашего приложения.\n\n### Расположения Android файловой системы\n\n| Путь к устройству | `Cordova.File.*` | `AndroidExtraFileSystems` | r/w? | стойкие? | Очищает ОС | частные |\n|:--------------------------------- |:----------------------------------- |:------------------------- |:----:|:--------:|:----------:|:-------:|\n| `File:///android_asset/` | applicationDirectory | | r | Н/Д | Н/Д | Да |\n| `/ Data/data/< app-id > /` | applicationStorageDirectory | - | r/w | Н/Д | Н/Д | Да |\n| `cache` | cacheDirectory | кэш | r/w | Да | Да * | Да |\n| `files` | dataDirectory | файлы | r/w | Да | Нет | Да |\n| `Documents` | | документы | r/w | Да | Нет | Да |\n| `< sdcard > /` | externalRootDirectory | SDCard | r/w | Да | Нет | Нет |\n| `Android/data//` | externalApplicationStorageDirectory | - | r/w | Да | Нет | Нет |\n| `cache` | externalCacheDirectry | кэш внешние | r/w | Да | Не * * | Нет |\n| `files` | externalDataDirectory | файлы внешние | r/w | Да | Нет | Нет |\n\n* ОС может периодически удалять этот каталог, но не полагайтесь на это поведение. Очистите содержимое этого каталога в зависимости от вашего приложения. Если пользователь вручную очистить кэш, содержимое этого каталога будут удалены.\n\n* * ОС не ясно этот каталог автоматически; Вы несете ответственность за управление содержимым самостоятельно. Если пользователь вручную очистить кэш, содержимое каталога будут удалены.\n\n**Примечание**: Если нельзя монтировать внешние накопители, `cordova.file.external*` Свойства`null`.\n\n### BlackBerry 10 расположения файловой системы\n\n| Путь к устройству | `Cordova.File.*` | r/w? | стойкие? | Очищает ОС | частные |\n|:--------------------------------------------------- |:--------------------------- |:----:|:--------:|:----------:|:-------:|\n| `File:///Accounts/1000/AppData/ < app id > /` | applicationStorageDirectory | r | Н/Д | Н/Д | Да |\n| `app/native` | applicationDirectory | r | Н/Д | Н/Д | Да |\n| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | Нет | Да | Да |\n| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | Да | Нет | Да |\n| `File:///Accounts/1000/Removable/SDCard` | externalRemovableDirectory | r/w | Да | Нет | Нет |\n| `File:///Accounts/1000/Shared` | sharedDirectory | r/w | Да | Нет | Нет |\n\n*Примечание*: при развертывании приложения для работы периметра, все пути относительны /accounts/1000-enterprise.\n\n## Особенности Android\n\n### Местоположение Android постоянного хранения\n\nЕсть несколько допустимых мест для хранения постоянных файлов на устройстве Android. Смотрите [эту страницу][3] для широкого обсуждения различных возможностей.\n\n [3]: http://developer.android.com/guide/topics/data/data-storage.html\n\nПредыдущие версии плагина будет выбирать расположение временных и постоянных файлов при запуске, основанный на ли устройство утверждал, что SD-карта (или эквивалентные хранения раздел) был смонтирован. Если была смонтирована SD-карты, или если большой внутренней памяти раздел был доступен (такие как на устройствах Nexus,), то постоянные файлы будут храниться в корне этого пространства. Это означало, что все apps Cordova могли видеть все файлы, имеющиеся на карте.\n\nЕсли SD-карты не был доступен, то предыдущих версий будет хранить данные в `/data/data/` , которая изолирует приложения друг от друга, но все еще может причина данные распределяются между пользователями.\n\nЭто теперь можно выбрать, следует ли хранить файлы в месте хранения внутренних файлов, или с использованием предыдущей логики, с предпочтением в вашем приложении `config.xml` файл. Чтобы сделать это, добавить один из этих двух линий в `config.xml` :\n\n \n \n \n \n\nБез этой линии, будет использовать файл плагина `Compatibility` по умолчанию. Если тег предпочтений присутствует и не является одним из этих значений, приложение не запустится.\n\nЕсли ранее была отгружена приложения для пользователей, используя старые (до 1.0) версию этого плагина и имеет сохраненные файлы в файловой системе постоянных, то вы должны установить предпочтения `Compatibility` . Переключение местоположение для «Внутреннего» будет означать, что существующие пользователи, которые обновить их применение может быть не в состоянии получить доступ к их сохраненные ранее файлы, в зависимости от их устройства.\n\nЕсли ваше приложение является новым или ранее никогда не хранит файлы в стойких файловой системы, то `Internal` как правило рекомендуется настройка.\n\n## Особенности iOS\n\n* `cordova.file.applicationStorageDirectory`доступен только для чтения; попытка хранения файлов в корневом каталоге не удастся. Использовать один из других `cordova.file.*` свойства, определенные для iOS (только `applicationDirectory` и `applicationStorageDirectory` доступны только для чтения).\n* `FileReader.readAsText(blob, encoding)` \n * `encoding`Параметр не поддерживается, и UTF-8 кодирование действует всегда.\n\n### iOS место постоянного хранения\n\nСуществует два допустимых местоположений для хранения постоянных файлов на устройства iOS: документы каталогов и библиотека. Предыдущие версии плагина только когда-либо постоянные файлы хранятся в папке документы. Это был побочный эффект делает все файлы приложения в iTunes, который часто был непреднамеренным, особенно для приложений, которые обрабатывают большое количество мелких файлов, вместо того, чтобы производить полный комплект документов для экспорта, который является цель каталога.\n\nЭто теперь можно выбрать, следует ли хранить файлы в документы или каталоге библиотеки, с предпочтением в вашем приложении `config.xml` файл. Чтобы сделать это, добавить один из этих двух линий в `config.xml` :\n\n \n \n \n \n\nБез этой линии, будет использовать файл плагина `Compatibility` по умолчанию. Если тег предпочтений присутствует и не является одним из этих значений, приложение не запустится.\n\nЕсли ранее была отгружена приложения для пользователей, используя старые (до 1.0) версию этого плагина и имеет сохраненные файлы в файловой системе постоянных, то вы должны установить предпочтения `Compatibility` . Переключение расположения `Library` будет означать, что существующих пользователей обновить их применения будет не в состоянии получить доступ к их сохраненные ранее файлы.\n\nЕсли ваше приложение является новым или ранее никогда не хранит файлы в стойких файловой системы, то `Library` как правило рекомендуется настройка.\n\n## Особенности Firefox OS\n\nAPI файловой системы изначально не поддерживается Firefox OS и реализуется как оболочка поверх indexedDB.\n\n* Не вынимая непустые каталоги\n* Не поддерживает метаданные для каталогов\n* Методы `copyTo` и `moveTo` не поддерживает каталоги\n\nПоддерживаются следующие пути данных: * `applicationDirectory` -использует `xhr` чтобы получить локальные файлы, которые упакованы с приложением. * `dataDirectory` - Для постоянных данных конкретного приложения файлов. * `cacheDirectory` -Кэшированных файлов, которые должны выжить перезагрузки приложения (Apps не следует полагаться на OS, чтобы удалить файлы из здесь).\n\n## Обновление примечания\n\nВ v1.0.0 этого плагина `FileEntry` и `DirectoryEntry` структур изменились, более соответствует опубликованной спецификации.\n\nПредыдущий (pre-1.0.0) версии плагина хранятся устройства Абсолют файл расположение в `fullPath` свойства `Entry` объектов. Эти пути обычно будет выглядеть\n\n /var/mobile/Applications//Documents/path/to/file (iOS)\n /storage/emulated/0/path/to/file (Android)\n \n\nЭти пути также были возвращены `toURL()` метода `Entry` объектов.\n\nС v1.0.0 `fullPath` атрибут является путь к файлу, *заданный относительно корня файловой системы HTML*. Таким образом, выше пути будет теперь оба быть представлено `FileEntry` объект с `fullPath` из\n\n /path/to/file\n \n\nЕсли ваше приложение работает с устройства Абсолют путями, и ранее были получены эти пути через `fullPath` свойства `Entry` объектов, то вам следует обновить код для использования `entry.toURL()` вместо этого.\n\nДля обратной совместимости, `resolveLocalFileSystemURL()` метод будет принимать путь Абсолют устройства и будет возвращать `Entry` объект, соответствующий его, до тех пор, как этот файл существует в рамках либо `TEMPORARY` или `PERSISTENT` файловых систем.\n\nЭто особенно была проблема с плагином передачи файлов, который ранее использовался устройства Абсолют пути (и все еще может принять их). Он был обновлен для корректной работы с файловой системы URL, так что замена `entry.fullPath` с `entry.toURL()` должен решить любые вопросы, получить этот плагин для работы с файлами на устройстве.\n\nВ v1.1.0 возвращаемое значение из `toURL()` был изменен (см. \\[CB-6394\\] (https://issues.apache.org/jira/browse/CB-6394)) для возвращения URL-адрес абсолютным «file://». где это возможно. Для обеспечения ' cdvfile:'-вы можете использовать URL-адрес `toInternalURL()` сейчас. Этот метод будет возвращать теперь файловой системы URL формы\n\n cdvfile://localhost/persistent/path/to/file\n \n\nкоторый может использоваться для уникальной идентификации файла.\n\n## Список кодов ошибок и значения\n\nКогда возникает ошибка, один из следующих кодов будет использоваться.\n\n| Код | Постоянная |\n| ---:|:----------------------------- |\n| 1 | `NOT_FOUND_ERR` |\n| 2 | `SECURITY_ERR` |\n| 3 | `ABORT_ERR` |\n| 4 | `NOT_READABLE_ERR` |\n| 5 | `ENCODING_ERR` |\n| 6 | `NO_MODIFICATION_ALLOWED_ERR` |\n| 7 | `INVALID_STATE_ERR` |\n| 8 | `SYNTAX_ERR` |\n| 9 | `INVALID_MODIFICATION_ERR` |\n| 10 | `QUOTA_EXCEEDED_ERR` |\n| 11 | `TYPE_MISMATCH_ERR` |\n| 12 | `PATH_EXISTS_ERR` |\n\n## Настройка плагина (опционально)\n\nНабор доступных файловых систем может быть настроен на платформе. IOS и Android признают тег в `config.xml` имена которых файловые системы для установки. По умолчанию включены все корни файловой системы.\n\n \n \n \n\n### Android\n\n* `files`: Каталог для хранения внутреннего файла приложения\n* `files-external`: Каталог хранения внешнего файла приложения\n* `sdcard`: Глобальный внешний файл каталог хранения (это корень SD-карты, если таковая установлена). Вы должны иметь `android.permission.WRITE_EXTERNAL_STORAGE` разрешение использовать это.\n* `cache`: Каталог внутреннего кэша приложения\n* `cache-external`: Каталог приложения внешней кэш-памяти\n* `root`: Все устройство файловой системы\n\nAndroid поддерживает также Специальный файловую систему под названием «документы», которая представляет подкаталог «/ документы /» в пределах файловой системы «файлы».\n\n### iOS\n\n* `library`: Каталог библиотеки приложения\n* `documents`: Каталог документов приложения\n* `cache`: Каталог кэша приложения\n* `bundle`: Пакет приложения; расположение самого приложения на диске (только для чтения)\n* `root`: Все устройство файловой системы\n\nПо умолчанию каталоги библиотеки и документы можно синхронизировать с iCloud. Вы также можете заказать два дополнительных файловых систем, `library-nosync` и `documents-nosync` , которые представляют Специальный каталог не синхронизируются в `/Library` или `/Documents` файловой системы.\n"
},
{
"path": "plugins/cordova-plugin-file/doc/ru/plugins.md",
"content": "\n\n# Примечания для разработчиков плагинов\n\nЭти примечания предназначены прежде всего для Android и iOS разработчиков, которые хотят писать плагины какой интерфейс с файловой системой, с помощью файла плагина.\n\n## Работа с Кордова файловой системы URL\n\nНачиная с версии 1.0.0, этот плагин использует URL-адресов с `cdvfile` схема для всех коммуникации через мост, а не подвергая пути файловой системы raw устройства для JavaScript.\n\nНа стороне JavaScript это означает, что объекты DirectoryEntry и FileEntry fullPath атрибут, который является по отношению к корневой файловой системе HTML. Если ваш плагин JavaScript API принимает объект DirectoryEntry или FileEntry, необходимо вызвать `.toURL()` для этого объекта перед передачей их через мост в машинный код.\n\n### Преобразование cdvfile: / / URL-адреса в пути fileystem\n\nПлагины, которые нужно написать в файловой системе может потребоваться преобразовать URL-адреса системы полученный файл в место фактической файловой системы. Существует несколько способов сделать это, в зависимости от родной платформе.\n\nВажно помнить, что не все `cdvfile://` URL-адреса являются отображаемыми файлами на устройстве. Некоторые URL может относиться к активам на устройстве, которые не представлены файлы, или может даже обратиться к удаленным ресурсам. Из-за эти возможности плагины следует всегда проверять ли они получают результат обратно при попытке преобразовать URL-адреса в пути.\n\n#### Android\n\nНа Android, самый простой способ для преобразования `cdvfile://` URL-адрес к пути файловой системы заключается в использовании `cordova-plugin-CordovaResourceApi` . `CordovaResourceApi`Есть несколько методов, которые можно обработать `cdvfile://` URL-адреса:\n\n // webView is a member of the Plugin class\n CordovaResourceApi resourceApi = webView.getResourceApi();\n \n // Obtain a file:/// URL representing this file on the device,\n // or the same URL unchanged if it cannot be mapped to a file\n Uri fileURL = resourceApi.remapUri(Uri.parse(cdvfileURL));\n \n\nЭто также можно использовать плагин файл непосредственно:\n\n import cordova-plugin-file.FileUtils;\n import cordova-plugin-file.FileSystem;\n import java.net.MalformedURLException;\n \n // Get the File plugin from the plugin manager\n FileUtils filePlugin = (FileUtils)webView.pluginManager.getPlugin(\"File\");\n \n // Given a URL, get a path for it\n try {\n String path = filePlugin.filesystemPathForURL(cdvfileURL);\n } catch (MalformedURLException e) {\n // The filesystem url wasn't recognized\n }\n \n\nДля преобразования пути к `cdvfile://` URL-адрес:\n\n import cordova-plugin-file.LocalFilesystemURL;\n \n // Get a LocalFilesystemURL object for a device path,\n // or null if it cannot be represented as a cdvfile URL.\n LocalFilesystemURL url = filePlugin.filesystemURLforLocalPath(path);\n // Get the string representation of the URL object\n String cdvfileURL = url.toString();\n \n\nЕсли ваш плагин создает файл, и вы хотите вернуть объект FileEntry для него, используйте файл плагина:\n\n // Return a JSON structure suitable for returning to JavaScript,\n // or null if this file is not representable as a cdvfile URL.\n JSONObject entry = filePlugin.getEntryForFile(file);\n \n\n#### iOS\n\nКордова на iOS не использовать те же `CordovaResourceApi` понятие, как Android. На iOS вы должны использовать файл плагин для преобразования URL-адреса и пути файловой системы.\n\n // Get a CDVFilesystem URL object from a URL string\n CDVFilesystemURL* url = [CDVFilesystemURL fileSystemURLWithString:cdvfileURL];\n // Get a path for the URL object, or nil if it cannot be mapped to a file\n NSString* path = [filePlugin filesystemPathForURL:url];\n \n \n // Get a CDVFilesystem URL object for a device path, or\n // nil if it cannot be represented as a cdvfile URL.\n CDVFilesystemURL* url = [filePlugin fileSystemURLforLocalPath:path];\n // Get the string representation of the URL object\n NSString* cdvfileURL = [url absoluteString];\n \n\nЕсли ваш плагин создает файл, и вы хотите вернуть объект FileEntry для него, используйте файл плагина:\n\n // Get a CDVFilesystem URL object for a device path, or\n // nil if it cannot be represented as a cdvfile URL.\n CDVFilesystemURL* url = [filePlugin fileSystemURLforLocalPath:path];\n // Get a structure to return to JavaScript\n NSDictionary* entry = [filePlugin makeEntryForLocalURL:url]\n \n\n#### JavaScript\n\nВ JavaScript, чтобы получить `cdvfile://` URL от объекта DirectoryEntry или FileEntry, просто позвоните `.toURL()` на него:\n\n var cdvfileURL = entry.toURL();\n \n\nВ плагин обработчики ответ для преобразования из возвращаемой структуры FileEntry объект фактического вступления, код обработчика следует импортировать файл плагина и создайте новый объект:\n\n // create appropriate Entry object\n var entry;\n if (entryStruct.isDirectory) {\n entry = new DirectoryEntry(entryStruct.name, entryStruct.fullPath, new FileSystem(entryStruct.filesystemName));\n } else {\n entry = new FileEntry(entryStruct.name, entryStruct.fullPath, new FileSystem(entryStruct.filesystemName));\n }\n"
},
{
"path": "plugins/cordova-plugin-file/doc/zh/README.md",
"content": "\n\n# cordova-plugin-file\n\n[](https://travis-ci.org/apache/cordova-plugin-file)\n\n這個外掛程式實現檔 API 允許對檔駐留在該設備上的讀/寫訪問。\n\n這個外掛程式基於幾個規格，包括： HTML5 檔 API [HTTP://www.w3.org/TR/FileAPI/](http://www.w3.org/TR/FileAPI/)\n\n（現已解散） 目錄和系統擴展最新： [HTTP://www.w3.org/TR/2012/WD-file-system-api-20120417/](http://www.w3.org/TR/2012/WD-file-system-api-20120417/)雖然大部分的外掛程式代碼寫時較早的規格是當前： [HTTP://www.w3.org/TR/2011/WD-file-system-api-20110419/](http://www.w3.org/TR/2011/WD-file-system-api-20110419/)\n\n它還實現 FileWriter 規格： [HTTP://dev.w3.org/2009/dap/file-system/file-writer.html](http://dev.w3.org/2009/dap/file-system/file-writer.html)\n\n用法，請參閱對 HTML5 的岩石優秀[檔案系統文章。](http://www.html5rocks.com/en/tutorials/file/filesystem/)\n\n其他存儲選項的概述，請參閱科爾多瓦的[存儲指南](http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html).\n\n這個外掛程式定義全球 `cordova.file` 物件。\n\n雖然在全球範圍內，它不可用直到 `deviceready` 事件之後。\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(cordova.file);\n }\n \n\n## 安裝\n\n cordova plugin add cordova-plugin-file\n \n\n## 支援的平臺\n\n * 亞馬遜火 OS\n * Android 系統\n * 黑莓 10\n * 火狐瀏覽器作業系統\n * iOS\n * Windows Phone 7 和 8 *\n * Windows 8 *\n * Windows*\n * 瀏覽器\n\n\\* *These platforms do not support `FileReader.readAsArrayBuffer` nor `FileWriter.write(blob)`.*\n\n## 存儲檔的位置\n\n截至 v1.2.0，提供重要的檔案系統目錄的 Url。 每個 URL 位於表單 *file:///path/to/spot/*，和可以轉換為使用 `window.resolveLocalFileSystemURL()` 的 `DirectoryEntry`.\n\n * `cordova.file.applicationDirectory`-唯讀目錄在哪裡安裝的應用程式。（*iOS*、*安卓*、*黑莓 10*)\n\n * `cordova.file.applicationStorageDirectory`-根目錄下的應用程式的沙箱 ；在 iOS 上此位置是唯讀 （但特定的子目錄 [像 `/Documents` ] 都是讀寫）。 中包含的所有資料都是私有的應用程式。 （ *iOS*、*安卓*、*黑莓 10*)\n\n * `cordova.file.dataDirectory`資料持久性和私有資料存儲在內部記憶體使用的應用程式的沙箱內 （在安卓系統，如果你需要使用外部儲存體，使用 `.externalDataDirectory` ）。 在 iOS，此目錄不與 iCloud 同步 （使用 `.syncedDataDirectory` ）。 （*iOS*、*安卓*、*黑莓 10*)\n\n * `cordova.file.cacheDirectory`-緩存的資料檔案或您的應用程式重新可以輕鬆地創建的任何檔的目錄。 作業系統可能會刪除這些檔，該設備在存儲上運行低時，然而，應用程式不應依賴的作業系統，請刪除檔在這裡。 （*iOS*、*安卓*、*黑莓 10*)\n\n * `cordova.file.externalApplicationStorageDirectory`-應用程式外部存儲上的空間。（*安卓*)\n\n * `cordova.file.externalDataDirectory`-放在外部存儲特定于應用程式的資料檔案的位置。（*安卓*)\n\n * `cordova.file.externalCacheDirectory`-在外部存儲應用程式緩存。（*安卓*)\n\n * `cordova.file.externalRootDirectory`-外部存儲 （SD 卡） 的根。（*安卓*、*黑莓 10*)\n\n * `cordova.file.tempDirectory`-OS 可以清除時的空目錄會。 不依賴于 OS，以清除此目錄 ；您的應用程式，應總是移除作為適用的檔。 （*iOS*)\n\n * `cordova.file.syncedDataDirectory`-保存應同步 （例如到 iCloud） 的特定于應用程式的檔。（*iOS*)\n\n * `cordova.file.documentsDirectory`-檔私有的應用程式，但這是對其他應用程式 （例如 Office 檔） 有意義。（*iOS*)\n\n * `cordova.file.sharedDirectory`-對所有應用程式 （*黑莓 10*全域可用的檔)\n\n## 檔案系統佈局\n\n雖然技術上實現的細節，它可以是很有必要瞭解如何 `cordova.file.*` 屬性對應到實體路徑在實際設備上。\n\n### iOS 檔案系統佈局\n\n| 設備路徑 | `cordova.file.*` | `iosExtraFileSystems` | r/w 嗎？ | 持續性嗎？ | OS 清除 | 同步 | 私人 |\n|:---------------------------------------------- |:--------------------------- |:--------------------- |:------:|:-------:|:------------:|:---:|:--:|\n| `/ 無功/移動/應用程式/< UUID > /` | applicationStorageDirectory | - | r | 不適用 | 不適用 | 不適用 | 是啊 |\n| `appname.app/` | applicationDirectory | 束 | r | 不適用 | 不適用 | 不適用 | 是啊 |\n| `www/` | - | - | r | 不適用 | 不適用 | 不適用 | 是啊 |\n| `Documents/` | documentsDirectory | 檔 | r/w | 是啊 | 無 | 是啊 | 是啊 |\n| `NoCloud/` | - | 檔 nosync | r/w | 是啊 | 無 | 無 | 是啊 |\n| `Library` | - | 圖書館 | r/w | 是啊 | 無 | 是嗎？ | 是啊 |\n| `NoCloud/` | dataDirectory | 圖書館 nosync | r/w | 是啊 | 無 | 無 | 是啊 |\n| `Cloud/` | syncedDataDirectory | - | r/w | 是啊 | 無 | 是啊 | 是啊 |\n| `Caches/` | cacheDirectory | 快取記憶體 | r/w | 是啊 * | 是啊**\\* | 無 | 是啊 |\n| `tmp/` | tempDirectory | - | r/w | 無** | 是啊**\\* | 無 | 是啊 |\n\n\\ * 檔堅持跨應用程式重新開機和升級，但每當 OS 的欲望，可以清除此目錄。您的應用程式應該能夠重新創建任何內容可能會被刪除。\n\n**檔可能會持續整個應用程式重新開機，但不是依賴于這種行為。 不保證檔在更新之間持續存在。 您的應用程式時適用，是應該刪除此目錄的檔，因為作業系統並不能保證何時 （或即使） 中刪除這些檔。\n\n**\\ * 作業系統可能會清除此目錄的內容，每當它感覺它是必要的但做不依賴于此。 你應該清除此目錄為適合您的應用程式。\n\n### Android 的檔案系統佈局\n\n| 設備路徑 | `cordova.file.*` | `AndroidExtraFileSystems` | r/w 嗎？ | 持續性嗎？ | OS 清除 | 私人 |\n|:------------------------------------------------ |:----------------------------------- |:------------------------- |:------:|:-----:|:-------:|:--:|\n| `file:///android_asset/` | applicationDirectory | | r | 不適用 | 不適用 | 是啊 |\n| `/ 資料資料/< 應用程式 id > /` | applicationStorageDirectory | - | r/w | 不適用 | 不適用 | 是啊 |\n| `cache` | cacheDirectory | 快取記憶體 | r/w | 是啊 | 是啊\\* | 是啊 |\n| `files` | dataDirectory | 檔 | r/w | 是啊 | 無 | 是啊 |\n| `Documents` | | 檔 | r/w | 是啊 | 無 | 是啊 |\n| `< sd 卡 > /` | externalRootDirectory | sd 卡 | r/w | 是啊 | 無 | 無 |\n| `Android/data//` | externalApplicationStorageDirectory | - | r/w | 是啊 | 無 | 無 |\n| `cache` | externalCacheDirectry | 外部快取記憶體 | r/w | 是啊 | 無** | 無 |\n| `files` | externalDataDirectory | 外部檔 | r/w | 是啊 | 無 | 無 |\n\n\\ * 作業系統可能定期清除此目錄，但不是依賴于這種行為。 清除此為適合您的應用程式的目錄的內容。 使用者應手動清除緩存，將刪除此目錄的內容。\n\n** OS 不會清除此目錄自動;你是負責管理自己的內容。 使用者應手動清除緩存，目錄中的內容將被刪除。\n\n**注**： 如果外部存儲無法裝入，`cordova.file.external*` 屬性為 `空`.\n\n### 黑莓 10 檔案系統佈局\n\n| 設備路徑 | `cordova.file.*` | r/w 嗎？ | 持續性嗎？ | OS 清除 | 私人 |\n|:----------------------------------------------------------- |:--------------------------- |:------:|:-----:|:-----:|:--:|\n| `file:///accounts/1000/appdata/ < 應用程式 id > /` | applicationStorageDirectory | r | 不適用 | 不適用 | 是啊 |\n| `app/native` | applicationDirectory | r | 不適用 | 不適用 | 是啊 |\n| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | 無 | 是啊 | 是啊 |\n| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | 是啊 | 無 | 是啊 |\n| `file:///accounts/1000/removable/sdcard` | externalRemovableDirectory | r/w | 是啊 | 無 | 無 |\n| `file:///accounts/1000/shared` | sharedDirectory | r/w | 是啊 | 無 | 無 |\n\n*注意*： 當應用程式部署工作週邊時，所有路徑都是相對於 /accounts/1000-enterprise。\n\n## Android 的怪癖\n\n### Android 的持久性存儲位置\n\n有很多有效的位置來存儲持久性檔在 Android 設備上。 請參閱 [此頁面](http://developer.android.com/guide/topics/data/data-storage.html) 的各種可能性進行廣泛討論。\n\n以前版本的外掛程式會選擇在啟動時，基於該設備是否聲稱 SD 卡 （或等效存儲分區） 展開，臨時和永久檔的位置。 如果被掛載 SD 卡，或一個大的內部存儲分區可用 （如 nexus 系列設備上） 然後持久性檔將存儲在該空間的根目錄中。 這意味著所有的科爾多瓦應用程式可以看到所有可用的檔在卡片上。\n\n如果 SD 卡不是可用的那麼以前的版本中將存儲資料下的 `/data/data/`，其中隔離應用程式從彼此，但仍可能導致使用者之間共用的資料。\n\n現在可以選擇是否將檔存儲在內部檔的存儲位置，或使用以前的邏輯，與您的應用程式的 `config.xml` 檔中的偏好。 要執行此操作，請將以下兩行之一添加到 `config.xml`：\n\n \n \n \n \n\n如果這條線，沒有檔外掛程式將使用 `Compatibility` 作為預設值。如果首選項標記存在，並不是這些值之一，應用程式將無法啟動。\n\n如果您的應用程式以前已被運到使用者，使用較舊的 （預 1.0） 版本的這個外掛程式，並具有持久性的檔，系統中存儲的檔，然後您應該設置 `Compatibility` 偏好。 切換到\"Internal\"的位置，將意味著現有使用者升級他們的應用程式可能無法訪問他們以前存儲的檔，具體取決於他們的設備。\n\n如果您的應用程式是新的或以前從未有持久性的檔案系統中存儲檔，那麼通常建議使用 `Internal` 設置。\n\n### 緩慢的遞迴操作為 /android_asset 的\n\n上市資產目錄是在 android 系統很慢的。 你可以讓時間加速了不過，通過將`src/android/build-extras.gradle`添加到您的 android 專案的根 (也需要 cordova-android@4.0.0 或更高版本)。\n\n## iOS 的怪癖\n\n * `cordova.file.applicationStorageDirectory`是唯讀的 ；試圖存儲內的根目錄中的檔將會失敗。 使用的另一個 `cordova.file.*` 為 iOS 定義的屬性 （只有 `applicationDirectory` 和 `applicationStorageDirectory` 都是唯讀）。\n * `FileReader.readAsText(blob, encoding)` \n * `encoding`參數不受支援，而 utf-8 編碼總是效果。\n\n### iOS 的持久性存儲位置\n\n有兩個有效的位置來存儲持久性在 iOS 設備上的檔： 檔目錄和圖書館目錄。 以前版本的外掛程式永遠只能將持久性檔存儲在文檔目錄中。 這已經使所有應用程式檔可見在 iTunes，往往是無意為之，尤其是對於處理大量小檔的應用程式中，而不是生產供出口，該目錄的既定的目標是證件齊全的副作用。\n\n現在可以選擇是否將檔存儲在檔或庫目錄，與您的應用程式的 `config.xml` 檔中的偏好。 要執行此操作，請將以下兩行之一添加到 `config.xml`：\n\n \n \n \n \n\n如果這條線，沒有檔外掛程式將使用 `Compatibility` 作為預設值。如果首選項標記存在，並不是這些值之一，應用程式將無法啟動。\n\n如果您的應用程式以前已被運到使用者，使用較舊的 （預 1.0） 版本的這個外掛程式，並具有持久性的檔，系統中存儲的檔，然後您應該設置 `Compatibility` 偏好。 切換到 `Library` 的位置，將意味著現有使用者升級他們的應用程式將無法訪問他們以前存儲的檔。\n\n如果您的應用程式是新的或以前從未有持久性的檔案系統中存儲檔，那麼通常建議使用 `Internal` 設置。\n\n## 火狐瀏覽器作業系統的怪癖\n\n檔案系統 API 本身不支援火狐瀏覽器的作業系統，作為墊片在 indexedDB 上實現的。\n\n * 不會失敗時刪除非空的目錄\n * 不支援中繼資料的目錄\n * 方法 `copyTo` 和 `moveTo` 不支援目錄\n\n支援以下資料路徑： * `applicationDirectory`-使用 `xhr` 獲取與應用程式打包的本地檔。 `dataDirectory`-用於持久性的特定于應用程式的資料檔案。 `cacheDirectory`-生存應重新開機應用程式的快取檔案 （應用程式不應依賴作業系統來刪除檔在這裡）。\n\n## 瀏覽器的怪癖\n\n### 常見的怪癖和備註\n\n * 每個瀏覽器使用其自己的沙箱檔案系統。IE 和火狐瀏覽器使用 IndexedDB 作為一個基地。所有瀏覽器都使用正斜杠作為路徑中的目錄分隔符號。\n * 目錄條目不得不先後創建。 例如，調用 `fs.root.getDirectory (' dir1/dir2 '，{create:true}，successCallback，errorCallback）`，如果不存在 dir1 將失敗。\n * 外掛程式將請求使用者許可權，以便在應用程式初次開機使用持久性存儲。 \n * 外掛程式支援 `cdvfile://localhost` （本地資源） 只。通過 `cdvfile` 不支援外部資源即.\n * 該外掛程式不遵循 [\"檔案系統 API 8.3 命名限制\"](http://www.w3.org/TR/2011/WD-file-system-api-20110419/#naming-restrictions).\n * Blob 和檔 ' `close` 功能不受支援。\n * `FileSaver` 和 `BlobBuilder` 不支援這個外掛程式，沒有存根 (stub)。\n * 該外掛程式不支援 `requestAllFileSystems`。這個功能也是缺少規範中。\n * 在目錄中的條目將不會被刪除，如果您使用 `create: true` 標誌為現有目錄。\n * 不支援通過建構函式創建的檔。你應該使用 entry.file 方法。\n * 每個瀏覽器使用它自己的形式為 blob 的 URL 引用。\n * 支援 `readAsDataURL` 功能，但在 Chrome 中的媒體類型取決於輸入副檔名，在 IE 中的媒體類型都始終空著 （這是 `純文字` 按照說明書一樣），在 Firefox 中的媒體類型始終是 `應用程式/八位位元組流`。 例如，如果內容是 `abcdefg` 然後火狐瀏覽器返回 `資料： 應用程式 / 八位位元組流 ； base64，YWJjZGVmZw = =`，即返回 `資料： ； base64，YWJjZGVmZw = =`，鉻返回 `資料： < 媒體類型根據擴展條目名稱 > ； base64，YWJjZGVmZw = =`.\n * 在表單 `file:///persistent/path/to/entry` 火狐瀏覽器 IE），`toInternalURL` 返回的路徑。 鉻在表單 `cdvfile://localhost/persistent/file` 返回的路徑.\n\n### 鉻的怪癖\n\n * 設備準備好事件之後，chrome 檔案系統並不能立即準備。作為一種變通方法，您可以訂閱到 `filePluginIsReady` 事件。示例： \n\n```javascript\nwindow.addEventListener('filePluginIsReady', function(){ console.log('File plugin is ready');}, false);\n```\n\n你可以使用 `window.isFilePluginReadyRaised` 函數來檢查是否已經引發了事件。 -window.requestFileSystem 臨時和永久性檔案系統配額並不局限于鉻。 為增加中鉻的持久性存儲，您需要調用 `window.initPersistentFileSystem` 方法。 預設情況下，持久性存儲配額為 5 MB。 鉻需要 `— — 允許--訪問-從-檔` 通過 `file:///` 協定運行參數對 API 的支援。 -如果您使用標誌，將不更改 `檔` 物件 `{create:true}` 現有 `條目` 的時候。 -事件 `可取消` 屬性設置為 true 在 Chrome 中。 這是違反了 [規範](http://dev.w3.org/2009/dap/file-system/file-writer.html)。 -中鉻的 `toURL` 函數返回 `檔案系統：`-首碼路徑具體取決於應用程式主機。 例如，`filesystem:file:///persistent/somefile.txt`，`filesystem:HTTP://localhost:8080/persistent/somefile.txt`。 -`toURL` 函數結果不包含尾部反斜線在目錄條目的情況下。 鉻雖然正確解析目錄帶斜杠落後的 url。 -`resolveLocalFileSystemURL` 方法需要入站的 `url` 必須具有 `檔案系統` 首碼。 例如，`resolveLocalFileSystemURL` 的 `url` 參數應在表單 `filesystem:file:///persistent/somefile.txt` 而不是表單 `file:///persistent/somefile.txt` 在安卓系統。 -不推薦使用 `toNativeURL` 函數不受支援，並且沒有存根 (stub)。 -`setMetadata` 功能是沒有說出的規格，並且不支援。 -INVALID_MODIFICATION_ERR (代碼: 9） 而不是引發 SYNTAX_ERR(code: 8) 上請求一個不存在的檔案系統。 -INVALID_MODIFICATION_ERR (代碼: 9） 而不是引發 PATH_EXISTS_ERR(code: 12) 上嘗試專門創建一個檔或目錄，它已經存在。 -INVALID_MODIFICATION_ERR (代碼: 9） 而不是引發 NO_MODIFICATION_ALLOWED_ERR(code: 6) 在試圖調用 removeRecursively 的根檔案系統上。 -INVALID_MODIFICATION_ERR (代碼: 9） 而不是引發 NOT_FOUND_ERR(code: 1) 試到 moveTo 目錄不存在。\n\n### 基於 IndexedDB 的 impl 怪癖 （Firefox 和 IE）\n\n * `.` 和 `.` 不受支援。\n * IE 不支援 `file:///`-模式 ；只有託管的模式是支援 （HTTP://localhost:xxxx）。\n * 火狐瀏覽器的檔案系統大小不是有限，但每個 50 MB 擴展會要求使用者的許可權。 IE10 允許達 10 mb 的 AppCache 和 IndexedDB 檔案系統的實現中使用而不會提示，一旦你達到這一水準你會詢問您是否允許它增加到每個網站的 250 mb 的最大合併。 所以 `requestFileSystem` 函數的 `大小` 參數並不影響檔案系統相容 Firefox 和 IE。\n * `readAsBinaryString` 函數在規範中沒有注明不支援在 IE 中和沒有存根 (stub)。\n * `file.type` 始終為 null。\n * 您不應創建條目使用已刪除的目錄實例回檔結果。否則，你會得到一個 '掛條目'。\n * 您可以讀取一個檔，其中只是寫之前你需要獲得的此檔的新實例。\n * `setMetadata` 函數，在規範中沒有注明支援 `modificationTime` 欄位的更改。 \n * `copyTo` 和 `moveTo` 函數不支援目錄。\n * 不支援目錄的中繼資料。\n * 兩個 Entry.remove 和 directoryEntry.removeRecursively 不失敗時刪除非空的目錄-相反與內容一起清理目錄被刪除。\n * 不支援 `abort` 和 `truncate` 函數。\n * 進度事件不會觸發。例如，將不執行此處理程式：\n\n```javascript\nwriter.onprogress = function() { /*commands*/ };\n```\n\n## 升級筆記\n\n在這個外掛程式 v1.0.0，`FileEntry` 和 `DirectoryEntry` 的結構已經改變，以更加一致的已發表說明書。\n\n以前 (pre-1.0.0） 版本的外掛程式中 `輸入` 物件的 `完整路徑` 屬性存放裝置固定檔案位置。這些路徑通常會看起來像\n\n /var/mobile/Applications//Documents/path/to/file (iOS)\n /storage/emulated/0/path/to/file (Android)\n \n\n這些路徑還返回的 `Entry` 物件的 `toURL()` 方法。\n\n與 v1.0.0，`完整路徑` 屬性是到檔中，*相對於 HTML 檔案系統的根目錄* 的路徑。 因此，上述路徑會現在都由一個 `FileEntry` 物件的 `完整路徑`，\n\n /path/to/file\n \n\n如果您的應用程式與設備-絕對路徑，並且您以前檢索到這些路徑通過 `條目` 物件的 `完整路徑` 屬性，然後您應該更新您的代碼以改用 `entry.toURL()`。\n\n為向後相容性，`resolveLocalFileSystemURL()` 方法將接受一個設備-絕對路徑，並將返回相應的 `條目` 物件，只要在 `臨時` 或 `永久性` 的檔案系統內的檔是否存在。\n\n這尤其是一直與檔案傳輸外掛程式，以前使用設備絕對路徑的問題 (和仍然可以接受他們)。 已更新它能夠正常運行與檔案系統的 Url，所以用 `entry.toURL()` 替換 `entry.fullPath` 應解決任何問題，得到該外掛程式來處理設備上的檔。\n\n在 v1.1.0 `toURL()` 的傳回值被更改 （見 [CB-6394] （HTTPs://issues.apache.org/jira/browse/CB-6394）） 為返回絕對 file:// URL。 只要有可能。 確保 'cdvfile：' — — 你現在可以用 `toInternalURL()` 的 URL。 現在，此方法將返回檔案系統表單的 Url\n\n cdvfile://localhost/persistent/path/to/file\n \n\n它可以用於唯一地標識該檔。\n\n## 錯誤代碼及其含義的清單中\n\n當拋出一個錯誤時，將使用以下代碼之一。\n\n| 代碼 | 恒 |\n| --:|:----------------------------- |\n| 1 | `NOT_FOUND_ERR` |\n| 2 | `SECURITY_ERR` |\n| 3 | `ABORT_ERR` |\n| 4 | `NOT_READABLE_ERR` |\n| 5 | `ENCODING_ERR` |\n| 6 | `NO_MODIFICATION_ALLOWED_ERR` |\n| 7 | `INVALID_STATE_ERR` |\n| 8 | `SYNTAX_ERR` |\n| 9 | `INVALID_MODIFICATION_ERR` |\n| 10 | `QUOTA_EXCEEDED_ERR` |\n| 11 | `TYPE_MISMATCH_ERR` |\n| 12 | `PATH_EXISTS_ERR` |\n\n## 配置外掛程式 （可選）\n\n可用的檔案系統的一整套可以配置每個平臺。IOS 和安卓系統認識到 在 `config.xml` 名稱要安裝的檔案系統中的標記。預設情況下，啟用所有檔案系統的根。\n\n \n \n \n\n### Android 系統\n\n * `files`： 該應用程式的內部檔存儲目錄\n * `files-external`： 應用程式的外部檔存儲目錄\n * `sdcard`： 全球外部檔存儲目錄 （如果安裝了一個，這是 SD 卡的根目錄）。 你必須具有 `android.permission.WRITE_EXTERNAL_STORAGE` 許可權，用這個。\n * `cache`： 應用程式的內部緩存目錄\n * `cache-external`： 應用程式的外部快取記憶體目錄\n * `root`： 整個設備的檔案系統\n\n安卓系統還支援特殊的檔命名為\"檔\"，表示\"/ 檔 /\"\"檔\"的檔案系統中的子目錄。\n\n### iOS\n\n * `library`： 應用程式的庫目錄\n * `documents`： 應用程式的檔目錄\n * `cache`： 應用程式的緩存目錄\n * `bundle`： 應用程式的包 ；應用程式本身 （唯讀） 的磁片上的位置\n * `root`： 整個設備的檔案系統\n\n預設情況下，圖書館和檔目錄可以同步到 iCloud。 您也可以要求兩個額外的檔案系統、 `library-nosync` 和 `documents-nosync`，代表一個特殊的非同步目錄內 `/Library` 或 `/Documents` 的檔案系統。"
},
{
"path": "plugins/cordova-plugin-file/doc/zh/index.md",
"content": "\n\n# cordova-plugin-file\n\n這個外掛程式實現檔 API 允許對檔駐留在該設備上的讀/寫訪問。\n\n這個外掛程式基於幾個規格，包括： HTML5 檔 API [HTTP://www.w3.org/TR/FileAPI/][1]\n\n [1]: http://www.w3.org/TR/FileAPI/\n\n（現已解散） 目錄和系統擴展最新： [HTTP://www.w3.org/TR/2012/WD-file-system-api-20120417/][2]雖然大部分的外掛程式代碼寫時較早的規格是當前： [HTTP://www.w3.org/TR/2011/WD-file-system-api-20110419/][3]\n\n [2]: http://www.w3.org/TR/2012/WD-file-system-api-20120417/\n [3]: http://www.w3.org/TR/2011/WD-file-system-api-20110419/\n\n它還實現 FileWriter 規格： [HTTP://dev.w3.org/2009/dap/file-system/file-writer.html][4]\n\n [4]: http://dev.w3.org/2009/dap/file-system/file-writer.html\n\n用法，請參閱對 HTML5 的岩石優秀[檔案系統文章。][5]\n\n [5]: http://www.html5rocks.com/en/tutorials/file/filesystem/\n\n其他存儲選項的概述，請參閱科爾多瓦的[存儲指南][6].\n\n [6]: http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html\n\n這個外掛程式定義全球 `cordova.file` 物件。\n\n雖然在全球範圍內，它不可用直到 `deviceready` 事件之後。\n\n document.addEventListener(\"deviceready\", onDeviceReady, false);\n function onDeviceReady() {\n console.log(cordova.file);\n }\n \n\n## 安裝\n\n cordova plugin add cordova-plugin-file\n \n\n## 支援的平臺\n\n* 亞馬遜火 OS\n* Android 系統\n* 黑莓 10\n* 火狐瀏覽器的作業系統\n* iOS\n* Windows Phone 7 和 8 *\n* Windows 8 *\n* 瀏覽器\n\n* *這些平臺不支援 `FileReader.readAsArrayBuffer` 或 `FileWriter.write(blob)`.*\n\n## 存儲檔的位置\n\n截至 v1.2.0，提供重要的檔案系統目錄的 Url。 每個 URL 位於表單 *file:///path/to/spot/*，和可以轉換為使用 `window.resolveLocalFileSystemURL()` 的 `DirectoryEntry`.\n\n* `cordova.file.applicationDirectory`-唯讀目錄在哪裡安裝的應用程式。（*iOS*、*安卓*、*黑莓 10*)\n\n* `cordova.file.applicationStorageDirectory`-根目錄下的應用程式的沙箱 ；在 iOS 上此位置是唯讀 （但特定的子目錄 [像 `/Documents` ] 都是讀寫）。 中包含的所有資料都是私有的應用程式。 （ *iOS*、*安卓*、*黑莓 10*)\n\n* `cordova.file.dataDirectory`資料持久性和私有資料存儲在內部記憶體使用的應用程式的沙箱內 （在安卓系統，如果你需要使用外部儲存體，使用 `.externalDataDirectory` ）。 在 iOS，此目錄不與 iCloud 同步 （使用 `.syncedDataDirectory` ）。 （*iOS*、*安卓*、*黑莓 10*)\n\n* `cordova.file.cacheDirectory`-緩存的資料檔案或您的應用程式重新可以輕鬆地創建的任何檔的目錄。 作業系統可能會刪除這些檔，該設備在存儲上運行低時，然而，應用程式不應依賴的作業系統，請刪除檔在這裡。 （*iOS*、*安卓*、*黑莓 10*)\n\n* `cordova.file.externalApplicationStorageDirectory`-應用程式外部存儲上的空間。（*安卓*)\n\n* `cordova.file.externalDataDirectory`-放在外部存儲特定于應用程式的資料檔案的位置。（*安卓*)\n\n* `cordova.file.externalCacheDirectory`-在外部存儲應用程式緩存。（*安卓*)\n\n* `cordova.file.externalRootDirectory`-外部存儲 （SD 卡） 的根。（*安卓*、*黑莓 10*)\n\n* `cordova.file.tempDirectory`-OS 可以清除時的空目錄會。 不依賴于 OS，以清除此目錄 ；您的應用程式，應總是移除作為適用的檔。 （*iOS*)\n\n* `cordova.file.syncedDataDirectory`-保存應同步 （例如到 iCloud） 的特定于應用程式的檔。（*iOS*)\n\n* `cordova.file.documentsDirectory`-檔私有的應用程式，但這是對其他應用程式 （例如 Office 檔） 有意義。（*iOS*)\n\n* `cordova.file.sharedDirectory`-對所有應用程式 （*黑莓 10*全域可用的檔)\n\n## 檔案系統佈局\n\n雖然技術上實現的細節，它可以是很有必要瞭解如何 `cordova.file.*` 屬性對應到實體路徑在實際設備上。\n\n### iOS 檔案系統佈局\n\n| 設備路徑 | `cordova.file.*` | `iosExtraFileSystems` | r/w 嗎？ | 持續性嗎？ | OS 清除 | 同步 | 私人 |\n|:------------------------------- |:--------------------------- |:--------------------- |:------:|:------:|:----------:|:---:|:--:|\n| `/ 無功/移動/應用程式/< UUID > /` | applicationStorageDirectory | - | r | 不適用 | 不適用 | 不適用 | 是啊 |\n| `appname.app/` | applicationDirectory | 束 | r | 不適用 | 不適用 | 不適用 | 是啊 |\n| `www/` | - | - | r | 不適用 | 不適用 | 不適用 | 是啊 |\n| `Documents/` | documentsDirectory | 檔 | r/w | 是啊 | 無 | 是啊 | 是啊 |\n| `NoCloud/` | - | 檔 nosync | r/w | 是啊 | 無 | 無 | 是啊 |\n| `Library` | - | 圖書館 | r/w | 是啊 | 無 | 是嗎？ | 是啊 |\n| `NoCloud/` | dataDirectory | 圖書館 nosync | r/w | 是啊 | 無 | 無 | 是啊 |\n| `Cloud/` | syncedDataDirectory | - | r/w | 是啊 | 無 | 是啊 | 是啊 |\n| `Caches/` | cacheDirectory | 快取記憶體 | r/w | 是啊 * | 是的 * * *| | 無 | 是啊 |\n| `tmp/` | tempDirectory | - | r/w | 沒有 * * | 是的 * * *| | 無 | 是啊 |\n\n* 檔堅持跨應用程式重新開機和升級，但是每當作業系統的欲望，可以清除此目錄。您的應用程式應該能夠重新創建任何內容可能會被刪除。\n\n* * 檔可能會持續整個應用程式重新開機，但不要依賴此行為。 不保證檔在更新之間持續存在。 您的應用程式時適用，是應該刪除此目錄的檔，因為作業系統並不能保證何時 （或即使） 中刪除這些檔。\n\n* * *| 作業系統可能會清除此目錄的內容，每當它感覺它是必要的但不要依賴于此。 你應該清除此目錄為適合您的應用程式。\n\n### Android 的檔案系統佈局\n\n| 設備路徑 | `cordova.file.*` | `AndroidExtraFileSystems` | r/w 嗎？ | 持續性嗎？ | OS 清除 | 私人 |\n|:--------------------------------- |:----------------------------------- |:------------------------- |:------:|:-----:|:------:|:--:|\n| `file:///android_asset/` | applicationDirectory | | r | 不適用 | 不適用 | 是啊 |\n| `/ 資料資料/< 應用程式 id > /` | applicationStorageDirectory | - | r/w | 不適用 | 不適用 | 是啊 |\n| `cache` | cacheDirectory | 快取記憶體 | r/w | 是啊 | 是啊 * | 是啊 |\n| `files` | dataDirectory | 檔 | r/w | 是啊 | 無 | 是啊 |\n| `Documents` | | 檔 | r/w | 是啊 | 無 | 是啊 |\n| `< sd 卡 > /` | externalRootDirectory | sd 卡 | r/w | 是啊 | 無 | 無 |\n| `Android/data//` | externalApplicationStorageDirectory | - | r/w | 是啊 | 無 | 無 |\n| `cache` | externalCacheDirectry | 外部快取記憶體 | r/w | 是啊 | 沒有 * * | 無 |\n| `files` | externalDataDirectory | 外部檔 | r/w | 是啊 | 無 | 無 |\n\n* 的作業系統可能會定期清除此目錄中，但不是依賴于這種行為。 清除此為適合您的應用程式的目錄的內容。 使用者應手動清除緩存，將刪除此目錄的內容。\n\n* * 作業系統不會自動清除此目錄你是負責管理自己的內容。 使用者應手動清除緩存，目錄中的內容將被刪除。\n\n**注**： 如果外部存儲無法裝入，`cordova.file.external*` 屬性為 `空`.\n\n### 黑莓 10 檔案系統佈局\n\n| 設備路徑 | `cordova.file.*` | r/w 嗎？ | 持續性嗎？ | OS 清除 | 私人 |\n|:---------------------------------------------------- |:--------------------------- |:------:|:-----:|:-----:|:--:|\n| `file:///accounts/1000/appdata/ < 應用程式 id > /` | applicationStorageDirectory | r | 不適用 | 不適用 | 是啊 |\n| `app/native` | applicationDirectory | r | 不適用 | 不適用 | 是啊 |\n| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | 無 | 是啊 | 是啊 |\n| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | 是啊 | 無 | 是啊 |\n| `file:///accounts/1000/removable/sdcard` | externalRemovableDirectory | r/w | 是啊 | 無 | 無 |\n| `file:///accounts/1000/shared` | sharedDirectory | r/w | 是啊 | 無 | 無 |\n\n*注意*： 當應用程式部署工作週邊時，所有路徑都是相對於 /accounts/1000-enterprise。\n\n## Android 的怪癖\n\n### Android 的持久性存儲位置\n\n有很多有效的位置來存儲持久性檔在 Android 設備上。 請參閱 [此頁面][7] 的各種可能性進行廣泛討論。\n\n [7]: http://developer.android.com/guide/topics/data/data-storage.html\n\n以前版本的外掛程式會選擇在啟動時，基於該設備是否聲稱 SD 卡 （或等效存儲分區） 展開，臨時和永久檔的位置。 如果被掛載 SD 卡，或一個大的內部存儲分區可用 （如 nexus 系列設備上） 然後持久性檔將存儲在該空間的根目錄中。 這意味著所有的科爾多瓦應用程式可以看到所有可用的檔在卡片上。\n\n如果 SD 卡不是可用的那麼以前的版本中將存儲資料下的 `/data/data/`，其中隔離應用程式從彼此，但仍可能導致使用者之間共用的資料。\n\n現在可以選擇是否將檔存儲在內部檔的存儲位置，或使用以前的邏輯，與您的應用程式的 `config.xml` 檔中的偏好。 要執行此操作，請將以下兩行之一添加到 `config.xml`：\n\n \n \n \n \n\n如果這條線，沒有檔外掛程式將使用 `Compatibility` 作為預設值。如果首選項標記存在，並不是這些值之一，應用程式將無法啟動。\n\n如果您的應用程式以前已被運到使用者，使用較舊的 （預 1.0） 版本的這個外掛程式，並具有持久性的檔，系統中存儲的檔，然後您應該設置 `Compatibility` 偏好。 切換到\"Internal\"的位置，將意味著現有使用者升級他們的應用程式可能無法訪問他們以前存儲的檔，具體取決於他們的設備。\n\n如果您的應用程式是新的或以前從未有持久性的檔案系統中存儲檔，那麼通常建議使用 `Internal` 設置。\n\n## iOS 的怪癖\n\n* `cordova.file.applicationStorageDirectory`是唯讀的 ；試圖存儲內的根目錄中的檔將會失敗。 使用的另一個 `cordova.file.*` 為 iOS 定義的屬性 （只有 `applicationDirectory` 和 `applicationStorageDirectory` 都是唯讀）。\n* `FileReader.readAsText(blob, encoding)` \n * `encoding`參數不受支援，而 utf-8 編碼總是效果。\n\n### iOS 的持久性存儲位置\n\n有兩個有效的位置來存儲持久性在 iOS 設備上的檔： 檔目錄和圖書館目錄。 以前版本的外掛程式永遠只能將持久性檔存儲在文檔目錄中。 這已經使所有應用程式檔可見在 iTunes，往往是無意為之，尤其是對於處理大量小檔的應用程式中，而不是生產供出口，該目錄的既定的目標是證件齊全的副作用。\n\n現在可以選擇是否將檔存儲在檔或庫目錄，與您的應用程式的 `config.xml` 檔中的偏好。 要執行此操作，請將以下兩行之一添加到 `config.xml`：\n\n \n \n \n \n\n如果這條線，沒有檔外掛程式將使用 `Compatibility` 作為預設值。如果首選項標記存在，並不是這些值之一，應用程式將無法啟動。\n\n如果您的應用程式以前已被運到使用者，使用較舊的 （預 1.0） 版本的這個外掛程式，並具有持久性的檔，系統中存儲的檔，然後您應該設置 `Compatibility` 偏好。 切換到 `Library` 的位置，將意味著現有使用者升級他們的應用程式將無法訪問他們以前存儲的檔。\n\n如果您的應用程式是新的或以前從未有持久性的檔案系統中存儲檔，那麼通常建議使用 `Internal` 設置。\n\n## 火狐瀏覽器作業系統的怪癖\n\n檔案系統 API 本身不支援火狐瀏覽器的作業系統，作為墊片在 indexedDB 上實現的。\n\n* 不會失敗時刪除非空的目錄\n* 不支援中繼資料的目錄\n* 方法 `copyTo` 和 `moveTo` 不支援目錄\n\n支援以下資料路徑： * `applicationDirectory`-使用 `xhr` 獲取與應用程式打包的本地檔。 `dataDirectory`-用於持久性的特定于應用程式的資料檔案。 `cacheDirectory`-生存應重新開機應用程式的快取檔案 （應用程式不應依賴作業系統來刪除檔在這裡）。\n\n## 瀏覽器的怪癖\n\n### 常見的怪癖和備註\n\n* 每個瀏覽器使用其自己的沙箱檔案系統。IE 和火狐瀏覽器使用 IndexedDB 作為一個基地。所有瀏覽器都使用正斜杠作為路徑中的目錄分隔符號。\n* 目錄條目不得不先後創建。 例如，調用 `fs.root.getDirectory (' dir1/dir2 '，{create:true}，successCallback，errorCallback）`，如果不存在 dir1 將失敗。\n* 外掛程式將請求使用者許可權，以便在應用程式初次開機使用持久性存儲。 \n* 外掛程式支援 `cdvfile://localhost` （本地資源） 只。通過 `cdvfile` 不支援外部資源即.\n* 該外掛程式不遵循 [\"檔案系統 API 8.3 命名限制\"][8].\n* Blob 和檔 ' `close` 功能不受支援。\n* `FileSaver` 和 `BlobBuilder` 不支援這個外掛程式，沒有存根 (stub)。\n* 該外掛程式不支援 `requestAllFileSystems`。這個功能也是缺少規範中。\n* 在目錄中的條目將不會被刪除，如果您使用 `create: true` 標誌為現有目錄。\n* 不支援通過建構函式創建的檔。你應該使用 entry.file 方法。\n* 每個瀏覽器使用它自己的形式為 blob 的 URL 引用。\n* 支援 `readAsDataURL` 功能，但在 Chrome 中的媒體類型取決於輸入副檔名，在 IE 中的媒體類型都始終空著 （這是 `純文字` 按照說明書一樣），在 Firefox 中的媒體類型始終是 `應用程式/八位位元組流`。 例如，如果內容是 `abcdefg` 然後火狐瀏覽器返回 `資料： 應用程式 / 八位位元組流 ； base64，YWJjZGVmZw = =`，即返回 `資料： ； base64，YWJjZGVmZw = =`，鉻返回 `資料： < 媒體類型根據擴展條目名稱 > ； base64，YWJjZGVmZw = =`.\n* 在表單 `file:///persistent/path/to/entry` 火狐瀏覽器 IE），`toInternalURL` 返回的路徑。 鉻在表單 `cdvfile://localhost/persistent/file` 返回的路徑.\n\n [8]: http://www.w3.org/TR/2011/WD-file-system-api-20110419/#naming-restrictions\n\n### 鉻的怪癖\n\n* 設備準備好事件之後，chrome 檔案系統並不能立即準備。作為一種變通方法，您可以訂閱到 `filePluginIsReady` 事件。示例： \n\n javascript\n window.addEventListener('filePluginIsReady', function(){ console.log('File plugin is ready');}, false);\n \n\n你可以使用 `window.isFilePluginReadyRaised` 函數來檢查是否已經引發了事件。 -window.requestFileSystem 臨時和永久性檔案系統配額並不局限于鉻。 為增加中鉻的持久性存儲，您需要調用 `window.initPersistentFileSystem` 方法。 預設情況下，持久性存儲配額為 5 MB。 鉻需要 `— — 允許--訪問-從-檔` 通過 `file:///` 協定運行參數對 API 的支援。 -如果您使用標誌，將不更改 `檔` 物件 `{create:true}` 現有 `條目` 的時候。 -事件 `可取消` 屬性設置為 true 在 Chrome 中。 這是違反了 [規範][4]。 -中鉻的 `toURL` 函數返回 `檔案系統：`-首碼路徑具體取決於應用程式主機。 例如，`filesystem:file:///persistent/somefile.txt`，`filesystem:HTTP://localhost:8080/persistent/somefile.txt`。 -`toURL` 函數結果不包含尾部反斜線在目錄條目的情況下。 鉻雖然正確解析目錄帶斜杠落後的 url。 -`resolveLocalFileSystemURL` 方法需要入站的 `url` 必須具有 `檔案系統` 首碼。 例如，`resolveLocalFileSystemURL` 的 `url` 參數應在表單 `filesystem:file:///persistent/somefile.txt` 而不是表單 `file:///persistent/somefile.txt` 在安卓系統。 -不推薦使用 `toNativeURL` 函數不受支援，並且沒有存根 (stub)。 -`setMetadata` 功能是沒有說出的規格，並且不支援。 -INVALID_MODIFICATION_ERR (代碼: 9） 而不是引發 SYNTAX_ERR(code: 8) 上請求一個不存在的檔案系統。 -INVALID_MODIFICATION_ERR (代碼: 9） 而不是引發 PATH_EXISTS_ERR(code: 12) 上嘗試專門創建一個檔或目錄，它已經存在。 -INVALID_MODIFICATION_ERR (代碼: 9） 而不是引發 NO_MODIFICATION_ALLOWED_ERR(code: 6) 在試圖調用 removeRecursively 的根檔案系統上。 -INVALID_MODIFICATION_ERR (代碼: 9） 而不是引發 NOT_FOUND_ERR(code: 1) 試到 moveTo 目錄不存在。\n\n### 基於 IndexedDB 的 impl 怪癖 （Firefox 和 IE）\n\n* `.` 和 `.` 不受支援。\n* IE 不支援 `file:///`-模式 ；只有託管的模式是支援 （HTTP://localhost:xxxx）。\n* 火狐瀏覽器的檔案系統大小不是有限，但每個 50 MB 擴展會要求使用者的許可權。 IE10 允許達 10 mb 的 AppCache 和 IndexedDB 檔案系統的實現中使用而不會提示，一旦你達到這一水準你會詢問您是否允許它增加到每個網站的 250 mb 的最大合併。 所以 `requestFileSystem` 函數的 `大小` 參數並不影響檔案系統相容 Firefox 和 IE。\n* `readAsBinaryString` 函數在規範中沒有注明不支援在 IE 中和沒有存根 (stub)。\n* `file.type` 始終為 null。\n* 您不應創建條目使用已刪除的目錄實例回檔結果。否則，你會得到一個 '掛條目'。\n* 您可以讀取一個檔，其中只是寫之前你需要獲得的此檔的新實例。\n* `setMetadata` 函數，在規範中沒有注明支援 `modificationTime` 欄位的更改。 \n* `copyTo` 和 `moveTo` 函數不支援目錄。\n* 不支援目錄的中繼資料。\n* 兩個 Entry.remove 和 directoryEntry.removeRecursively 不失敗時刪除非空的目錄-相反與內容一起清理目錄被刪除。\n* 不支援 `abort` 和 `truncate` 函數。\n* 進度事件不會觸發。例如，將不執行此處理程式：\n\n javascript\n writer.onprogress = function() { /*commands*/ };\n \n\n## 升級筆記\n\n在這個外掛程式 v1.0.0，`FileEntry` 和 `DirectoryEntry` 的結構已經改變，以更加一致的已發表說明書。\n\n以前 (pre-1.0.0） 版本的外掛程式中 `輸入` 物件的 `完整路徑` 屬性存放裝置固定檔案位置。這些路徑通常會看起來像\n\n /var/mobile/Applications//Documents/path/to/file (iOS)\n /storage/emulated/0/path/to/file (Android)\n \n\n這些路徑還返回的 `Entry` 物件的 `toURL()` 方法。\n\n與 v1.0.0，`完整路徑` 屬性是到檔中，*相對於 HTML 檔案系統的根目錄* 的路徑。 因此，上述路徑會現在都由一個 `FileEntry` 物件的 `完整路徑`，\n\n /path/to/file\n \n\n如果您的應用程式與設備-絕對路徑，並且您以前檢索到這些路徑通過 `條目` 物件的 `完整路徑` 屬性，然後您應該更新您的代碼以改用 `entry.toURL()`。\n\n為向後相容性，`resolveLocalFileSystemURL()` 方法將接受一個設備-絕對路徑，並將返回相應的 `條目` 物件，只要在 `臨時` 或 `永久性` 的檔案系統內的檔是否存在。\n\n這尤其是一直與檔案傳輸外掛程式，以前使用設備絕對路徑的問題 (和仍然可以接受他們)。 已更新它能夠正常運行與檔案系統的 Url，所以用 `entry.toURL()` 替換 `entry.fullPath` 應解決任何問題，得到該外掛程式來處理設備上的檔。\n\n在 v1.1.0 `toURL()` 的傳回值被更改 （見 [CB-6394] （HTTPs://issues.apache.org/jira/browse/CB-6394）） 為返回絕對 file:// URL。 只要有可能。 確保 'cdvfile：' — — 你現在可以用 `toInternalURL()` 的 URL。 現在，此方法將返回檔案系統表單的 Url\n\n cdvfile://localhost/persistent/path/to/file\n \n\n它可以用於唯一地標識該檔。\n\n## 錯誤代碼及其含義的清單中\n\n當拋出一個錯誤時，將使用以下代碼之一。\n\n| 代碼 | 恒 |\n| --:|:----------------------------- |\n| 1 | `NOT_FOUND_ERR` |\n| 2 | `SECURITY_ERR` |\n| 3 | `ABORT_ERR` |\n| 4 | `NOT_READABLE_ERR` |\n| 5 | `ENCODING_ERR` |\n| 6 | `NO_MODIFICATION_ALLOWED_ERR` |\n| 7 | `INVALID_STATE_ERR` |\n| 8 | `SYNTAX_ERR` |\n| 9 | `INVALID_MODIFICATION_ERR` |\n| 10 | `QUOTA_EXCEEDED_ERR` |\n| 11 | `TYPE_MISMATCH_ERR` |\n| 12 | `PATH_EXISTS_ERR` |\n\n## 配置外掛程式 （可選）\n\n可用的檔案系統的一整套可以配置每個平臺。IOS 和安卓系統認識到 在 `config.xml` 名稱要安裝的檔案系統中的標記。預設情況下，啟用所有檔案系統的根。\n\n \n \n \n\n### Android 系統\n\n* `files`： 該應用程式的內部檔存儲目錄\n* `files-external`： 應用程式的外部檔存儲目錄\n* `sdcard`： 全球外部檔存儲目錄 （如果安裝了一個，這是 SD 卡的根目錄）。 你必須具有 `android.permission.WRITE_EXTERNAL_STORAGE` 許可權，用這個。\n* `cache`： 應用程式的內部緩存目錄\n* `cache-external`： 應用程式的外部快取記憶體目錄\n* `root`： 整個設備的檔案系統\n\n安卓系統還支援特殊的檔命名為\"檔\"，表示\"/ 檔 /\"\"檔\"的檔案系統中的子目錄。\n\n### iOS\n\n* `library`： 應用程式的庫目錄\n* `documents`： 應用程式的檔目錄\n* `cache`： 應用程式的緩存目錄\n* `bundle`： 應用程式的包 ；應用程式本身 （唯讀） 的磁片上的位置\n* `root`： 整個設備的檔案系統\n\n預設情況下，圖書館和檔目錄可以同步到 iCloud。 您也可以要求兩個額外的檔案系統、 `library-nosync` 和 `documents-nosync`，代表一個特殊的非同步目錄內 `/Library` 或 `/Documents` 的檔案系統。\n"
},
{
"path": "plugins/cordova-plugin-file/doc/zh/plugins.md",
"content": "\n\n# 外掛程式開發人員注意事項\n\n這些筆記主要用於 Android 和 iOS 開發者想要編寫外掛程式的介面與使用檔外掛程式的檔案系統。\n\n## 工作與科爾多瓦檔案系統 Url\n\n自從版本 1.0.0，這個外掛程式一直使用 Url 與 `cdvfile` 大橋，計畫為所有通信，而不是揭露 JavaScript 的原始設備檔案系統路徑。\n\n在 JavaScript 方面，這意味著 FileEntry 和 DirectoryEntry 的物件有一個完整路徑屬性是相對於 HTML 檔案系統的根目錄。 如果你的外掛程式的 JavaScript API 接受一個 FileEntry 或 DirectoryEntry 的物件，你應該打電話給 `.toURL()` 對該物件之前將它從橋上傳遞給本機代碼。\n\n### 轉換 cdvfile: / / fileystem 路徑的 Url\n\n需要寫入到檔案系統的外掛程式可能想要將接收的檔案系統 URL 轉換為實際的檔案系統位置。有做這，根據本機平臺的多種方式。\n\n很重要的是要記住，並不是所有 `cdvfile://` Url 是可映射到設備上的實際檔。 某些 Url 可以指在設備上沒有代表的檔，或甚至可以引用遠端資源的資產。 由於這些可能性，外掛程式應始終測試是否回來時試圖將 Url 轉換成路徑得到有意義的結果。\n\n#### 安卓系統\n\n在 android 系統，最簡單的方法來轉換 `cdvfile://` 檔案系統路徑的 URL 是使用 `org.apache.cordova.CordovaResourceApi` 。 `CordovaResourceApi`有幾種方法，可處理 `cdvfile://` 網址:\n\n web 視圖是成員的外掛程式類 CordovaResourceApi resourceApi = webView.getResourceApi();\n \n 獲取表示此檔在設備上，file:/// URL / / 或 URL 相同變的如果它不能映射到檔 Uri fileURL = resourceApi.remapUri(Uri.parse(cdvfileURL));\n \n\n它也是可以直接使用檔外掛程式:\n\n 導入 org.apache.cordova.file.FileUtils;\n 導入 org.apache.cordova.file.FileSystem;\n 導入 java.net.MalformedURLException;\n \n 得到檔外掛程式外掛程式管理器從 FileUtils filePlugin = (FileUtils)webView.pluginManager.getPlugin(\"File\");\n \n 給定 URL，得到的路徑，因為它嘗試 {字串路徑 = filePlugin.filesystemPathForURL(cdvfileURL);} 趕上 (MalformedURLException e) {/ / 檔案系統 url 不承認}\n \n\n要轉換到的路徑從 `cdvfile://` URL:\n\n 導入 org.apache.cordova.file.LocalFilesystemURL;\n \n 獲取設備的路徑，一個 LocalFilesystemURL 物件 / / 或如果它不能表示為 cdvfile 的 URL，則為 null。\n LocalFilesystemURL url = filePlugin.filesystemURLforLocalPath(path);\n 得到的字串表示形式的 URL 物件字串 cdvfileURL = url.toString();\n \n\n如果你的外掛程式創建一個檔，並且您想要為它返回一個 FileEntry 物件，使用該檔的外掛程式:\n\n 返回一個 JSON 結構適合於回到 JavaScript，/ / 或如果此檔不是可表示為 cdvfile 的 URL，則為 null。\n JSONObject 條目 = filePlugin.getEntryForFile(file);\n \n\n#### iOS\n\n科爾多瓦在 iOS 上的不使用相同 `CordovaResourceApi` 作為 android 系統的概念。在 iOS，應使用檔外掛程式 Url 和檔案系統路徑之間進行轉換。\n\n 獲取一個物件，CDVFilesystem URL 從 url 字串 CDVFilesystemURL * = [CDVFilesystemURL fileSystemURLWithString:cdvfileURL];\n 獲取路徑 URL 物件，或為零，如果它不能映射到檔 NSString * 路徑 = [filePlugin filesystemPathForURL:url];\n \n \n CDVFilesystem URL 物件獲取設備的路徑，或 / / 為零，如果它不能表示為 cdvfile 的 URL。\n CDVFilesystemURL * url = [filePlugin fileSystemURLforLocalPath:path];\n 得到的字串表示形式的 URL 物件 NSString * cdvfileURL = [url absoluteString];\n \n\n如果你的外掛程式創建一個檔，並且您想要為它返回一個 FileEntry 物件，使用該檔的外掛程式:\n\n CDVFilesystem URL 物件獲取設備的路徑，或 / / 為零，如果它不能表示為 cdvfile 的 URL。\n CDVFilesystemURL * url = [filePlugin fileSystemURLforLocalPath:path];\n 得到一個結構來返回進入 JavaScript NSDictionary * = [filePlugin makeEntryForLocalURL:url]\n \n\n#### JavaScript\n\n在 JavaScript 中，得到 `cdvfile://` URL 從 FileEntry 或 DirectoryEntry 的物件，只需調用 `.toURL()` 對它:\n\n var cdvfileURL = entry.toURL();\n \n\n在外掛程式回應處理常式，將從返回的 FileEntry 結構轉換為實際的條目物件，處理常式代碼應該導入檔外掛程式和創建新的物件:\n\n 創建適當的條目物件 var 條目;\n 如果 (entryStruct.isDirectory) {條目 = 新目錄 (entryStruct.name，entryStruct.fullPath，新 FileSystem(entryStruct.filesystemName));} 其他 {條目 = 新的 FileEntry (entryStruct.name，entryStruct.fullPath，新 FileSystem(entryStruct.filesystemName));}"
},
{
"path": "plugins/cordova-plugin-file/package.json",
"content": "{\n \"name\": \"cordova-plugin-file\",\n \"version\": \"4.2.0\",\n \"description\": \"Cordova File Plugin\",\n \"cordova\": {\n \"id\": \"cordova-plugin-file\",\n \"platforms\": [\n \"android\",\n \"amazon-fireos\",\n \"ubuntu\",\n \"ios\",\n \"osx\",\n \"wp7\",\n \"wp8\",\n \"blackberry10\",\n \"windows8\",\n \"windows\",\n \"firefoxos\"\n ]\n },\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/apache/cordova-plugin-file\"\n },\n \"keywords\": [\n \"cordova\",\n \"file\",\n \"ecosystem:cordova\",\n \"cordova-android\",\n \"cordova-amazon-fireos\",\n \"cordova-ubuntu\",\n \"cordova-ios\",\n \"cordova-osx\",\n \"cordova-wp7\",\n \"cordova-wp8\",\n \"cordova-blackberry10\",\n \"cordova-windows8\",\n \"cordova-windows\",\n \"cordova-firefoxos\"\n ],\n \"scripts\": {\n \"test\": \"npm run jshint\",\n \"jshint\": \"node node_modules/jshint/bin/jshint www && node node_modules/jshint/bin/jshint src && node node_modules/jshint/bin/jshint tests\"\n },\n \"author\": \"Apache Software Foundation\",\n \"license\": \"Apache-2.0\",\n \"devDependencies\": {\n \"jshint\": \"^2.6.0\"\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-file/plugin.xml",
"content": "\n\n\n\n File\n Cordova File Plugin\n Apache 2.0\n cordova,file\n https://git-wip-us.apache.org/repos/asf/cordova-plugin-file.git\n https://issues.apache.org/jira/browse/CB/component/12320651\n \n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n \n \n \n\n \n \n \n\n \n \n \n\n \n\n \n \n \n\n \n \n \n\n \n \n \n \n\n \nThe Android Persistent storage location now defaults to \"Internal\". Please check this plugins README to see if you application needs any changes in its config.xml.\n\nIf this is a new application no changes are required.\n\nIf this is an update to an existing application that did not specify an \"AndroidPersistentFileLocation\" you may need to add:\n\n \"<preference name=\"AndroidPersistentFileLocation\" value=\"Compatibility\" />\"\n\nto config.xml in order for the application to find previously stored files.\n\n \n\n \n \n \n \n \n \n \n \n\n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n\n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n\n\n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n\n \n \n \n\n \n \n \n \n\n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n\n \n \n \n\n \n \n \n \n \n\n \n \n \n \n \n \n \n\n \n\n \n \n \n \n\n \n\n \n \n \n \n \n \n \n\n \n\n \n \n \n \n\n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n\n \n \n \n \n \n\n \n \n \n \n \n\n \n \n \n \n \n\n \n \n \n \n \n\n \n \n \n \n\n \n \n \n \n \n\n \n \n \n \n \n\n \n \n \n\n \n \n \n \n\n \n \n \n \n\n\n"
},
{
"path": "plugins/cordova-plugin-file/src/android/AssetFilesystem.java",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\npackage org.apache.cordova.file;\n\nimport android.content.res.AssetManager;\nimport android.net.Uri;\nimport android.util.Log;\n\nimport org.apache.cordova.CordovaResourceApi;\nimport org.json.JSONArray;\nimport org.json.JSONException;\nimport org.json.JSONObject;\n\nimport java.io.File;\nimport java.io.FileNotFoundException;\nimport java.io.IOException;\nimport java.io.ObjectInputStream;\nimport java.util.HashMap;\nimport java.util.Map;\n\npublic class AssetFilesystem extends Filesystem {\n\n private final AssetManager assetManager;\n\n // A custom gradle hook creates the cdvasset.manifest file, which speeds up asset listing a tonne.\n // See: http://stackoverflow.com/questions/16911558/android-assetmanager-list-incredibly-slow\n private static Object listCacheLock = new Object();\n private static boolean listCacheFromFile;\n private static Map listCache;\n private static Map lengthCache;\n\n private void lazyInitCaches() {\n synchronized (listCacheLock) {\n if (listCache == null) {\n ObjectInputStream ois = null;\n try {\n ois = new ObjectInputStream(assetManager.open(\"cdvasset.manifest\"));\n listCache = (Map) ois.readObject();\n lengthCache = (Map) ois.readObject();\n listCacheFromFile = true;\n } catch (ClassNotFoundException e) {\n e.printStackTrace();\n } catch (IOException e) {\n // Asset manifest won't exist if the gradle hook isn't set up correctly.\n } finally {\n if (ois != null) {\n try {\n ois.close();\n } catch (IOException e) {\n }\n }\n }\n if (listCache == null) {\n Log.w(\"AssetFilesystem\", \"Asset manifest not found. Recursive copies and directory listing will be slow.\");\n listCache = new HashMap();\n }\n }\n }\n }\n\n private String[] listAssets(String assetPath) throws IOException {\n if (assetPath.startsWith(\"/\")) {\n assetPath = assetPath.substring(1);\n }\n if (assetPath.endsWith(\"/\")) {\n assetPath = assetPath.substring(0, assetPath.length() - 1);\n }\n lazyInitCaches();\n String[] ret = listCache.get(assetPath);\n if (ret == null) {\n if (listCacheFromFile) {\n ret = new String[0];\n } else {\n ret = assetManager.list(assetPath);\n listCache.put(assetPath, ret);\n }\n }\n return ret;\n }\n\n private long getAssetSize(String assetPath) throws FileNotFoundException {\n if (assetPath.startsWith(\"/\")) {\n assetPath = assetPath.substring(1);\n }\n lazyInitCaches();\n if (lengthCache != null) {\n Long ret = lengthCache.get(assetPath);\n if (ret == null) {\n throw new FileNotFoundException(\"Asset not found: \" + assetPath);\n }\n return ret;\n }\n CordovaResourceApi.OpenForReadResult offr = null;\n try {\n offr = resourceApi.openForRead(nativeUriForFullPath(assetPath));\n long length = offr.length;\n if (length < 0) {\n // available() doesn't always yield the file size, but for assets it does.\n length = offr.inputStream.available();\n }\n return length;\n } catch (IOException e) {\n throw new FileNotFoundException(\"File not found: \" + assetPath);\n } finally {\n if (offr != null) {\n try {\n offr.inputStream.close();\n } catch (IOException e) {\n }\n }\n }\n }\n\n public AssetFilesystem(AssetManager assetManager, CordovaResourceApi resourceApi) {\n super(Uri.parse(\"file:///android_asset/\"), \"assets\", resourceApi);\n this.assetManager = assetManager;\n\t}\n\n @Override\n public Uri toNativeUri(LocalFilesystemURL inputURL) {\n return nativeUriForFullPath(inputURL.path);\n }\n\n @Override\n public LocalFilesystemURL toLocalUri(Uri inputURL) {\n if (!\"file\".equals(inputURL.getScheme())) {\n return null;\n }\n File f = new File(inputURL.getPath());\n // Removes and duplicate /s (e.g. file:///a//b/c)\n Uri resolvedUri = Uri.fromFile(f);\n String rootUriNoTrailingSlash = rootUri.getEncodedPath();\n rootUriNoTrailingSlash = rootUriNoTrailingSlash.substring(0, rootUriNoTrailingSlash.length() - 1);\n if (!resolvedUri.getEncodedPath().startsWith(rootUriNoTrailingSlash)) {\n return null;\n }\n String subPath = resolvedUri.getEncodedPath().substring(rootUriNoTrailingSlash.length());\n // Strip leading slash\n if (!subPath.isEmpty()) {\n subPath = subPath.substring(1);\n }\n Uri.Builder b = new Uri.Builder()\n .scheme(LocalFilesystemURL.FILESYSTEM_PROTOCOL)\n .authority(\"localhost\")\n .path(name);\n if (!subPath.isEmpty()) {\n b.appendEncodedPath(subPath);\n }\n if (isDirectory(subPath) || inputURL.getPath().endsWith(\"/\")) {\n // Add trailing / for directories.\n b.appendEncodedPath(\"\");\n }\n return LocalFilesystemURL.parse(b.build());\n }\n\n private boolean isDirectory(String assetPath) {\n try {\n return listAssets(assetPath).length != 0;\n } catch (IOException e) {\n return false;\n }\n }\n\n @Override\n public LocalFilesystemURL[] listChildren(LocalFilesystemURL inputURL) throws FileNotFoundException {\n String pathNoSlashes = inputURL.path.substring(1);\n if (pathNoSlashes.endsWith(\"/\")) {\n pathNoSlashes = pathNoSlashes.substring(0, pathNoSlashes.length() - 1);\n }\n\n String[] files;\n try {\n files = listAssets(pathNoSlashes);\n } catch (IOException e) {\n throw new FileNotFoundException();\n }\n\n LocalFilesystemURL[] entries = new LocalFilesystemURL[files.length];\n for (int i = 0; i < files.length; ++i) {\n entries[i] = localUrlforFullPath(new File(inputURL.path, files[i]).getPath());\n }\n return entries;\n\t}\n\n @Override\n public JSONObject getFileForLocalURL(LocalFilesystemURL inputURL,\n String path, JSONObject options, boolean directory)\n throws FileExistsException, IOException, TypeMismatchException, EncodingException, JSONException {\n if (options != null && options.optBoolean(\"create\")) {\n throw new UnsupportedOperationException(\"Assets are read-only\");\n }\n\n // Check whether the supplied path is absolute or relative\n if (directory && !path.endsWith(\"/\")) {\n path += \"/\";\n }\n\n LocalFilesystemURL requestedURL;\n if (path.startsWith(\"/\")) {\n requestedURL = localUrlforFullPath(normalizePath(path));\n } else {\n requestedURL = localUrlforFullPath(normalizePath(inputURL.path + \"/\" + path));\n }\n\n // Throws a FileNotFoundException if it doesn't exist.\n getFileMetadataForLocalURL(requestedURL);\n\n boolean isDir = isDirectory(requestedURL.path);\n if (directory && !isDir) {\n throw new TypeMismatchException(\"path doesn't exist or is file\");\n } else if (!directory && isDir) {\n throw new TypeMismatchException(\"path doesn't exist or is directory\");\n }\n\n // Return the directory\n return makeEntryForURL(requestedURL);\n }\n\n @Override\n\tpublic JSONObject getFileMetadataForLocalURL(LocalFilesystemURL inputURL) throws FileNotFoundException {\n JSONObject metadata = new JSONObject();\n long size = inputURL.isDirectory ? 0 : getAssetSize(inputURL.path);\n try {\n \tmetadata.put(\"size\", size);\n \tmetadata.put(\"type\", inputURL.isDirectory ? \"text/directory\" : resourceApi.getMimeType(toNativeUri(inputURL)));\n \tmetadata.put(\"name\", new File(inputURL.path).getName());\n \tmetadata.put(\"fullPath\", inputURL.path);\n \tmetadata.put(\"lastModifiedDate\", 0);\n } catch (JSONException e) {\n return null;\n }\n return metadata;\n\t}\n\n\t@Override\n\tpublic boolean canRemoveFileAtLocalURL(LocalFilesystemURL inputURL) {\n\t\treturn false;\n\t}\n\n @Override\n long writeToFileAtURL(LocalFilesystemURL inputURL, String data, int offset, boolean isBinary) throws NoModificationAllowedException, IOException {\n throw new NoModificationAllowedException(\"Assets are read-only\");\n }\n\n @Override\n long truncateFileAtURL(LocalFilesystemURL inputURL, long size) throws IOException, NoModificationAllowedException {\n throw new NoModificationAllowedException(\"Assets are read-only\");\n }\n\n @Override\n String filesystemPathForURL(LocalFilesystemURL url) {\n return null;\n }\n\n @Override\n LocalFilesystemURL URLforFilesystemPath(String path) {\n return null;\n }\n\n @Override\n boolean removeFileAtLocalURL(LocalFilesystemURL inputURL) throws InvalidModificationException, NoModificationAllowedException {\n throw new NoModificationAllowedException(\"Assets are read-only\");\n }\n\n @Override\n boolean recursiveRemoveFileAtLocalURL(LocalFilesystemURL inputURL) throws NoModificationAllowedException {\n throw new NoModificationAllowedException(\"Assets are read-only\");\n }\n\n}\n"
},
{
"path": "plugins/cordova-plugin-file/src/android/ContentFilesystem.java",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\npackage org.apache.cordova.file;\n\nimport android.content.ContentResolver;\nimport android.content.Context;\nimport android.database.Cursor;\nimport android.net.Uri;\nimport android.provider.DocumentsContract;\nimport android.provider.MediaStore;\nimport android.provider.OpenableColumns;\nimport java.io.File;\nimport java.io.FileNotFoundException;\nimport java.io.IOException;\nimport org.apache.cordova.CordovaResourceApi;\nimport org.json.JSONException;\nimport org.json.JSONObject;\n\npublic class ContentFilesystem extends Filesystem {\n\n private final Context context;\n\n\tpublic ContentFilesystem(Context context, CordovaResourceApi resourceApi) {\n\t\tsuper(Uri.parse(\"content://\"), \"content\", resourceApi);\n this.context = context;\n\t}\n\n @Override\n public Uri toNativeUri(LocalFilesystemURL inputURL) {\n String authorityAndPath = inputURL.uri.getEncodedPath().substring(this.name.length() + 2);\n if (authorityAndPath.length() < 2) {\n return null;\n }\n String ret = \"content://\" + authorityAndPath;\n String query = inputURL.uri.getEncodedQuery();\n if (query != null) {\n ret += '?' + query;\n }\n String frag = inputURL.uri.getEncodedFragment();\n if (frag != null) {\n ret += '#' + frag;\n }\n return Uri.parse(ret);\n }\n\n @Override\n public LocalFilesystemURL toLocalUri(Uri inputURL) {\n if (!\"content\".equals(inputURL.getScheme())) {\n return null;\n }\n String subPath = inputURL.getEncodedPath();\n if (subPath.length() > 0) {\n subPath = subPath.substring(1);\n }\n Uri.Builder b = new Uri.Builder()\n .scheme(LocalFilesystemURL.FILESYSTEM_PROTOCOL)\n .authority(\"localhost\")\n .path(name)\n .appendPath(inputURL.getAuthority());\n if (subPath.length() > 0) {\n b.appendEncodedPath(subPath);\n }\n Uri localUri = b.encodedQuery(inputURL.getEncodedQuery())\n .encodedFragment(inputURL.getEncodedFragment())\n .build();\n return LocalFilesystemURL.parse(localUri);\n }\n\n @Override\n\tpublic JSONObject getFileForLocalURL(LocalFilesystemURL inputURL,\n\t\t\tString fileName, JSONObject options, boolean directory) throws IOException, TypeMismatchException, JSONException {\n throw new UnsupportedOperationException(\"getFile() not supported for content:. Use resolveLocalFileSystemURL instead.\");\n\t}\n\n\t@Override\n\tpublic boolean removeFileAtLocalURL(LocalFilesystemURL inputURL)\n\t\t\tthrows NoModificationAllowedException {\n Uri contentUri = toNativeUri(inputURL);\n\t\ttry {\n context.getContentResolver().delete(contentUri, null, null);\n\t\t} catch (UnsupportedOperationException t) {\n\t\t\t// Was seeing this on the File mobile-spec tests on 4.0.3 x86 emulator.\n\t\t\t// The ContentResolver applies only when the file was registered in the\n\t\t\t// first case, which is generally only the case with images.\n throw new NoModificationAllowedException(\"Deleting not supported for content uri: \" + contentUri);\n\t\t}\n return true;\n\t}\n\n\t@Override\n\tpublic boolean recursiveRemoveFileAtLocalURL(LocalFilesystemURL inputURL)\n\t\t\tthrows NoModificationAllowedException {\n\t\tthrow new NoModificationAllowedException(\"Cannot remove content url\");\n\t}\n\n @Override\n public LocalFilesystemURL[] listChildren(LocalFilesystemURL inputURL) throws FileNotFoundException {\n throw new UnsupportedOperationException(\"readEntriesAtLocalURL() not supported for content:. Use resolveLocalFileSystemURL instead.\");\n }\n\n\t@Override\n\tpublic JSONObject getFileMetadataForLocalURL(LocalFilesystemURL inputURL) throws FileNotFoundException {\n long size = -1;\n long lastModified = 0;\n Uri nativeUri = toNativeUri(inputURL);\n String mimeType = resourceApi.getMimeType(nativeUri);\n Cursor cursor = openCursorForURL(nativeUri);\n try {\n \tif (cursor != null && cursor.moveToFirst()) {\n \t\tsize = resourceSizeForCursor(cursor);\n Long modified = lastModifiedDateForCursor(cursor);\n if (modified != null)\n lastModified = modified.longValue();\n \t} else {\n // Some content providers don't support cursors at all!\n CordovaResourceApi.OpenForReadResult offr = resourceApi.openForRead(nativeUri);\n \t\t\tsize = offr.length;\n \t}\n } catch (IOException e) {\n throw new FileNotFoundException();\n } finally {\n \tif (cursor != null)\n \t\tcursor.close();\n }\n\n JSONObject metadata = new JSONObject();\n try {\n \tmetadata.put(\"size\", size);\n \tmetadata.put(\"type\", mimeType);\n \tmetadata.put(\"name\", name);\n \tmetadata.put(\"fullPath\", inputURL.path);\n \tmetadata.put(\"lastModifiedDate\", lastModified);\n } catch (JSONException e) {\n \treturn null;\n }\n return metadata;\n\t}\n\n\t@Override\n\tpublic long writeToFileAtURL(LocalFilesystemURL inputURL, String data,\n\t\t\tint offset, boolean isBinary) throws NoModificationAllowedException {\n throw new NoModificationAllowedException(\"Couldn't write to file given its content URI\");\n }\n\t@Override\n\tpublic long truncateFileAtURL(LocalFilesystemURL inputURL, long size)\n\t\t\tthrows NoModificationAllowedException {\n throw new NoModificationAllowedException(\"Couldn't truncate file given its content URI\");\n\t}\n\n\tprotected Cursor openCursorForURL(Uri nativeUri) {\n ContentResolver contentResolver = context.getContentResolver();\n try {\n return contentResolver.query(nativeUri, null, null, null, null);\n } catch (UnsupportedOperationException e) {\n return null;\n }\n\t}\n\n\tprivate Long resourceSizeForCursor(Cursor cursor) {\n int columnIndex = cursor.getColumnIndex(OpenableColumns.SIZE);\n if (columnIndex != -1) {\n String sizeStr = cursor.getString(columnIndex);\n if (sizeStr != null) {\n \treturn Long.parseLong(sizeStr);\n }\n }\n return null;\n\t}\n\t\n\tprotected Long lastModifiedDateForCursor(Cursor cursor) {\n int columnIndex = cursor.getColumnIndex(MediaStore.MediaColumns.DATE_MODIFIED);\n if (columnIndex == -1) {\n columnIndex = cursor.getColumnIndex(DocumentsContract.Document.COLUMN_LAST_MODIFIED);\n }\n if (columnIndex != -1) {\n String dateStr = cursor.getString(columnIndex);\n if (dateStr != null) {\n return Long.parseLong(dateStr);\n }\n }\n return null;\n\t}\n\n @Override\n public String filesystemPathForURL(LocalFilesystemURL url) {\n File f = resourceApi.mapUriToFile(toNativeUri(url));\n return f == null ? null : f.getAbsolutePath();\n }\n\n\t@Override\n\tpublic LocalFilesystemURL URLforFilesystemPath(String path) {\n\t\t// Returns null as we don't support reverse mapping back to content:// URLs\n\t\treturn null;\n\t}\n\n\t@Override\n\tpublic boolean canRemoveFileAtLocalURL(LocalFilesystemURL inputURL) {\n\t\treturn true;\n\t}\n}\n"
},
{
"path": "plugins/cordova-plugin-file/src/android/DirectoryManager.java",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n*/\npackage org.apache.cordova.file;\n\nimport android.os.Environment;\nimport android.os.StatFs;\n\nimport java.io.File;\n\n/**\n * This class provides file directory utilities.\n * All file operations are performed on the SD card.\n *\n * It is used by the FileUtils class.\n */\npublic class DirectoryManager {\n\n @SuppressWarnings(\"unused\")\n private static final String LOG_TAG = \"DirectoryManager\";\n\n /**\n * Determine if a file or directory exists.\n * @param name\t\t\t\tThe name of the file to check.\n * @return\t\t\t\t\tT=exists, F=not found\n */\n public static boolean testFileExists(String name) {\n boolean status;\n\n // If SD card exists\n if ((testSaveLocationExists()) && (!name.equals(\"\"))) {\n File path = Environment.getExternalStorageDirectory();\n File newPath = constructFilePaths(path.toString(), name);\n status = newPath.exists();\n }\n // If no SD card\n else {\n status = false;\n }\n return status;\n }\n\n /**\n * Get the free space in external storage\n *\n * @return \t\tSize in KB or -1 if not available\n */\n public static long getFreeExternalStorageSpace() {\n String status = Environment.getExternalStorageState();\n long freeSpaceInBytes = 0;\n\n // Check if external storage exists\n if (status.equals(Environment.MEDIA_MOUNTED)) {\n freeSpaceInBytes = getFreeSpaceInBytes(Environment.getExternalStorageDirectory().getPath());\n } else {\n // If no external storage then return -1\n return -1;\n }\n\n return freeSpaceInBytes / 1024;\n }\n\n /**\n * Given a path return the number of free bytes in the filesystem containing the path.\n *\n * @param path to the file system\n * @return free space in bytes\n */\n public static long getFreeSpaceInBytes(String path) {\n try {\n StatFs stat = new StatFs(path);\n long blockSize = stat.getBlockSize();\n long availableBlocks = stat.getAvailableBlocks();\n return availableBlocks * blockSize;\n } catch (IllegalArgumentException e) {\n // The path was invalid. Just return 0 free bytes.\n return 0;\n }\n }\n\n /**\n * Determine if SD card exists.\n *\n * @return\t\t\t\tT=exists, F=not found\n */\n public static boolean testSaveLocationExists() {\n String sDCardStatus = Environment.getExternalStorageState();\n boolean status;\n\n // If SD card is mounted\n if (sDCardStatus.equals(Environment.MEDIA_MOUNTED)) {\n status = true;\n }\n\n // If no SD card\n else {\n status = false;\n }\n return status;\n }\n\n /**\n * Create a new file object from two file paths.\n *\n * @param file1\t\t\tBase file path\n * @param file2\t\t\tRemaining file path\n * @return\t\t\t\tFile object\n */\n private static File constructFilePaths (String file1, String file2) {\n File newPath;\n if (file2.startsWith(file1)) {\n newPath = new File(file2);\n }\n else {\n newPath = new File(file1 + \"/\" + file2);\n }\n return newPath;\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-file/src/android/EncodingException.java",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n*/\n\npackage org.apache.cordova.file;\n\n@SuppressWarnings(\"serial\")\npublic class EncodingException extends Exception {\n\n public EncodingException(String message) {\n super(message);\n }\n\n}\n"
},
{
"path": "plugins/cordova-plugin-file/src/android/FileExistsException.java",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n*/\n\npackage org.apache.cordova.file;\n\n@SuppressWarnings(\"serial\")\npublic class FileExistsException extends Exception {\n\n public FileExistsException(String msg) {\n super(msg);\n }\n\n}\n"
},
{
"path": "plugins/cordova-plugin-file/src/android/FileUtils.java",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\npackage org.apache.cordova.file;\n\nimport android.Manifest;\nimport android.app.Activity;\nimport android.content.Context;\nimport android.content.pm.PackageManager;\nimport android.net.Uri;\nimport android.os.Build;\nimport android.os.Environment;\nimport android.util.Base64;\nimport android.util.Log;\n\nimport org.apache.cordova.CallbackContext;\nimport org.apache.cordova.CordovaInterface;\nimport org.apache.cordova.CordovaPlugin;\nimport org.apache.cordova.CordovaWebView;\nimport org.apache.cordova.PermissionHelper;\nimport org.apache.cordova.PluginResult;\n\nimport org.json.JSONArray;\nimport org.json.JSONException;\nimport org.json.JSONObject;\n\nimport java.io.ByteArrayOutputStream;\nimport java.io.File;\nimport java.io.FileNotFoundException;\nimport java.io.IOException;\nimport java.io.InputStream;\nimport java.net.MalformedURLException;\nimport java.security.Permission;\nimport java.util.ArrayList;\nimport java.util.HashMap;\nimport java.util.HashSet;\n\n/**\n * This class provides file and directory services to JavaScript.\n */\npublic class FileUtils extends CordovaPlugin {\n private static final String LOG_TAG = \"FileUtils\";\n\n public static int NOT_FOUND_ERR = 1;\n public static int SECURITY_ERR = 2;\n public static int ABORT_ERR = 3;\n\n public static int NOT_READABLE_ERR = 4;\n public static int ENCODING_ERR = 5;\n public static int NO_MODIFICATION_ALLOWED_ERR = 6;\n public static int INVALID_STATE_ERR = 7;\n public static int SYNTAX_ERR = 8;\n public static int INVALID_MODIFICATION_ERR = 9;\n public static int QUOTA_EXCEEDED_ERR = 10;\n public static int TYPE_MISMATCH_ERR = 11;\n public static int PATH_EXISTS_ERR = 12;\n\n /*\n * Permission callback codes\n */\n\n public static final int ACTION_GET_FILE = 0;\n public static final int ACTION_WRITE = 1;\n public static final int ACTION_GET_DIRECTORY = 2;\n\n public static final int WRITE = 3;\n public static final int READ = 4;\n\n public static int UNKNOWN_ERR = 1000;\n\n private boolean configured = false;\n\n private PendingRequests pendingRequests;\n\n\n\n /*\n * We need both read and write when accessing the storage, I think.\n */\n\n private String [] permissions = {\n Manifest.permission.READ_EXTERNAL_STORAGE,\n Manifest.permission.WRITE_EXTERNAL_STORAGE };\n\n // This field exists only to support getEntry, below, which has been deprecated\n private static FileUtils filePlugin;\n\n private interface FileOp {\n void run(JSONArray args) throws Exception;\n }\n\n private ArrayList filesystems;\n\n public void registerFilesystem(Filesystem fs) {\n \tif (fs != null && filesystemForName(fs.name)== null) {\n \t\tthis.filesystems.add(fs);\n \t}\n }\n\n private Filesystem filesystemForName(String name) {\n \tfor (Filesystem fs:filesystems) {\n \t\tif (fs != null && fs.name != null && fs.name.equals(name)) {\n \t\t\treturn fs;\n \t\t}\n \t}\n \treturn null;\n }\n\n protected String[] getExtraFileSystemsPreference(Activity activity) {\n String fileSystemsStr = preferences.getString(\"androidextrafilesystems\", \"files,files-external,documents,sdcard,cache,cache-external,root\");\n return fileSystemsStr.split(\",\");\n }\n\n protected void registerExtraFileSystems(String[] filesystems, HashMap availableFileSystems) {\n HashSet installedFileSystems = new HashSet();\n\n /* Register filesystems in order */\n for (String fsName : filesystems) {\n if (!installedFileSystems.contains(fsName)) {\n String fsRoot = availableFileSystems.get(fsName);\n if (fsRoot != null) {\n File newRoot = new File(fsRoot);\n if (newRoot.mkdirs() || newRoot.isDirectory()) {\n registerFilesystem(new LocalFilesystem(fsName, webView.getContext(), webView.getResourceApi(), newRoot));\n installedFileSystems.add(fsName);\n } else {\n Log.d(LOG_TAG, \"Unable to create root dir for filesystem \\\"\" + fsName + \"\\\", skipping\");\n }\n } else {\n Log.d(LOG_TAG, \"Unrecognized extra filesystem identifier: \" + fsName);\n }\n }\n }\n }\n\n protected HashMap getAvailableFileSystems(Activity activity) {\n Context context = activity.getApplicationContext();\n HashMap availableFileSystems = new HashMap();\n\n availableFileSystems.put(\"files\", context.getFilesDir().getAbsolutePath());\n availableFileSystems.put(\"documents\", new File(context.getFilesDir(), \"Documents\").getAbsolutePath());\n availableFileSystems.put(\"cache\", context.getCacheDir().getAbsolutePath());\n availableFileSystems.put(\"root\", \"/\");\n if (Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) {\n try {\n availableFileSystems.put(\"files-external\", context.getExternalFilesDir(null).getAbsolutePath());\n availableFileSystems.put(\"sdcard\", Environment.getExternalStorageDirectory().getAbsolutePath());\n availableFileSystems.put(\"cache-external\", context.getExternalCacheDir().getAbsolutePath());\n }\n catch(NullPointerException e) {\n Log.d(LOG_TAG, \"External storage unavailable, check to see if USB Mass Storage Mode is on\");\n }\n }\n\n return availableFileSystems;\n }\n\n @Override\n public void initialize(CordovaInterface cordova, CordovaWebView webView) {\n \tsuper.initialize(cordova, webView);\n \tthis.filesystems = new ArrayList();\n this.pendingRequests = new PendingRequests();\n\n \tString tempRoot = null;\n \tString persistentRoot = null;\n\n \tActivity activity = cordova.getActivity();\n \tString packageName = activity.getPackageName();\n\n String location = preferences.getString(\"androidpersistentfilelocation\", \"internal\");\n\n \ttempRoot = activity.getCacheDir().getAbsolutePath();\n \tif (\"internal\".equalsIgnoreCase(location)) {\n \t\tpersistentRoot = activity.getFilesDir().getAbsolutePath() + \"/files/\";\n \t\tthis.configured = true;\n \t} else if (\"compatibility\".equalsIgnoreCase(location)) {\n \t\t/*\n \t\t * Fall-back to compatibility mode -- this is the logic implemented in\n \t\t * earlier versions of this plugin, and should be maintained here so\n \t\t * that apps which were originally deployed with older versions of the\n \t\t * plugin can continue to provide access to files stored under those\n \t\t * versions.\n \t\t */\n \t\tif (Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) {\n \t\t\tpersistentRoot = Environment.getExternalStorageDirectory().getAbsolutePath();\n \t\t\ttempRoot = Environment.getExternalStorageDirectory().getAbsolutePath() +\n \t\t\t\t\t\"/Android/data/\" + packageName + \"/cache/\";\n \t\t} else {\n \t\t\tpersistentRoot = \"/data/data/\" + packageName;\n \t\t}\n \t\tthis.configured = true;\n \t}\n\n \tif (this.configured) {\n\t\t\t// Create the directories if they don't exist.\n\t\t\tFile tmpRootFile = new File(tempRoot);\n File persistentRootFile = new File(persistentRoot);\n tmpRootFile.mkdirs();\n persistentRootFile.mkdirs();\n\n \t\t// Register initial filesystems\n \t\t// Note: The temporary and persistent filesystems need to be the first two\n \t\t// registered, so that they will match window.TEMPORARY and window.PERSISTENT,\n \t\t// per spec.\n \t\tthis.registerFilesystem(new LocalFilesystem(\"temporary\", webView.getContext(), webView.getResourceApi(), tmpRootFile));\n \t\tthis.registerFilesystem(new LocalFilesystem(\"persistent\", webView.getContext(), webView.getResourceApi(), persistentRootFile));\n \t\tthis.registerFilesystem(new ContentFilesystem(webView.getContext(), webView.getResourceApi()));\n this.registerFilesystem(new AssetFilesystem(webView.getContext().getAssets(), webView.getResourceApi()));\n\n registerExtraFileSystems(getExtraFileSystemsPreference(activity), getAvailableFileSystems(activity));\n\n \t\t// Initialize static plugin reference for deprecated getEntry method\n \t\tif (filePlugin == null) {\n \t\t\tFileUtils.filePlugin = this;\n \t\t}\n \t} else {\n \t\tLog.e(LOG_TAG, \"File plugin configuration error: Please set AndroidPersistentFileLocation in config.xml to one of \\\"internal\\\" (for new applications) or \\\"compatibility\\\" (for compatibility with previous versions)\");\n \t\tactivity.finish();\n \t}\n }\n\n public static FileUtils getFilePlugin() {\n\t\treturn filePlugin;\n\t}\n\n\tprivate Filesystem filesystemForURL(LocalFilesystemURL localURL) {\n \tif (localURL == null) return null;\n \treturn filesystemForName(localURL.fsName);\n }\n\n @Override\n public Uri remapUri(Uri uri) {\n // Remap only cdvfile: URLs (not content:).\n if (!LocalFilesystemURL.FILESYSTEM_PROTOCOL.equals(uri.getScheme())) {\n return null;\n }\n try {\n \tLocalFilesystemURL inputURL = LocalFilesystemURL.parse(uri);\n \tFilesystem fs = this.filesystemForURL(inputURL);\n \tif (fs == null) {\n \t\treturn null;\n \t}\n \tString path = fs.filesystemPathForURL(inputURL);\n \tif (path != null) {\n \t\treturn Uri.parse(\"file://\" + fs.filesystemPathForURL(inputURL));\n \t}\n \treturn null;\n } catch (IllegalArgumentException e) {\n \treturn null;\n }\n }\n\n public boolean execute(String action, final String rawArgs, final CallbackContext callbackContext) {\n if (!configured) {\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.ERROR, \"File plugin is not configured. Please see the README.md file for details on how to update config.xml\"));\n return true;\n }\n if (action.equals(\"testSaveLocationExists\")) {\n threadhelper(new FileOp() {\n public void run(JSONArray args) {\n boolean b = DirectoryManager.testSaveLocationExists();\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, b));\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"getFreeDiskSpace\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) {\n // The getFreeDiskSpace plugin API is not documented, but some apps call it anyway via exec().\n // For compatibility it always returns free space in the primary external storage, and\n // does NOT fallback to internal store if external storage is unavailable.\n long l = DirectoryManager.getFreeExternalStorageSpace();\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, l));\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"testFileExists\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws JSONException {\n String fname=args.getString(0);\n boolean b = DirectoryManager.testFileExists(fname);\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, b));\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"testDirectoryExists\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws JSONException {\n String fname=args.getString(0);\n boolean b = DirectoryManager.testFileExists(fname);\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, b));\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"readAsText\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws JSONException, MalformedURLException {\n String encoding = args.getString(1);\n int start = args.getInt(2);\n int end = args.getInt(3);\n String fname=args.getString(0);\n readFileAs(fname, start, end, callbackContext, encoding, PluginResult.MESSAGE_TYPE_STRING);\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"readAsDataURL\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws JSONException, MalformedURLException {\n int start = args.getInt(1);\n int end = args.getInt(2);\n String fname=args.getString(0);\n readFileAs(fname, start, end, callbackContext, null, -1);\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"readAsArrayBuffer\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws JSONException, MalformedURLException {\n int start = args.getInt(1);\n int end = args.getInt(2);\n String fname=args.getString(0);\n readFileAs(fname, start, end, callbackContext, null, PluginResult.MESSAGE_TYPE_ARRAYBUFFER);\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"readAsBinaryString\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws JSONException, MalformedURLException {\n int start = args.getInt(1);\n int end = args.getInt(2);\n String fname=args.getString(0);\n readFileAs(fname, start, end, callbackContext, null, PluginResult.MESSAGE_TYPE_BINARYSTRING);\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"write\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws JSONException, FileNotFoundException, IOException, NoModificationAllowedException {\n String fname=args.getString(0);\n String nativeURL = resolveLocalFileSystemURI(fname).getString(\"nativeURL\");\n String data=args.getString(1);\n int offset=args.getInt(2);\n Boolean isBinary=args.getBoolean(3);\n\n if(needPermission(nativeURL, WRITE)) {\n getWritePermission(rawArgs, ACTION_WRITE, callbackContext);\n }\n else {\n long fileSize = write(fname, data, offset, isBinary);\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, fileSize));\n }\n\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"truncate\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws JSONException, FileNotFoundException, IOException, NoModificationAllowedException {\n String fname=args.getString(0);\n int offset=args.getInt(1);\n long fileSize = truncateFile(fname, offset);\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, fileSize));\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"requestAllFileSystems\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws IOException, JSONException {\n callbackContext.success(requestAllFileSystems());\n }\n }, rawArgs, callbackContext);\n } else if (action.equals(\"requestAllPaths\")) {\n cordova.getThreadPool().execute(\n new Runnable() {\n public void run() {\n \ttry {\n\t\t\t\t\tcallbackContext.success(requestAllPaths());\n\t\t\t\t} catch (JSONException e) {\n\t\t\t\t\t// TODO Auto-generated catch block\n\t\t\t\t\te.printStackTrace();\n\t\t\t\t}\n }\n }\n );\n } else if (action.equals(\"requestFileSystem\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws JSONException {\n int fstype = args.getInt(0);\n long requiredSize = args.optLong(1);\n requestFileSystem(fstype, requiredSize, callbackContext);\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"resolveLocalFileSystemURI\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws IOException, JSONException {\n String fname=args.getString(0);\n JSONObject obj = resolveLocalFileSystemURI(fname);\n callbackContext.success(obj);\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"getFileMetadata\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws FileNotFoundException, JSONException, MalformedURLException {\n String fname=args.getString(0);\n JSONObject obj = getFileMetadata(fname);\n callbackContext.success(obj);\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"getParent\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws JSONException, IOException {\n String fname=args.getString(0);\n JSONObject obj = getParent(fname);\n callbackContext.success(obj);\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"getDirectory\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws FileExistsException, IOException, TypeMismatchException, EncodingException, JSONException {\n String dirname = args.getString(0);\n String path = args.getString(1);\n String nativeURL = resolveLocalFileSystemURI(dirname).getString(\"nativeURL\");\n boolean containsCreate = (args.isNull(2)) ? false : args.getJSONObject(2).optBoolean(\"create\", false);\n\n if(containsCreate && needPermission(nativeURL, WRITE)) {\n getWritePermission(rawArgs, ACTION_GET_DIRECTORY, callbackContext);\n }\n else if(!containsCreate && needPermission(nativeURL, READ)) {\n getReadPermission(rawArgs, ACTION_GET_DIRECTORY, callbackContext);\n }\n else {\n JSONObject obj = getFile(dirname, path, args.optJSONObject(2), true);\n callbackContext.success(obj);\n }\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"getFile\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws FileExistsException, IOException, TypeMismatchException, EncodingException, JSONException {\n String dirname = args.getString(0);\n String path = args.getString(1);\n String nativeURL = resolveLocalFileSystemURI(dirname).getString(\"nativeURL\");\n boolean containsCreate = (args.isNull(2)) ? false : args.getJSONObject(2).optBoolean(\"create\", false);\n\n if(containsCreate && needPermission(nativeURL, WRITE)) {\n getWritePermission(rawArgs, ACTION_GET_FILE, callbackContext);\n }\n else if(!containsCreate && needPermission(nativeURL, READ)) {\n getReadPermission(rawArgs, ACTION_GET_FILE, callbackContext);\n }\n else {\n JSONObject obj = getFile(dirname, path, args.optJSONObject(2), false);\n callbackContext.success(obj);\n }\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"remove\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws JSONException, NoModificationAllowedException, InvalidModificationException, MalformedURLException {\n String fname=args.getString(0);\n boolean success = remove(fname);\n if (success) {\n callbackContext.success();\n } else {\n callbackContext.error(FileUtils.NO_MODIFICATION_ALLOWED_ERR);\n }\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"removeRecursively\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws JSONException, FileExistsException, MalformedURLException, NoModificationAllowedException {\n String fname=args.getString(0);\n boolean success = removeRecursively(fname);\n if (success) {\n callbackContext.success();\n } else {\n callbackContext.error(FileUtils.NO_MODIFICATION_ALLOWED_ERR);\n }\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"moveTo\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws JSONException, NoModificationAllowedException, IOException, InvalidModificationException, EncodingException, FileExistsException {\n String fname=args.getString(0);\n String newParent=args.getString(1);\n String newName=args.getString(2);\n JSONObject entry = transferTo(fname, newParent, newName, true);\n callbackContext.success(entry);\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"copyTo\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws JSONException, NoModificationAllowedException, IOException, InvalidModificationException, EncodingException, FileExistsException {\n String fname=args.getString(0);\n String newParent=args.getString(1);\n String newName=args.getString(2);\n JSONObject entry = transferTo(fname, newParent, newName, false);\n callbackContext.success(entry);\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"readEntries\")) {\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws FileNotFoundException, JSONException, MalformedURLException {\n String fname=args.getString(0);\n JSONArray entries = readEntries(fname);\n callbackContext.success(entries);\n }\n }, rawArgs, callbackContext);\n }\n else if (action.equals(\"_getLocalFilesystemPath\")) {\n // Internal method for testing: Get the on-disk location of a local filesystem url.\n // [Currently used for testing file-transfer]\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws FileNotFoundException, JSONException, MalformedURLException {\n String localURLstr = args.getString(0);\n String fname = filesystemPathForURL(localURLstr);\n callbackContext.success(fname);\n }\n }, rawArgs, callbackContext);\n }\n else {\n return false;\n }\n return true;\n }\n\n private void getReadPermission(String rawArgs, int action, CallbackContext callbackContext) {\n int requestCode = pendingRequests.createRequest(rawArgs, action, callbackContext);\n PermissionHelper.requestPermission(this, requestCode, Manifest.permission.READ_EXTERNAL_STORAGE);\n }\n\n private void getWritePermission(String rawArgs, int action, CallbackContext callbackContext) {\n int requestCode = pendingRequests.createRequest(rawArgs, action, callbackContext);\n PermissionHelper.requestPermission(this, requestCode, Manifest.permission.WRITE_EXTERNAL_STORAGE);\n }\n\n private boolean hasReadPermission() {\n return PermissionHelper.hasPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE);\n }\n\n private boolean hasWritePermission() {\n return PermissionHelper.hasPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE);\n }\n\n private boolean needPermission(String nativeURL, int permissionType) throws JSONException {\n JSONObject j = requestAllPaths();\n String[] allowedStorageDirectories = {j.getString(\"applicationStorageDirectory\"), j.getString(\"externalApplicationStorageDirectory\")};\n\n if(permissionType == READ && hasReadPermission()) {\n return false;\n }\n else if(permissionType == WRITE && hasWritePermission()) {\n return false;\n }\n\n // Permission required if the native url lies outside the allowed storage directories\n for(String directory : allowedStorageDirectories) {\n if(nativeURL.startsWith(directory)) {\n return false;\n }\n }\n return true;\n }\n\n\n public LocalFilesystemURL resolveNativeUri(Uri nativeUri) {\n LocalFilesystemURL localURL = null;\n\n // Try all installed filesystems. Return the best matching URL\n // (determined by the shortest resulting URL)\n for (Filesystem fs : filesystems) {\n LocalFilesystemURL url = fs.toLocalUri(nativeUri);\n if (url != null) {\n // A shorter fullPath implies that the filesystem is a better\n // match for the local path than the previous best.\n if (localURL == null || (url.uri.toString().length() < localURL.toString().length())) {\n localURL = url;\n }\n }\n }\n return localURL;\n }\n\n /*\n * These two native-only methods can be used by other plugins to translate between\n * device file system paths and URLs. By design, there is no direct JavaScript\n * interface to these methods.\n */\n\n public String filesystemPathForURL(String localURLstr) throws MalformedURLException {\n try {\n LocalFilesystemURL inputURL = LocalFilesystemURL.parse(localURLstr);\n Filesystem fs = this.filesystemForURL(inputURL);\n if (fs == null) {\n throw new MalformedURLException(\"No installed handlers for this URL\");\n }\n return fs.filesystemPathForURL(inputURL);\n } catch (IllegalArgumentException e) {\n throw new MalformedURLException(\"Unrecognized filesystem URL\");\n }\n }\n\n public LocalFilesystemURL filesystemURLforLocalPath(String localPath) {\n LocalFilesystemURL localURL = null;\n int shortestFullPath = 0;\n\n // Try all installed filesystems. Return the best matching URL\n // (determined by the shortest resulting URL)\n for (Filesystem fs: filesystems) {\n LocalFilesystemURL url = fs.URLforFilesystemPath(localPath);\n if (url != null) {\n // A shorter fullPath implies that the filesystem is a better\n // match for the local path than the previous best.\n if (localURL == null || (url.path.length() < shortestFullPath)) {\n localURL = url;\n shortestFullPath = url.path.length();\n }\n }\n }\n return localURL;\n }\n\n\n\t/* helper to execute functions async and handle the result codes\n *\n */\n private void threadhelper(final FileOp f, final String rawArgs, final CallbackContext callbackContext){\n cordova.getThreadPool().execute(new Runnable() {\n public void run() {\n try {\n JSONArray args = new JSONArray(rawArgs);\n f.run(args);\n } catch ( Exception e) {\n if( e instanceof EncodingException){\n callbackContext.error(FileUtils.ENCODING_ERR);\n } else if(e instanceof FileNotFoundException) {\n callbackContext.error(FileUtils.NOT_FOUND_ERR);\n } else if(e instanceof FileExistsException) {\n callbackContext.error(FileUtils.PATH_EXISTS_ERR);\n } else if(e instanceof NoModificationAllowedException ) {\n callbackContext.error(FileUtils.NO_MODIFICATION_ALLOWED_ERR);\n } else if(e instanceof InvalidModificationException ) {\n callbackContext.error(FileUtils.INVALID_MODIFICATION_ERR);\n } else if(e instanceof MalformedURLException ) {\n callbackContext.error(FileUtils.ENCODING_ERR);\n } else if(e instanceof IOException ) {\n callbackContext.error(FileUtils.INVALID_MODIFICATION_ERR);\n } else if(e instanceof EncodingException ) {\n callbackContext.error(FileUtils.ENCODING_ERR);\n } else if(e instanceof TypeMismatchException ) {\n callbackContext.error(FileUtils.TYPE_MISMATCH_ERR);\n } else if(e instanceof JSONException ) {\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.JSON_EXCEPTION));\n } else {\n e.printStackTrace();\n \tcallbackContext.error(FileUtils.UNKNOWN_ERR);\n }\n }\n }\n });\n }\n\n /**\n * Allows the user to look up the Entry for a file or directory referred to by a local URI.\n *\n * @param uriString of the file/directory to look up\n * @return a JSONObject representing a Entry from the filesystem\n * @throws MalformedURLException if the url is not valid\n * @throws FileNotFoundException if the file does not exist\n * @throws IOException if the user can't read the file\n * @throws JSONException\n */\n private JSONObject resolveLocalFileSystemURI(String uriString) throws IOException, JSONException {\n if (uriString == null) {\n throw new MalformedURLException(\"Unrecognized filesystem URL\");\n }\n Uri uri = Uri.parse(uriString);\n boolean isNativeUri = false;\n\n LocalFilesystemURL inputURL = LocalFilesystemURL.parse(uri);\n if (inputURL == null) {\n /* Check for file://, content:// urls */\n inputURL = resolveNativeUri(uri);\n isNativeUri = true;\n }\n\n try {\n Filesystem fs = this.filesystemForURL(inputURL);\n if (fs == null) {\n throw new MalformedURLException(\"No installed handlers for this URL\");\n }\n if (fs.exists(inputURL)) {\n if (!isNativeUri) {\n // If not already resolved as native URI, resolve to a native URI and back to\n // fix the terminating slash based on whether the entry is a directory or file.\n inputURL = fs.toLocalUri(fs.toNativeUri(inputURL));\n }\n\n return fs.getEntryForLocalURL(inputURL);\n }\n } catch (IllegalArgumentException e) {\n throw new MalformedURLException(\"Unrecognized filesystem URL\");\n }\n throw new FileNotFoundException();\n }\n\n /**\n * Read the list of files from this directory.\n *\n * @return a JSONArray containing JSONObjects that represent Entry objects.\n * @throws FileNotFoundException if the directory is not found.\n * @throws JSONException\n * @throws MalformedURLException\n */\n private JSONArray readEntries(String baseURLstr) throws FileNotFoundException, JSONException, MalformedURLException {\n try {\n \tLocalFilesystemURL inputURL = LocalFilesystemURL.parse(baseURLstr);\n \tFilesystem fs = this.filesystemForURL(inputURL);\n \tif (fs == null) {\n \t\tthrow new MalformedURLException(\"No installed handlers for this URL\");\n \t}\n \treturn fs.readEntriesAtLocalURL(inputURL);\n\n } catch (IllegalArgumentException e) {\n \tthrow new MalformedURLException(\"Unrecognized filesystem URL\");\n }\n }\n\n /**\n * A setup method that handles the move/copy of files/directories\n *\n * @param newName for the file directory to be called, if null use existing file name\n * @param move if false do a copy, if true do a move\n * @return a Entry object\n * @throws NoModificationAllowedException\n * @throws IOException\n * @throws InvalidModificationException\n * @throws EncodingException\n * @throws JSONException\n * @throws FileExistsException\n */\n private JSONObject transferTo(String srcURLstr, String destURLstr, String newName, boolean move) throws JSONException, NoModificationAllowedException, IOException, InvalidModificationException, EncodingException, FileExistsException {\n if (srcURLstr == null || destURLstr == null) {\n // either no source or no destination provided\n \tthrow new FileNotFoundException();\n }\n\n LocalFilesystemURL srcURL = LocalFilesystemURL.parse(srcURLstr);\n LocalFilesystemURL destURL = LocalFilesystemURL.parse(destURLstr);\n\n Filesystem srcFs = this.filesystemForURL(srcURL);\n Filesystem destFs = this.filesystemForURL(destURL);\n\n // Check for invalid file name\n if (newName != null && newName.contains(\":\")) {\n throw new EncodingException(\"Bad file name\");\n }\n\n return destFs.copyFileToURL(destURL, newName, srcFs, srcURL, move);\n }\n\n /**\n * Deletes a directory and all of its contents, if any. In the event of an error\n * [e.g. trying to delete a directory that contains a file that cannot be removed],\n * some of the contents of the directory may be deleted.\n * It is an error to attempt to delete the root directory of a filesystem.\n *\n * @return a boolean representing success of failure\n * @throws FileExistsException\n * @throws NoModificationAllowedException\n * @throws MalformedURLException\n */\n private boolean removeRecursively(String baseURLstr) throws FileExistsException, NoModificationAllowedException, MalformedURLException {\n try {\n \tLocalFilesystemURL inputURL = LocalFilesystemURL.parse(baseURLstr);\n \t// You can't delete the root directory.\n \tif (\"\".equals(inputURL.path) || \"/\".equals(inputURL.path)) {\n \t\tthrow new NoModificationAllowedException(\"You can't delete the root directory\");\n \t}\n\n \tFilesystem fs = this.filesystemForURL(inputURL);\n \tif (fs == null) {\n \t\tthrow new MalformedURLException(\"No installed handlers for this URL\");\n \t}\n \treturn fs.recursiveRemoveFileAtLocalURL(inputURL);\n\n } catch (IllegalArgumentException e) {\n \tthrow new MalformedURLException(\"Unrecognized filesystem URL\");\n }\n }\n\n\n /**\n * Deletes a file or directory. It is an error to attempt to delete a directory that is not empty.\n * It is an error to attempt to delete the root directory of a filesystem.\n *\n * @return a boolean representing success of failure\n * @throws NoModificationAllowedException\n * @throws InvalidModificationException\n * @throws MalformedURLException\n */\n private boolean remove(String baseURLstr) throws NoModificationAllowedException, InvalidModificationException, MalformedURLException {\n try {\n \tLocalFilesystemURL inputURL = LocalFilesystemURL.parse(baseURLstr);\n \t// You can't delete the root directory.\n \tif (\"\".equals(inputURL.path) || \"/\".equals(inputURL.path)) {\n\n \t\tthrow new NoModificationAllowedException(\"You can't delete the root directory\");\n \t}\n\n \tFilesystem fs = this.filesystemForURL(inputURL);\n \tif (fs == null) {\n \t\tthrow new MalformedURLException(\"No installed handlers for this URL\");\n \t}\n \treturn fs.removeFileAtLocalURL(inputURL);\n\n } catch (IllegalArgumentException e) {\n \tthrow new MalformedURLException(\"Unrecognized filesystem URL\");\n }\n }\n\n /**\n * Creates or looks up a file.\n *\n * @param baseURLstr base directory\n * @param path file/directory to lookup or create\n * @param options specify whether to create or not\n * @param directory if true look up directory, if false look up file\n * @return a Entry object\n * @throws FileExistsException\n * @throws IOException\n * @throws TypeMismatchException\n * @throws EncodingException\n * @throws JSONException\n */\n private JSONObject getFile(String baseURLstr, String path, JSONObject options, boolean directory) throws FileExistsException, IOException, TypeMismatchException, EncodingException, JSONException {\n try {\n \tLocalFilesystemURL inputURL = LocalFilesystemURL.parse(baseURLstr);\n \tFilesystem fs = this.filesystemForURL(inputURL);\n \tif (fs == null) {\n \t\tthrow new MalformedURLException(\"No installed handlers for this URL\");\n \t}\n \treturn fs.getFileForLocalURL(inputURL, path, options, directory);\n\n } catch (IllegalArgumentException e) {\n \tthrow new MalformedURLException(\"Unrecognized filesystem URL\");\n }\n\n }\n\n /**\n * Look up the parent DirectoryEntry containing this Entry.\n * If this Entry is the root of its filesystem, its parent is itself.\n */\n private JSONObject getParent(String baseURLstr) throws JSONException, IOException {\n try {\n \tLocalFilesystemURL inputURL = LocalFilesystemURL.parse(baseURLstr);\n \tFilesystem fs = this.filesystemForURL(inputURL);\n \tif (fs == null) {\n \t\tthrow new MalformedURLException(\"No installed handlers for this URL\");\n \t}\n \treturn fs.getParentForLocalURL(inputURL);\n\n } catch (IllegalArgumentException e) {\n \tthrow new MalformedURLException(\"Unrecognized filesystem URL\");\n }\n }\n\n /**\n * Returns a File that represents the current state of the file that this FileEntry represents.\n *\n * @return returns a JSONObject represent a W3C File object\n */\n private JSONObject getFileMetadata(String baseURLstr) throws FileNotFoundException, JSONException, MalformedURLException {\n try {\n \tLocalFilesystemURL inputURL = LocalFilesystemURL.parse(baseURLstr);\n \tFilesystem fs = this.filesystemForURL(inputURL);\n \tif (fs == null) {\n \t\tthrow new MalformedURLException(\"No installed handlers for this URL\");\n \t}\n \treturn fs.getFileMetadataForLocalURL(inputURL);\n\n } catch (IllegalArgumentException e) {\n \tthrow new MalformedURLException(\"Unrecognized filesystem URL\");\n }\n }\n\n /**\n * Requests a filesystem in which to store application data.\n *\n * @param type of file system requested\n * @param requiredSize required free space in the file system in bytes\n * @param callbackContext context for returning the result or error\n * @throws JSONException\n */\n private void requestFileSystem(int type, long requiredSize, final CallbackContext callbackContext) throws JSONException {\n Filesystem rootFs = null;\n try {\n rootFs = this.filesystems.get(type);\n } catch (ArrayIndexOutOfBoundsException e) {\n // Pass null through\n }\n if (rootFs == null) {\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.ERROR, FileUtils.NOT_FOUND_ERR));\n } else {\n // If a nonzero required size was specified, check that the retrieved filesystem has enough free space.\n long availableSize = 0;\n if (requiredSize > 0) {\n availableSize = rootFs.getFreeSpaceInBytes();\n }\n\n if (availableSize < requiredSize) {\n callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.ERROR, FileUtils.QUOTA_EXCEEDED_ERR));\n } else {\n JSONObject fs = new JSONObject();\n fs.put(\"name\", rootFs.name);\n fs.put(\"root\", rootFs.getRootEntry());\n callbackContext.success(fs);\n }\n }\n }\n\n /**\n * Requests a filesystem in which to store application data.\n *\n * @return a JSONObject representing the file system\n */\n private JSONArray requestAllFileSystems() throws IOException, JSONException {\n JSONArray ret = new JSONArray();\n for (Filesystem fs : filesystems) {\n ret.put(fs.getRootEntry());\n }\n return ret;\n }\n\n private static String toDirUrl(File f) {\n return Uri.fromFile(f).toString() + '/';\n }\n\n private JSONObject requestAllPaths() throws JSONException {\n Context context = cordova.getActivity();\n JSONObject ret = new JSONObject();\n ret.put(\"applicationDirectory\", \"file:///android_asset/\");\n ret.put(\"applicationStorageDirectory\", toDirUrl(context.getFilesDir().getParentFile()));\n ret.put(\"dataDirectory\", toDirUrl(context.getFilesDir()));\n ret.put(\"cacheDirectory\", toDirUrl(context.getCacheDir()));\n if (Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) {\n try {\n ret.put(\"externalApplicationStorageDirectory\", toDirUrl(context.getExternalFilesDir(null).getParentFile()));\n ret.put(\"externalDataDirectory\", toDirUrl(context.getExternalFilesDir(null)));\n ret.put(\"externalCacheDirectory\", toDirUrl(context.getExternalCacheDir()));\n ret.put(\"externalRootDirectory\", toDirUrl(Environment.getExternalStorageDirectory()));\n }\n catch(NullPointerException e) {\n /* If external storage is unavailable, context.getExternal* returns null */\n Log.d(LOG_TAG, \"Unable to access these paths, most liklely due to USB storage\");\n }\n }\n return ret;\n }\n\n /**\n * Returns a JSON object representing the given File. Internal APIs should be modified\n * to use URLs instead of raw FS paths wherever possible, when interfacing with this plugin.\n *\n * @param file the File to convert\n * @return a JSON representation of the given File\n * @throws JSONException\n */\n public JSONObject getEntryForFile(File file) throws JSONException {\n JSONObject entry;\n\n for (Filesystem fs : filesystems) {\n entry = fs.makeEntryForFile(file);\n if (entry != null) {\n return entry;\n }\n }\n return null;\n }\n\n /**\n * Returns a JSON object representing the given File. Deprecated, as this is only used by\n * FileTransfer, and because it is a static method that should really be an instance method,\n * since it depends on the actual filesystem roots in use. Internal APIs should be modified\n * to use URLs instead of raw FS paths wherever possible, when interfacing with this plugin.\n *\n * @param file the File to convert\n * @return a JSON representation of the given File\n * @throws JSONException\n */\n @Deprecated\n public static JSONObject getEntry(File file) throws JSONException {\n \t\tif (getFilePlugin() != null) {\n return getFilePlugin().getEntryForFile(file);\n\t\t}\n\t\treturn null;\n }\n\n /**\n * Read the contents of a file.\n * This is done in a background thread; the result is sent to the callback.\n *\n * @param start Start position in the file.\n * @param end End position to stop at (exclusive).\n * @param callbackContext The context through which to send the result.\n * @param encoding The encoding to return contents as. Typical value is UTF-8. (see http://www.iana.org/assignments/character-sets)\n * @param resultType The desired type of data to send to the callback.\n * @return Contents of file.\n */\n public void readFileAs(final String srcURLstr, final int start, final int end, final CallbackContext callbackContext, final String encoding, final int resultType) throws MalformedURLException {\n try {\n \tLocalFilesystemURL inputURL = LocalFilesystemURL.parse(srcURLstr);\n \tFilesystem fs = this.filesystemForURL(inputURL);\n \tif (fs == null) {\n \t\tthrow new MalformedURLException(\"No installed handlers for this URL\");\n \t}\n\n fs.readFileAtURL(inputURL, start, end, new Filesystem.ReadFileCallback() {\n public void handleData(InputStream inputStream, String contentType) {\n \t\ttry {\n ByteArrayOutputStream os = new ByteArrayOutputStream();\n final int BUFFER_SIZE = 8192;\n byte[] buffer = new byte[BUFFER_SIZE];\n\n for (;;) {\n int bytesRead = inputStream.read(buffer, 0, BUFFER_SIZE);\n\n if (bytesRead <= 0) {\n break;\n }\n os.write(buffer, 0, bytesRead);\n }\n\n \t\t\tPluginResult result;\n \t\t\tswitch (resultType) {\n \t\t\tcase PluginResult.MESSAGE_TYPE_STRING:\n result = new PluginResult(PluginResult.Status.OK, os.toString(encoding));\n \t\t\t\tbreak;\n \t\t\tcase PluginResult.MESSAGE_TYPE_ARRAYBUFFER:\n result = new PluginResult(PluginResult.Status.OK, os.toByteArray());\n \t\t\t\tbreak;\n \t\t\tcase PluginResult.MESSAGE_TYPE_BINARYSTRING:\n result = new PluginResult(PluginResult.Status.OK, os.toByteArray(), true);\n \t\t\t\tbreak;\n \t\t\tdefault: // Base64.\n byte[] base64 = Base64.encode(os.toByteArray(), Base64.NO_WRAP);\n \t\t\tString s = \"data:\" + contentType + \";base64,\" + new String(base64, \"US-ASCII\");\n \t\t\tresult = new PluginResult(PluginResult.Status.OK, s);\n \t\t\t}\n\n \t\t\tcallbackContext.sendPluginResult(result);\n \t\t} catch (IOException e) {\n \t\t\tLog.d(LOG_TAG, e.getLocalizedMessage());\n \t\t\tcallbackContext.sendPluginResult(new PluginResult(PluginResult.Status.IO_EXCEPTION, NOT_READABLE_ERR));\n }\n \t}\n });\n\n\n } catch (IllegalArgumentException e) {\n \tthrow new MalformedURLException(\"Unrecognized filesystem URL\");\n } catch (FileNotFoundException e) {\n \tcallbackContext.sendPluginResult(new PluginResult(PluginResult.Status.IO_EXCEPTION, NOT_FOUND_ERR));\n } catch (IOException e) {\n \tLog.d(LOG_TAG, e.getLocalizedMessage());\n \tcallbackContext.sendPluginResult(new PluginResult(PluginResult.Status.IO_EXCEPTION, NOT_READABLE_ERR));\n }\n }\n\n\n /**\n * Write contents of file.\n *\n * @param data\t\t\t\tThe contents of the file.\n * @param offset\t\t\tThe position to begin writing the file.\n * @param isBinary True if the file contents are base64-encoded binary data\n */\n /**/\n public long write(String srcURLstr, String data, int offset, boolean isBinary) throws FileNotFoundException, IOException, NoModificationAllowedException {\n try {\n \tLocalFilesystemURL inputURL = LocalFilesystemURL.parse(srcURLstr);\n \tFilesystem fs = this.filesystemForURL(inputURL);\n \tif (fs == null) {\n \t\tthrow new MalformedURLException(\"No installed handlers for this URL\");\n \t}\n\n long x = fs.writeToFileAtURL(inputURL, data, offset, isBinary); Log.d(\"TEST\",srcURLstr + \": \"+x); return x;\n } catch (IllegalArgumentException e) {\n \tthrow new MalformedURLException(\"Unrecognized filesystem URL\");\n }\n\n }\n\n /**\n * Truncate the file to size\n */\n private long truncateFile(String srcURLstr, long size) throws FileNotFoundException, IOException, NoModificationAllowedException {\n try {\n \tLocalFilesystemURL inputURL = LocalFilesystemURL.parse(srcURLstr);\n \tFilesystem fs = this.filesystemForURL(inputURL);\n \tif (fs == null) {\n \t\tthrow new MalformedURLException(\"No installed handlers for this URL\");\n \t}\n\n return fs.truncateFileAtURL(inputURL, size);\n } catch (IllegalArgumentException e) {\n \tthrow new MalformedURLException(\"Unrecognized filesystem URL\");\n }\n }\n\n\n /*\n * Handle the response\n */\n\n public void onRequestPermissionResult(int requestCode, String[] permissions,\n int[] grantResults) throws JSONException {\n\n final PendingRequests.Request req = pendingRequests.getAndRemove(requestCode);\n if (req != null) {\n for(int r:grantResults)\n {\n if(r == PackageManager.PERMISSION_DENIED)\n {\n req.getCallbackContext().sendPluginResult(new PluginResult(PluginResult.Status.ERROR, SECURITY_ERR));\n return;\n }\n }\n switch(req.getAction())\n {\n case ACTION_GET_FILE:\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws FileExistsException, IOException, TypeMismatchException, EncodingException, JSONException {\n String dirname = args.getString(0);\n\n String path = args.getString(1);\n JSONObject obj = getFile(dirname, path, args.optJSONObject(2), false);\n req.getCallbackContext().success(obj);\n }\n }, req.getRawArgs(), req.getCallbackContext());\n break;\n case ACTION_GET_DIRECTORY:\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws FileExistsException, IOException, TypeMismatchException, EncodingException, JSONException {\n String dirname = args.getString(0);\n\n String path = args.getString(1);\n JSONObject obj = getFile(dirname, path, args.optJSONObject(2), true);\n req.getCallbackContext().success(obj);\n }\n }, req.getRawArgs(), req.getCallbackContext());\n break;\n case ACTION_WRITE:\n threadhelper( new FileOp( ){\n public void run(JSONArray args) throws JSONException, FileNotFoundException, IOException, NoModificationAllowedException {\n String fname=args.getString(0);\n String data=args.getString(1);\n int offset=args.getInt(2);\n Boolean isBinary=args.getBoolean(3);\n long fileSize = write(fname, data, offset, isBinary);\n req.getCallbackContext().sendPluginResult(new PluginResult(PluginResult.Status.OK, fileSize));\n }\n }, req.getRawArgs(), req.getCallbackContext());\n break;\n }\n } else {\n Log.d(LOG_TAG, \"Received permission callback for unknown request code\");\n }\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-file/src/android/Filesystem.java",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\npackage org.apache.cordova.file;\n\nimport android.net.Uri;\n\nimport java.io.File;\nimport java.io.FileNotFoundException;\nimport java.io.FilterInputStream;\nimport java.io.IOException;\nimport java.io.InputStream;\nimport java.io.OutputStream;\nimport java.util.ArrayList;\nimport java.util.Arrays;\n\nimport org.apache.cordova.CordovaResourceApi;\nimport org.json.JSONArray;\nimport org.json.JSONException;\nimport org.json.JSONObject;\n\npublic abstract class Filesystem {\n\n protected final Uri rootUri;\n protected final CordovaResourceApi resourceApi;\n public final String name;\n private JSONObject rootEntry;\n\n public Filesystem(Uri rootUri, String name, CordovaResourceApi resourceApi) {\n this.rootUri = rootUri;\n this.name = name;\n this.resourceApi = resourceApi;\n }\n\n public interface ReadFileCallback {\n\t\tpublic void handleData(InputStream inputStream, String contentType) throws IOException;\n\t}\n\n public static JSONObject makeEntryForURL(LocalFilesystemURL inputURL, Uri nativeURL) {\n try {\n String path = inputURL.path;\n int end = path.endsWith(\"/\") ? 1 : 0;\n String[] parts = path.substring(0, path.length() - end).split(\"/+\");\n String fileName = parts[parts.length - 1];\n\n JSONObject entry = new JSONObject();\n entry.put(\"isFile\", !inputURL.isDirectory);\n entry.put(\"isDirectory\", inputURL.isDirectory);\n entry.put(\"name\", fileName);\n entry.put(\"fullPath\", path);\n // The file system can't be specified, as it would lead to an infinite loop,\n // but the filesystem name can be.\n entry.put(\"filesystemName\", inputURL.fsName);\n // Backwards compatibility\n entry.put(\"filesystem\", \"temporary\".equals(inputURL.fsName) ? 0 : 1);\n\n String nativeUrlStr = nativeURL.toString();\n if (inputURL.isDirectory && !nativeUrlStr.endsWith(\"/\")) {\n nativeUrlStr += \"/\";\n }\n entry.put(\"nativeURL\", nativeUrlStr);\n return entry;\n } catch (JSONException e) {\n e.printStackTrace();\n throw new RuntimeException(e);\n }\n }\n\n public JSONObject makeEntryForURL(LocalFilesystemURL inputURL) {\n Uri nativeUri = toNativeUri(inputURL);\n return nativeUri == null ? null : makeEntryForURL(inputURL, nativeUri);\n }\n\n public JSONObject makeEntryForNativeUri(Uri nativeUri) {\n LocalFilesystemURL inputUrl = toLocalUri(nativeUri);\n return inputUrl == null ? null : makeEntryForURL(inputUrl, nativeUri);\n }\n\n public JSONObject getEntryForLocalURL(LocalFilesystemURL inputURL) throws IOException {\n return makeEntryForURL(inputURL);\n }\n\n public JSONObject makeEntryForFile(File file) {\n return makeEntryForNativeUri(Uri.fromFile(file));\n }\n\n abstract JSONObject getFileForLocalURL(LocalFilesystemURL inputURL, String path,\n\t\t\tJSONObject options, boolean directory) throws FileExistsException, IOException, TypeMismatchException, EncodingException, JSONException;\n\n\tabstract boolean removeFileAtLocalURL(LocalFilesystemURL inputURL) throws InvalidModificationException, NoModificationAllowedException;\n\n\tabstract boolean recursiveRemoveFileAtLocalURL(LocalFilesystemURL inputURL) throws FileExistsException, NoModificationAllowedException;\n\n\tabstract LocalFilesystemURL[] listChildren(LocalFilesystemURL inputURL) throws FileNotFoundException;\n\n public final JSONArray readEntriesAtLocalURL(LocalFilesystemURL inputURL) throws FileNotFoundException {\n LocalFilesystemURL[] children = listChildren(inputURL);\n JSONArray entries = new JSONArray();\n if (children != null) {\n for (LocalFilesystemURL url : children) {\n entries.put(makeEntryForURL(url));\n }\n }\n return entries;\n }\n\n\tabstract JSONObject getFileMetadataForLocalURL(LocalFilesystemURL inputURL) throws FileNotFoundException;\n\n public Uri getRootUri() {\n return rootUri;\n }\n\n public boolean exists(LocalFilesystemURL inputURL) {\n try {\n getFileMetadataForLocalURL(inputURL);\n } catch (FileNotFoundException e) {\n return false;\n }\n return true;\n }\n\n public Uri nativeUriForFullPath(String fullPath) {\n Uri ret = null;\n if (fullPath != null) {\n String encodedPath = Uri.fromFile(new File(fullPath)).getEncodedPath();\n if (encodedPath.startsWith(\"/\")) {\n encodedPath = encodedPath.substring(1);\n }\n ret = rootUri.buildUpon().appendEncodedPath(encodedPath).build();\n }\n return ret;\n }\n\n public LocalFilesystemURL localUrlforFullPath(String fullPath) {\n Uri nativeUri = nativeUriForFullPath(fullPath);\n if (nativeUri != null) {\n return toLocalUri(nativeUri);\n }\n return null;\n }\n\n /**\n * Removes multiple repeated //s, and collapses processes ../s.\n */\n protected static String normalizePath(String rawPath) {\n // If this is an absolute path, trim the leading \"/\" and replace it later\n boolean isAbsolutePath = rawPath.startsWith(\"/\");\n if (isAbsolutePath) {\n rawPath = rawPath.replaceFirst(\"/+\", \"\");\n }\n ArrayList components = new ArrayList(Arrays.asList(rawPath.split(\"/+\")));\n for (int index = 0; index < components.size(); ++index) {\n if (components.get(index).equals(\"..\")) {\n components.remove(index);\n if (index > 0) {\n components.remove(index-1);\n --index;\n }\n }\n }\n StringBuilder normalizedPath = new StringBuilder();\n for(String component: components) {\n normalizedPath.append(\"/\");\n normalizedPath.append(component);\n }\n if (isAbsolutePath) {\n return normalizedPath.toString();\n } else {\n return normalizedPath.toString().substring(1);\n }\n }\n\n /**\n * Gets the free space in bytes available on this filesystem.\n * Subclasses may override this method to return nonzero free space.\n */\n public long getFreeSpaceInBytes() {\n return 0;\n }\n\n public abstract Uri toNativeUri(LocalFilesystemURL inputURL);\n public abstract LocalFilesystemURL toLocalUri(Uri inputURL);\n\n public JSONObject getRootEntry() {\n if (rootEntry == null) {\n rootEntry = makeEntryForNativeUri(rootUri);\n }\n return rootEntry;\n }\n\n\tpublic JSONObject getParentForLocalURL(LocalFilesystemURL inputURL) throws IOException {\n Uri parentUri = inputURL.uri;\n String parentPath = new File(inputURL.uri.getPath()).getParent();\n if (!\"/\".equals(parentPath)) {\n parentUri = inputURL.uri.buildUpon().path(parentPath + '/').build();\n\t\t}\n\t\treturn getEntryForLocalURL(LocalFilesystemURL.parse(parentUri));\n\t}\n\n protected LocalFilesystemURL makeDestinationURL(String newName, LocalFilesystemURL srcURL, LocalFilesystemURL destURL, boolean isDirectory) {\n // I know this looks weird but it is to work around a JSON bug.\n if (\"null\".equals(newName) || \"\".equals(newName)) {\n newName = srcURL.uri.getLastPathSegment();;\n }\n\n String newDest = destURL.uri.toString();\n if (newDest.endsWith(\"/\")) {\n newDest = newDest + newName;\n } else {\n newDest = newDest + \"/\" + newName;\n }\n if (isDirectory) {\n newDest += '/';\n }\n return LocalFilesystemURL.parse(newDest);\n }\n\n\t/* Read a source URL (possibly from a different filesystem, srcFs,) and copy it to\n\t * the destination URL on this filesystem, optionally with a new filename.\n\t * If move is true, then this method should either perform an atomic move operation\n\t * or remove the source file when finished.\n\t */\n public JSONObject copyFileToURL(LocalFilesystemURL destURL, String newName,\n Filesystem srcFs, LocalFilesystemURL srcURL, boolean move) throws IOException, InvalidModificationException, JSONException, NoModificationAllowedException, FileExistsException {\n // First, check to see that we can do it\n if (move && !srcFs.canRemoveFileAtLocalURL(srcURL)) {\n throw new NoModificationAllowedException(\"Cannot move file at source URL\");\n }\n final LocalFilesystemURL destination = makeDestinationURL(newName, srcURL, destURL, srcURL.isDirectory);\n\n Uri srcNativeUri = srcFs.toNativeUri(srcURL);\n\n CordovaResourceApi.OpenForReadResult ofrr = resourceApi.openForRead(srcNativeUri);\n OutputStream os = null;\n try {\n os = getOutputStreamForURL(destination);\n } catch (IOException e) {\n ofrr.inputStream.close();\n throw e;\n }\n // Closes streams.\n resourceApi.copyResource(ofrr, os);\n\n if (move) {\n srcFs.removeFileAtLocalURL(srcURL);\n }\n return getEntryForLocalURL(destination);\n }\n\n public OutputStream getOutputStreamForURL(LocalFilesystemURL inputURL) throws IOException {\n return resourceApi.openOutputStream(toNativeUri(inputURL));\n }\n\n public void readFileAtURL(LocalFilesystemURL inputURL, long start, long end,\n ReadFileCallback readFileCallback) throws IOException {\n CordovaResourceApi.OpenForReadResult ofrr = resourceApi.openForRead(toNativeUri(inputURL));\n if (end < 0) {\n end = ofrr.length;\n }\n long numBytesToRead = end - start;\n try {\n if (start > 0) {\n ofrr.inputStream.skip(start);\n }\n InputStream inputStream = ofrr.inputStream;\n if (end < ofrr.length) {\n inputStream = new LimitedInputStream(inputStream, numBytesToRead);\n }\n readFileCallback.handleData(inputStream, ofrr.mimeType);\n } finally {\n ofrr.inputStream.close();\n }\n }\n\n\tabstract long writeToFileAtURL(LocalFilesystemURL inputURL, String data, int offset,\n\t\t\tboolean isBinary) throws NoModificationAllowedException, IOException;\n\n\tabstract long truncateFileAtURL(LocalFilesystemURL inputURL, long size)\n\t\t\tthrows IOException, NoModificationAllowedException;\n\n\t// This method should return null if filesystem urls cannot be mapped to paths\n\tabstract String filesystemPathForURL(LocalFilesystemURL url);\n\n\tabstract LocalFilesystemURL URLforFilesystemPath(String path);\n\n\tabstract boolean canRemoveFileAtLocalURL(LocalFilesystemURL inputURL);\n\n protected class LimitedInputStream extends FilterInputStream {\n long numBytesToRead;\n public LimitedInputStream(InputStream in, long numBytesToRead) {\n super(in);\n this.numBytesToRead = numBytesToRead;\n }\n @Override\n public int read() throws IOException {\n if (numBytesToRead <= 0) {\n return -1;\n }\n numBytesToRead--;\n return in.read();\n }\n @Override\n public int read(byte[] buffer, int byteOffset, int byteCount) throws IOException {\n if (numBytesToRead <= 0) {\n return -1;\n }\n int bytesToRead = byteCount;\n if (byteCount > numBytesToRead) {\n bytesToRead = (int)numBytesToRead; // Cast okay; long is less than int here.\n }\n int numBytesRead = in.read(buffer, byteOffset, bytesToRead);\n numBytesToRead -= numBytesRead;\n return numBytesRead;\n }\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-file/src/android/InvalidModificationException.java",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n*/\n\n\npackage org.apache.cordova.file;\n\n@SuppressWarnings(\"serial\")\npublic class InvalidModificationException extends Exception {\n\n public InvalidModificationException(String message) {\n super(message);\n }\n\n}\n"
},
{
"path": "plugins/cordova-plugin-file/src/android/LocalFilesystem.java",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\npackage org.apache.cordova.file;\n\nimport java.io.ByteArrayInputStream;\nimport java.io.File;\nimport java.io.FileInputStream;\nimport java.io.FileNotFoundException;\nimport java.io.FileOutputStream;\nimport java.io.IOException;\nimport java.io.InputStream;\nimport java.io.OutputStream;\nimport java.io.RandomAccessFile;\nimport java.nio.channels.FileChannel;\nimport org.apache.cordova.CordovaResourceApi;\nimport org.json.JSONException;\nimport org.json.JSONObject;\n\nimport android.os.Build;\nimport android.os.Environment;\nimport android.util.Base64;\nimport android.net.Uri;\nimport android.content.Context;\nimport android.content.Intent;\n\npublic class LocalFilesystem extends Filesystem {\n private final Context context;\n\n public LocalFilesystem(String name, Context context, CordovaResourceApi resourceApi, File fsRoot) {\n super(Uri.fromFile(fsRoot).buildUpon().appendEncodedPath(\"\").build(), name, resourceApi);\n this.context = context;\n }\n\n public String filesystemPathForFullPath(String fullPath) {\n\t return new File(rootUri.getPath(), fullPath).toString();\n\t}\n\n\t@Override\n\tpublic String filesystemPathForURL(LocalFilesystemURL url) {\n\t\treturn filesystemPathForFullPath(url.path);\n\t}\n\n\tprivate String fullPathForFilesystemPath(String absolutePath) {\n\t\tif (absolutePath != null && absolutePath.startsWith(rootUri.getPath())) {\n\t\t\treturn absolutePath.substring(rootUri.getPath().length() - 1);\n\t\t}\n\t\treturn null;\n\t}\n\n @Override\n public Uri toNativeUri(LocalFilesystemURL inputURL) {\n return nativeUriForFullPath(inputURL.path);\n }\n\n @Override\n public LocalFilesystemURL toLocalUri(Uri inputURL) {\n if (!\"file\".equals(inputURL.getScheme())) {\n return null;\n }\n File f = new File(inputURL.getPath());\n // Removes and duplicate /s (e.g. file:///a//b/c)\n Uri resolvedUri = Uri.fromFile(f);\n String rootUriNoTrailingSlash = rootUri.getEncodedPath();\n rootUriNoTrailingSlash = rootUriNoTrailingSlash.substring(0, rootUriNoTrailingSlash.length() - 1);\n if (!resolvedUri.getEncodedPath().startsWith(rootUriNoTrailingSlash)) {\n return null;\n }\n String subPath = resolvedUri.getEncodedPath().substring(rootUriNoTrailingSlash.length());\n // Strip leading slash\n if (!subPath.isEmpty()) {\n subPath = subPath.substring(1);\n }\n Uri.Builder b = new Uri.Builder()\n .scheme(LocalFilesystemURL.FILESYSTEM_PROTOCOL)\n .authority(\"localhost\")\n .path(name);\n if (!subPath.isEmpty()) {\n b.appendEncodedPath(subPath);\n }\n if (f.isDirectory()) {\n // Add trailing / for directories.\n b.appendEncodedPath(\"\");\n }\n return LocalFilesystemURL.parse(b.build());\n }\n\n\t@Override\n\tpublic LocalFilesystemURL URLforFilesystemPath(String path) {\n\t return localUrlforFullPath(fullPathForFilesystemPath(path));\n\t}\n\n\t@Override\n\tpublic JSONObject getFileForLocalURL(LocalFilesystemURL inputURL,\n\t\t\tString path, JSONObject options, boolean directory) throws FileExistsException, IOException, TypeMismatchException, EncodingException, JSONException {\n boolean create = false;\n boolean exclusive = false;\n\n if (options != null) {\n create = options.optBoolean(\"create\");\n if (create) {\n exclusive = options.optBoolean(\"exclusive\");\n }\n }\n\n // Check for a \":\" character in the file to line up with BB and iOS\n if (path.contains(\":\")) {\n throw new EncodingException(\"This path has an invalid \\\":\\\" in it.\");\n }\n\n LocalFilesystemURL requestedURL;\n\n // Check whether the supplied path is absolute or relative\n if (directory && !path.endsWith(\"/\")) {\n path += \"/\";\n }\n if (path.startsWith(\"/\")) {\n \trequestedURL = localUrlforFullPath(normalizePath(path));\n } else {\n \trequestedURL = localUrlforFullPath(normalizePath(inputURL.path + \"/\" + path));\n }\n\n File fp = new File(this.filesystemPathForURL(requestedURL));\n\n if (create) {\n if (exclusive && fp.exists()) {\n throw new FileExistsException(\"create/exclusive fails\");\n }\n if (directory) {\n fp.mkdir();\n } else {\n fp.createNewFile();\n }\n if (!fp.exists()) {\n throw new FileExistsException(\"create fails\");\n }\n }\n else {\n if (!fp.exists()) {\n throw new FileNotFoundException(\"path does not exist\");\n }\n if (directory) {\n if (fp.isFile()) {\n throw new TypeMismatchException(\"path doesn't exist or is file\");\n }\n } else {\n if (fp.isDirectory()) {\n throw new TypeMismatchException(\"path doesn't exist or is directory\");\n }\n }\n }\n\n // Return the directory\n return makeEntryForURL(requestedURL);\n\t}\n\n\t@Override\n\tpublic boolean removeFileAtLocalURL(LocalFilesystemURL inputURL) throws InvalidModificationException {\n\n File fp = new File(filesystemPathForURL(inputURL));\n\n // You can't delete a directory that is not empty\n if (fp.isDirectory() && fp.list().length > 0) {\n throw new InvalidModificationException(\"You can't delete a directory that is not empty.\");\n }\n\n return fp.delete();\n\t}\n\n @Override\n public boolean exists(LocalFilesystemURL inputURL) {\n File fp = new File(filesystemPathForURL(inputURL));\n return fp.exists();\n }\n\n @Override\n public long getFreeSpaceInBytes() {\n return DirectoryManager.getFreeSpaceInBytes(rootUri.getPath());\n }\n\n @Override\n\tpublic boolean recursiveRemoveFileAtLocalURL(LocalFilesystemURL inputURL) throws FileExistsException {\n File directory = new File(filesystemPathForURL(inputURL));\n \treturn removeDirRecursively(directory);\n\t}\n\n\tprotected boolean removeDirRecursively(File directory) throws FileExistsException {\n if (directory.isDirectory()) {\n for (File file : directory.listFiles()) {\n removeDirRecursively(file);\n }\n }\n\n if (!directory.delete()) {\n throw new FileExistsException(\"could not delete: \" + directory.getName());\n } else {\n return true;\n }\n\t}\n\n @Override\n public LocalFilesystemURL[] listChildren(LocalFilesystemURL inputURL) throws FileNotFoundException {\n File fp = new File(filesystemPathForURL(inputURL));\n\n if (!fp.exists()) {\n // The directory we are listing doesn't exist so we should fail.\n throw new FileNotFoundException();\n }\n\n File[] files = fp.listFiles();\n if (files == null) {\n // inputURL is a directory\n return null;\n }\n LocalFilesystemURL[] entries = new LocalFilesystemURL[files.length];\n for (int i = 0; i < files.length; i++) {\n entries[i] = URLforFilesystemPath(files[i].getPath());\n }\n\n return entries;\n\t}\n\n\t@Override\n\tpublic JSONObject getFileMetadataForLocalURL(LocalFilesystemURL inputURL) throws FileNotFoundException {\n File file = new File(filesystemPathForURL(inputURL));\n\n if (!file.exists()) {\n throw new FileNotFoundException(\"File at \" + inputURL.uri + \" does not exist.\");\n }\n\n JSONObject metadata = new JSONObject();\n try {\n // Ensure that directories report a size of 0\n \tmetadata.put(\"size\", file.isDirectory() ? 0 : file.length());\n \tmetadata.put(\"type\", resourceApi.getMimeType(Uri.fromFile(file)));\n \tmetadata.put(\"name\", file.getName());\n \tmetadata.put(\"fullPath\", inputURL.path);\n \tmetadata.put(\"lastModifiedDate\", file.lastModified());\n } catch (JSONException e) {\n \treturn null;\n }\n return metadata;\n\t}\n\n private void copyFile(Filesystem srcFs, LocalFilesystemURL srcURL, File destFile, boolean move) throws IOException, InvalidModificationException, NoModificationAllowedException {\n if (move) {\n String realSrcPath = srcFs.filesystemPathForURL(srcURL);\n if (realSrcPath != null) {\n File srcFile = new File(realSrcPath);\n if (srcFile.renameTo(destFile)) {\n return;\n }\n // Trying to rename the file failed. Possibly because we moved across file system on the device.\n }\n }\n\n CordovaResourceApi.OpenForReadResult offr = resourceApi.openForRead(srcFs.toNativeUri(srcURL));\n copyResource(offr, new FileOutputStream(destFile));\n\n if (move) {\n srcFs.removeFileAtLocalURL(srcURL);\n }\n }\n\n private void copyDirectory(Filesystem srcFs, LocalFilesystemURL srcURL, File dstDir, boolean move) throws IOException, NoModificationAllowedException, InvalidModificationException, FileExistsException {\n if (move) {\n String realSrcPath = srcFs.filesystemPathForURL(srcURL);\n if (realSrcPath != null) {\n File srcDir = new File(realSrcPath);\n // If the destination directory already exists and is empty then delete it. This is according to spec.\n if (dstDir.exists()) {\n if (dstDir.list().length > 0) {\n throw new InvalidModificationException(\"directory is not empty\");\n }\n dstDir.delete();\n }\n // Try to rename the directory\n if (srcDir.renameTo(dstDir)) {\n return;\n }\n // Trying to rename the file failed. Possibly because we moved across file system on the device.\n }\n }\n\n if (dstDir.exists()) {\n if (dstDir.list().length > 0) {\n throw new InvalidModificationException(\"directory is not empty\");\n }\n } else {\n if (!dstDir.mkdir()) {\n // If we can't create the directory then fail\n throw new NoModificationAllowedException(\"Couldn't create the destination directory\");\n }\n }\n\n LocalFilesystemURL[] children = srcFs.listChildren(srcURL);\n for (LocalFilesystemURL childLocalUrl : children) {\n File target = new File(dstDir, new File(childLocalUrl.path).getName());\n if (childLocalUrl.isDirectory) {\n copyDirectory(srcFs, childLocalUrl, target, false);\n } else {\n copyFile(srcFs, childLocalUrl, target, false);\n }\n }\n\n if (move) {\n srcFs.recursiveRemoveFileAtLocalURL(srcURL);\n }\n }\n\n\t@Override\n\tpublic JSONObject copyFileToURL(LocalFilesystemURL destURL, String newName,\n\t\t\tFilesystem srcFs, LocalFilesystemURL srcURL, boolean move) throws IOException, InvalidModificationException, JSONException, NoModificationAllowedException, FileExistsException {\n\n\t\t// Check to see if the destination directory exists\n String newParent = this.filesystemPathForURL(destURL);\n File destinationDir = new File(newParent);\n if (!destinationDir.exists()) {\n // The destination does not exist so we should fail.\n throw new FileNotFoundException(\"The source does not exist\");\n }\n\n // Figure out where we should be copying to\n final LocalFilesystemURL destinationURL = makeDestinationURL(newName, srcURL, destURL, srcURL.isDirectory);\n\n Uri dstNativeUri = toNativeUri(destinationURL);\n Uri srcNativeUri = srcFs.toNativeUri(srcURL);\n // Check to see if source and destination are the same file\n if (dstNativeUri.equals(srcNativeUri)) {\n throw new InvalidModificationException(\"Can't copy onto itself\");\n }\n\n if (move && !srcFs.canRemoveFileAtLocalURL(srcURL)) {\n throw new InvalidModificationException(\"Source URL is read-only (cannot move)\");\n }\n\n File destFile = new File(dstNativeUri.getPath());\n if (destFile.exists()) {\n if (!srcURL.isDirectory && destFile.isDirectory()) {\n throw new InvalidModificationException(\"Can't copy/move a file to an existing directory\");\n } else if (srcURL.isDirectory && destFile.isFile()) {\n throw new InvalidModificationException(\"Can't copy/move a directory to an existing file\");\n }\n }\n\n if (srcURL.isDirectory) {\n // E.g. Copy /sdcard/myDir to /sdcard/myDir/backup\n if (dstNativeUri.toString().startsWith(srcNativeUri.toString() + '/')) {\n throw new InvalidModificationException(\"Can't copy directory into itself\");\n }\n copyDirectory(srcFs, srcURL, destFile, move);\n } else {\n copyFile(srcFs, srcURL, destFile, move);\n }\n return makeEntryForURL(destinationURL);\n\t}\n\n\t@Override\n\tpublic long writeToFileAtURL(LocalFilesystemURL inputURL, String data,\n\t\t\tint offset, boolean isBinary) throws IOException, NoModificationAllowedException {\n\n boolean append = false;\n if (offset > 0) {\n this.truncateFileAtURL(inputURL, offset);\n append = true;\n }\n\n byte[] rawData;\n if (isBinary) {\n rawData = Base64.decode(data, Base64.DEFAULT);\n } else {\n rawData = data.getBytes();\n }\n ByteArrayInputStream in = new ByteArrayInputStream(rawData);\n try\n {\n \tbyte buff[] = new byte[rawData.length];\n String absolutePath = filesystemPathForURL(inputURL);\n FileOutputStream out = new FileOutputStream(absolutePath, append);\n try {\n \tin.read(buff, 0, buff.length);\n \tout.write(buff, 0, rawData.length);\n \tout.flush();\n } finally {\n \t// Always close the output\n \tout.close();\n }\n if (isPublicDirectory(absolutePath)) {\n broadcastNewFile(Uri.fromFile(new File(absolutePath)));\n }\n }\n catch (NullPointerException e)\n {\n // This is a bug in the Android implementation of the Java Stack\n NoModificationAllowedException realException = new NoModificationAllowedException(inputURL.toString());\n throw realException;\n }\n\n return rawData.length;\n\t}\n\n private boolean isPublicDirectory(String absolutePath) {\n // TODO: should expose a way to scan app's private files (maybe via a flag).\n if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {\n // Lollipop has a bug where SD cards are null.\n for (File f : context.getExternalMediaDirs()) {\n if(f != null && absolutePath.startsWith(f.getAbsolutePath())) {\n return true;\n }\n }\n }\n\n String extPath = Environment.getExternalStorageDirectory().getAbsolutePath();\n return absolutePath.startsWith(extPath);\n }\n\n /**\n * Send broadcast of new file so files appear over MTP\n */\n private void broadcastNewFile(Uri nativeUri) {\n Intent intent = new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, nativeUri);\n context.sendBroadcast(intent);\n }\n\n\t@Override\n\tpublic long truncateFileAtURL(LocalFilesystemURL inputURL, long size) throws IOException {\n File file = new File(filesystemPathForURL(inputURL));\n\n if (!file.exists()) {\n throw new FileNotFoundException(\"File at \" + inputURL.uri + \" does not exist.\");\n }\n\n RandomAccessFile raf = new RandomAccessFile(filesystemPathForURL(inputURL), \"rw\");\n try {\n if (raf.length() >= size) {\n FileChannel channel = raf.getChannel();\n channel.truncate(size);\n return size;\n }\n\n return raf.length();\n } finally {\n raf.close();\n }\n\n\n\t}\n\n\t@Override\n\tpublic boolean canRemoveFileAtLocalURL(LocalFilesystemURL inputURL) {\n\t\tString path = filesystemPathForURL(inputURL);\n\t\tFile file = new File(path);\n\t\treturn file.exists();\n\t}\n\n // This is a copy & paste from CordovaResource API that is required since CordovaResourceApi\n // has a bug pre-4.0.0.\n // TODO: Once cordova-android@4.0.0 is released, delete this copy and make the plugin depend on\n // 4.0.0 with an engine tag.\n private static void copyResource(CordovaResourceApi.OpenForReadResult input, OutputStream outputStream) throws IOException {\n try {\n InputStream inputStream = input.inputStream;\n if (inputStream instanceof FileInputStream && outputStream instanceof FileOutputStream) {\n FileChannel inChannel = ((FileInputStream)input.inputStream).getChannel();\n FileChannel outChannel = ((FileOutputStream)outputStream).getChannel();\n long offset = 0;\n long length = input.length;\n if (input.assetFd != null) {\n offset = input.assetFd.getStartOffset();\n }\n // transferFrom()'s 2nd arg is a relative position. Need to set the absolute\n // position first.\n inChannel.position(offset);\n outChannel.transferFrom(inChannel, 0, length);\n } else {\n final int BUFFER_SIZE = 8192;\n byte[] buffer = new byte[BUFFER_SIZE];\n\n for (;;) {\n int bytesRead = inputStream.read(buffer, 0, BUFFER_SIZE);\n\n if (bytesRead <= 0) {\n break;\n }\n outputStream.write(buffer, 0, bytesRead);\n }\n }\n } finally {\n input.inputStream.close();\n if (outputStream != null) {\n outputStream.close();\n }\n }\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-file/src/android/LocalFilesystemURL.java",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\npackage org.apache.cordova.file;\n\nimport android.net.Uri;\n\npublic class LocalFilesystemURL {\n\t\n\tpublic static final String FILESYSTEM_PROTOCOL = \"cdvfile\";\n\n public final Uri uri;\n public final String fsName;\n public final String path;\n public final boolean isDirectory;\n\n\tprivate LocalFilesystemURL(Uri uri, String fsName, String fsPath, boolean isDirectory) {\n\t\tthis.uri = uri;\n this.fsName = fsName;\n this.path = fsPath;\n this.isDirectory = isDirectory;\n\t}\n\n public static LocalFilesystemURL parse(Uri uri) {\n if (!FILESYSTEM_PROTOCOL.equals(uri.getScheme())) {\n return null;\n }\n String path = uri.getPath();\n if (path.length() < 1) {\n return null;\n }\n int firstSlashIdx = path.indexOf('/', 1);\n if (firstSlashIdx < 0) {\n return null;\n }\n String fsName = path.substring(1, firstSlashIdx);\n path = path.substring(firstSlashIdx);\n boolean isDirectory = path.charAt(path.length() - 1) == '/';\n return new LocalFilesystemURL(uri, fsName, path, isDirectory);\n }\n\n public static LocalFilesystemURL parse(String uri) {\n return parse(Uri.parse(uri));\n }\n\n public String toString() {\n return uri.toString();\n }\n}\n"
},
{
"path": "plugins/cordova-plugin-file/src/android/NoModificationAllowedException.java",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n*/\n\npackage org.apache.cordova.file;\n\n@SuppressWarnings(\"serial\")\npublic class NoModificationAllowedException extends Exception {\n\n public NoModificationAllowedException(String message) {\n super(message);\n }\n\n}\n"
},
{
"path": "plugins/cordova-plugin-file/src/android/PendingRequests.java",
"content": "/*\r\n Licensed to the Apache Software Foundation (ASF) under one\r\n or more contributor license agreements. See the NOTICE file\r\n distributed with this work for additional information\r\n regarding copyright ownership. The ASF licenses this file\r\n to you under the Apache License, Version 2.0 (the\r\n \"License\"); you may not use this file except in compliance\r\n with the License. You may obtain a copy of the License at\r\n\r\n http://www.apache.org/licenses/LICENSE-2.0\r\n\r\n Unless required by applicable law or agreed to in writing,\r\n software distributed under the License is distributed on an\r\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\r\n KIND, either express or implied. See the License for the\r\n specific language governing permissions and limitations\r\n under the License.\r\n*/\r\npackage org.apache.cordova.file;\r\n\r\nimport android.util.SparseArray;\r\n\r\nimport org.apache.cordova.CallbackContext;\r\n\r\n/**\r\n * Holds pending runtime permission requests\r\n */\r\nclass PendingRequests {\r\n private int currentReqId = 0;\r\n private SparseArray requests = new SparseArray();\r\n\r\n /**\r\n * Creates a request and adds it to the array of pending requests. Each created request gets a\r\n * unique result code for use with requestPermission()\r\n * @param rawArgs The raw arguments passed to the plugin\r\n * @param action The action this request corresponds to (get file, etc.)\r\n * @param callbackContext The CallbackContext for this plugin call\r\n * @return The request code that can be used to retrieve the Request object\r\n */\r\n public synchronized int createRequest(String rawArgs, int action, CallbackContext callbackContext) {\r\n Request req = new Request(rawArgs, action, callbackContext);\r\n requests.put(req.requestCode, req);\r\n return req.requestCode;\r\n }\r\n\r\n /**\r\n * Gets the request corresponding to this request code and removes it from the pending requests\r\n * @param requestCode The request code for the desired request\r\n * @return The request corresponding to the given request code or null if such a\r\n * request is not found\r\n */\r\n public synchronized Request getAndRemove(int requestCode) {\r\n Request result = requests.get(requestCode);\r\n requests.remove(requestCode);\r\n return result;\r\n }\r\n\r\n /**\r\n * Holds the options and CallbackContext for a call made to the plugin.\r\n */\r\n public class Request {\r\n\r\n // Unique int used to identify this request in any Android permission callback\r\n private int requestCode;\r\n\r\n // Action to be performed after permission request result\r\n private int action;\r\n\r\n // Raw arguments passed to plugin\r\n private String rawArgs;\r\n\r\n // The callback context for this plugin request\r\n private CallbackContext callbackContext;\r\n\r\n private Request(String rawArgs, int action, CallbackContext callbackContext) {\r\n this.rawArgs = rawArgs;\r\n this.action = action;\r\n this.callbackContext = callbackContext;\r\n this.requestCode = currentReqId ++;\r\n }\r\n\r\n public int getAction() {\r\n return this.action;\r\n }\r\n\r\n public String getRawArgs() {\r\n return rawArgs;\r\n }\r\n\r\n public CallbackContext getCallbackContext() {\r\n return callbackContext;\r\n }\r\n }\r\n}\r\n"
},
{
"path": "plugins/cordova-plugin-file/src/android/TypeMismatchException.java",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n*/\n\n\npackage org.apache.cordova.file;\n\n@SuppressWarnings(\"serial\")\npublic class TypeMismatchException extends Exception {\n\n public TypeMismatchException(String message) {\n super(message);\n }\n\n}\n"
},
{
"path": "plugins/cordova-plugin-file/src/android/build-extras.gradle",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\next.postBuildExtras = {\n def inAssetsDir = file(\"assets\")\n def outAssetsDir = inAssetsDir\n def outFile = new File(outAssetsDir, \"cdvasset.manifest\")\n\n def newTask = task(\"cdvCreateAssetManifest\") << {\n def contents = new HashMap()\n def sizes = new HashMap()\n contents[\"\"] = inAssetsDir.list()\n def tree = fileTree(dir: inAssetsDir)\n tree.visit { fileDetails ->\n if (fileDetails.isDirectory()) {\n contents[fileDetails.relativePath.toString()] = fileDetails.file.list()\n } else {\n sizes[fileDetails.relativePath.toString()] = fileDetails.file.length()\n }\n }\n\n outAssetsDir.mkdirs()\n outFile.withObjectOutputStream { oos ->\n oos.writeObject(contents)\n oos.writeObject(sizes)\n }\n }\n newTask.inputs.dir inAssetsDir\n newTask.outputs.file outFile\n def preBuildTask = tasks[\"preBuild\"]\n preBuildTask.dependsOn(newTask)\n}\n"
},
{
"path": "plugins/cordova-plugin-file/src/blackberry10/index.js",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n*/\n\n/* global PluginResult */\n\nmodule.exports = {\n setSandbox : function (success, fail, args, env) {\n require(\"lib/webview\").setSandbox(JSON.parse(decodeURIComponent(args[0])));\n new PluginResult(args, env).ok();\n },\n\n getHomePath: function (success, fail, args, env) {\n var homeDir = window.qnx.webplatform.getApplication().getEnv(\"HOME\");\n new PluginResult(args, env).ok(homeDir);\n },\n\n requestAllPaths: function (success, fail, args, env) {\n var homeDir = 'file://' + window.qnx.webplatform.getApplication().getEnv(\"HOME\").replace('/data', ''),\n paths = {\n applicationDirectory: homeDir + '/app/native/',\n applicationStorageDirectory: homeDir + '/',\n dataDirectory: homeDir + '/data/webviews/webfs/persistent/local__0/',\n cacheDirectory: homeDir + '/data/webviews/webfs/temporary/local__0/',\n externalRootDirectory: 'file:///accounts/1000/removable/sdcard/',\n sharedDirectory: homeDir + '/shared/'\n };\n success(paths);\n }\n};\n"
},
{
"path": "plugins/cordova-plugin-file/src/browser/FileProxy.js",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n */\n(function() {\n /*global require, exports, module*/\n /*global FILESYSTEM_PREFIX*/\n /*global IDBKeyRange*/\n\n /* Heavily based on https://github.com/ebidel/idb.filesystem.js */\n\n // For chrome we don't need to implement proxy methods\n // All functionality can be accessed natively.\n if (require('./isChrome')()) {\n var pathsPrefix = {\n // Read-only directory where the application is installed.\n applicationDirectory: location.origin + \"/\",\n // Where to put app-specific data files.\n dataDirectory: 'filesystem:file:///persistent/',\n // Cached files that should survive app restarts.\n // Apps should not rely on the OS to delete files in here.\n cacheDirectory: 'filesystem:file:///temporary/',\n };\n\n exports.requestAllPaths = function(successCallback) {\n successCallback(pathsPrefix);\n };\n\n require(\"cordova/exec/proxy\").add(\"File\", module.exports);\n return;\n }\n\n var LocalFileSystem = require('./LocalFileSystem'),\n FileSystem = require('./FileSystem'),\n FileEntry = require('./FileEntry'),\n FileError = require('./FileError'),\n DirectoryEntry = require('./DirectoryEntry'),\n File = require('./File');\n\n (function(exports, global) {\n var indexedDB = global.indexedDB || global.mozIndexedDB;\n if (!indexedDB) {\n throw \"Firefox OS File plugin: indexedDB not supported\";\n }\n\n var fs_ = null;\n\n var idb_ = {};\n idb_.db = null;\n var FILE_STORE_ = 'entries';\n\n var DIR_SEPARATOR = '/';\n\n var pathsPrefix = {\n // Read-only directory where the application is installed.\n applicationDirectory: location.origin + \"/\",\n // Where to put app-specific data files.\n dataDirectory: 'file:///persistent/',\n // Cached files that should survive app restarts.\n // Apps should not rely on the OS to delete files in here.\n cacheDirectory: 'file:///temporary/',\n };\n\n var unicodeLastChar = 65535;\n\n /*** Exported functionality ***/\n\n exports.requestFileSystem = function(successCallback, errorCallback, args) {\n var type = args[0];\n // Size is ignored since IDB filesystem size depends\n // on browser implementation and can't be set up by user\n var size = args[1]; // jshint ignore: line\n\n if (type !== LocalFileSystem.TEMPORARY && type !== LocalFileSystem.PERSISTENT) {\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n return;\n }\n\n var name = type === LocalFileSystem.TEMPORARY ? 'temporary' : 'persistent';\n var storageName = (location.protocol + location.host).replace(/:/g, '_');\n\n var root = new DirectoryEntry('', DIR_SEPARATOR);\n fs_ = new FileSystem(name, root);\n\n idb_.open(storageName, function() {\n successCallback(fs_);\n }, errorCallback);\n };\n\n // Overridden by Android, BlackBerry 10 and iOS to populate fsMap\n require('./fileSystems').getFs = function(name, callback) {\n callback(new FileSystem(name, fs_.root));\n };\n\n // list a directory's contents (files and folders).\n exports.readEntries = function(successCallback, errorCallback, args) {\n var fullPath = args[0];\n\n if (typeof successCallback !== 'function') {\n throw Error('Expected successCallback argument.');\n }\n\n var path = resolveToFullPath_(fullPath);\n\n exports.getDirectory(function() {\n idb_.getAllEntries(path.fullPath + DIR_SEPARATOR, path.storagePath, function(entries) {\n successCallback(entries);\n }, errorCallback);\n }, function() {\n if (errorCallback) {\n errorCallback(FileError.NOT_FOUND_ERR);\n }\n }, [path.storagePath, path.fullPath, {create: false}]);\n };\n\n exports.getFile = function(successCallback, errorCallback, args) {\n var fullPath = args[0];\n var path = args[1];\n var options = args[2] || {};\n\n // Create an absolute path if we were handed a relative one.\n path = resolveToFullPath_(fullPath, path);\n\n idb_.get(path.storagePath, function(fileEntry) {\n if (options.create === true && options.exclusive === true && fileEntry) {\n // If create and exclusive are both true, and the path already exists,\n // getFile must fail.\n\n if (errorCallback) {\n errorCallback(FileError.PATH_EXISTS_ERR);\n }\n } else if (options.create === true && !fileEntry) {\n // If create is true, the path doesn't exist, and no other error occurs,\n // getFile must create it as a zero-length file and return a corresponding\n // FileEntry.\n var newFileEntry = new FileEntry(path.fileName, path.fullPath, new FileSystem(path.fsName, fs_.root));\n\n newFileEntry.file_ = new MyFile({\n size: 0,\n name: newFileEntry.name,\n lastModifiedDate: new Date(),\n storagePath: path.storagePath\n });\n\n idb_.put(newFileEntry, path.storagePath, successCallback, errorCallback);\n } else if (options.create === true && fileEntry) {\n if (fileEntry.isFile) {\n // Overwrite file, delete then create new.\n idb_['delete'](path.storagePath, function() {\n var newFileEntry = new FileEntry(path.fileName, path.fullPath, new FileSystem(path.fsName, fs_.root));\n\n newFileEntry.file_ = new MyFile({\n size: 0,\n name: newFileEntry.name,\n lastModifiedDate: new Date(),\n storagePath: path.storagePath\n });\n\n idb_.put(newFileEntry, path.storagePath, successCallback, errorCallback);\n }, errorCallback);\n } else {\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n }\n } else if ((!options.create || options.create === false) && !fileEntry) {\n // If create is not true and the path doesn't exist, getFile must fail.\n if (errorCallback) {\n errorCallback(FileError.NOT_FOUND_ERR);\n }\n } else if ((!options.create || options.create === false) && fileEntry &&\n fileEntry.isDirectory) {\n // If create is not true and the path exists, but is a directory, getFile\n // must fail.\n if (errorCallback) {\n errorCallback(FileError.TYPE_MISMATCH_ERR);\n }\n } else {\n // Otherwise, if no other error occurs, getFile must return a FileEntry\n // corresponding to path.\n\n successCallback(fileEntryFromIdbEntry(fileEntry));\n }\n }, errorCallback);\n };\n\n exports.getFileMetadata = function(successCallback, errorCallback, args) {\n var fullPath = args[0];\n\n exports.getFile(function(fileEntry) {\n successCallback(new File(fileEntry.file_.name, fileEntry.fullPath, '', fileEntry.file_.lastModifiedDate,\n fileEntry.file_.size));\n }, errorCallback, [fullPath, null]);\n };\n\n exports.getMetadata = function(successCallback, errorCallback, args) {\n exports.getFile(function (fileEntry) {\n successCallback(\n {\n modificationTime: fileEntry.file_.lastModifiedDate,\n size: fileEntry.file_.lastModifiedDate\n });\n }, errorCallback, args);\n };\n\n exports.setMetadata = function(successCallback, errorCallback, args) {\n var fullPath = args[0];\n var metadataObject = args[1];\n\n exports.getFile(function (fileEntry) {\n fileEntry.file_.lastModifiedDate = metadataObject.modificationTime;\n idb_.put(fileEntry, fileEntry.file_.storagePath, successCallback, errorCallback);\n }, errorCallback, [fullPath, null]);\n };\n\n exports.write = function(successCallback, errorCallback, args) {\n var fileName = args[0],\n data = args[1],\n position = args[2],\n isBinary = args[3]; // jshint ignore: line\n\n if (!data) {\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n return;\n }\n\n if (typeof data === 'string' || data instanceof String) {\n data = new Blob([data]);\n }\n\n exports.getFile(function(fileEntry) {\n var blob_ = fileEntry.file_.blob_;\n\n if (!blob_) {\n blob_ = new Blob([data], {type: data.type});\n } else {\n // Calc the head and tail fragments\n var head = blob_.slice(0, position);\n var tail = blob_.slice(position + (data.size || data.byteLength));\n\n // Calc the padding\n var padding = position - head.size;\n if (padding < 0) {\n padding = 0;\n }\n\n // Do the \"write\". In fact, a full overwrite of the Blob.\n blob_ = new Blob([head, new Uint8Array(padding), data, tail],\n {type: data.type});\n }\n\n // Set the blob we're writing on this file entry so we can recall it later.\n fileEntry.file_.blob_ = blob_;\n fileEntry.file_.lastModifiedDate = new Date() || null;\n fileEntry.file_.size = blob_.size;\n fileEntry.file_.name = blob_.name;\n fileEntry.file_.type = blob_.type;\n\n idb_.put(fileEntry, fileEntry.file_.storagePath, function() {\n successCallback(data.size || data.byteLength);\n }, errorCallback);\n }, errorCallback, [fileName, null]);\n };\n\n exports.readAsText = function(successCallback, errorCallback, args) {\n var fileName = args[0],\n enc = args[1],\n startPos = args[2],\n endPos = args[3];\n\n readAs('text', fileName, enc, startPos, endPos, successCallback, errorCallback);\n };\n\n exports.readAsDataURL = function(successCallback, errorCallback, args) {\n var fileName = args[0],\n startPos = args[1],\n endPos = args[2];\n\n readAs('dataURL', fileName, null, startPos, endPos, successCallback, errorCallback);\n };\n\n exports.readAsBinaryString = function(successCallback, errorCallback, args) {\n var fileName = args[0],\n startPos = args[1],\n endPos = args[2];\n\n readAs('binaryString', fileName, null, startPos, endPos, successCallback, errorCallback);\n };\n\n exports.readAsArrayBuffer = function(successCallback, errorCallback, args) {\n var fileName = args[0],\n startPos = args[1],\n endPos = args[2];\n\n readAs('arrayBuffer', fileName, null, startPos, endPos, successCallback, errorCallback);\n };\n\n exports.removeRecursively = exports.remove = function(successCallback, errorCallback, args) {\n if (typeof successCallback !== 'function') {\n throw Error('Expected successCallback argument.');\n }\n\n var fullPath = resolveToFullPath_(args[0]).storagePath;\n if (fullPath === pathsPrefix.cacheDirectory || fullPath === pathsPrefix.dataDirectory) {\n errorCallback(FileError.NO_MODIFICATION_ALLOWED_ERR);\n return;\n }\n\n function deleteEntry(isDirectory) {\n // TODO: This doesn't protect against directories that have content in it.\n // Should throw an error instead if the dirEntry is not empty.\n idb_['delete'](fullPath, function() {\n successCallback();\n }, function() {\n if (errorCallback) { errorCallback(); }\n }, isDirectory);\n }\n\n // We need to to understand what we are deleting:\n exports.getDirectory(function(entry) {\n deleteEntry(entry.isDirectory);\n }, function(){\n //DirectoryEntry was already deleted or entry is FileEntry\n deleteEntry(false);\n }, [fullPath, null, {create: false}]);\n };\n\n exports.getDirectory = function(successCallback, errorCallback, args) {\n var fullPath = args[0];\n var path = args[1];\n var options = args[2];\n\n // Create an absolute path if we were handed a relative one.\n path = resolveToFullPath_(fullPath, path);\n\n idb_.get(path.storagePath, function(folderEntry) {\n if (!options) {\n options = {};\n }\n\n if (options.create === true && options.exclusive === true && folderEntry) {\n // If create and exclusive are both true, and the path already exists,\n // getDirectory must fail.\n if (errorCallback) {\n errorCallback(FileError.PATH_EXISTS_ERR);\n }\n // There is a strange bug in mobilespec + FF, which results in coming to multiple else-if's\n // so we are shielding from it with returns.\n return;\n }\n\n if (options.create === true && !folderEntry) {\n // If create is true, the path doesn't exist, and no other error occurs,\n // getDirectory must create it as a zero-length file and return a corresponding\n // MyDirectoryEntry.\n var dirEntry = new DirectoryEntry(path.fileName, path.fullPath, new FileSystem(path.fsName, fs_.root));\n\n idb_.put(dirEntry, path.storagePath, successCallback, errorCallback);\n return;\n }\n\n if (options.create === true && folderEntry) {\n\n if (folderEntry.isDirectory) {\n // IDB won't save methods, so we need re-create the MyDirectoryEntry.\n successCallback(new DirectoryEntry(folderEntry.name, folderEntry.fullPath, folderEntry.filesystem));\n } else {\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n }\n return;\n }\n\n if ((!options.create || options.create === false) && !folderEntry) {\n // Handle root special. It should always exist.\n if (path.fullPath === DIR_SEPARATOR) {\n successCallback(fs_.root);\n return;\n }\n\n // If create is not true and the path doesn't exist, getDirectory must fail.\n if (errorCallback) {\n errorCallback(FileError.NOT_FOUND_ERR);\n }\n\n return;\n }\n if ((!options.create || options.create === false) && folderEntry && folderEntry.isFile) {\n // If create is not true and the path exists, but is a file, getDirectory\n // must fail.\n if (errorCallback) {\n errorCallback(FileError.TYPE_MISMATCH_ERR);\n }\n return;\n }\n\n // Otherwise, if no other error occurs, getDirectory must return a\n // MyDirectoryEntry corresponding to path.\n\n // IDB won't' save methods, so we need re-create MyDirectoryEntry.\n successCallback(new DirectoryEntry(folderEntry.name, folderEntry.fullPath, folderEntry.filesystem));\n }, errorCallback);\n };\n\n exports.getParent = function(successCallback, errorCallback, args) {\n if (typeof successCallback !== 'function') {\n throw Error('Expected successCallback argument.');\n }\n\n var fullPath = args[0];\n //fullPath is like this:\n //file:///persistent/path/to/file or\n //file:///persistent/path/to/directory/\n\n if (fullPath === DIR_SEPARATOR || fullPath === pathsPrefix.cacheDirectory ||\n fullPath === pathsPrefix.dataDirectory) {\n successCallback(fs_.root);\n return;\n }\n\n //To delete all slashes at the end\n while (fullPath[fullPath.length - 1] === '/') {\n fullPath = fullPath.substr(0, fullPath.length - 1);\n }\n\n var pathArr = fullPath.split(DIR_SEPARATOR);\n pathArr.pop();\n var parentName = pathArr.pop();\n var path = pathArr.join(DIR_SEPARATOR) + DIR_SEPARATOR;\n\n //To get parent of root files\n var joined = path + parentName + DIR_SEPARATOR;//is like this: file:///persistent/\n if (joined === pathsPrefix.cacheDirectory || joined === pathsPrefix.dataDirectory) {\n exports.getDirectory(successCallback, errorCallback, [joined, DIR_SEPARATOR, {create: false}]);\n return;\n }\n\n exports.getDirectory(successCallback, errorCallback, [path, parentName, {create: false}]);\n };\n\n exports.copyTo = function(successCallback, errorCallback, args) {\n var srcPath = args[0];\n var parentFullPath = args[1];\n var name = args[2];\n\n if (name.indexOf('/') !== -1 || srcPath === parentFullPath + name) {\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n\n return;\n }\n\n // Read src file\n exports.getFile(function(srcFileEntry) {\n\n var path = resolveToFullPath_(parentFullPath);\n //Check directory\n exports.getDirectory(function() {\n\n // Create dest file\n exports.getFile(function(dstFileEntry) {\n\n exports.write(function() {\n successCallback(dstFileEntry);\n }, errorCallback, [dstFileEntry.file_.storagePath, srcFileEntry.file_.blob_, 0]);\n\n }, errorCallback, [parentFullPath, name, {create: true}]);\n\n }, function() { if (errorCallback) { errorCallback(FileError.NOT_FOUND_ERR); }},\n [path.storagePath, null, {create:false}]);\n\n }, errorCallback, [srcPath, null]);\n };\n\n exports.moveTo = function(successCallback, errorCallback, args) {\n var srcPath = args[0];\n // parentFullPath and name parameters is ignored because\n // args is being passed downstream to exports.copyTo method\n var parentFullPath = args[1]; // jshint ignore: line\n var name = args[2]; // jshint ignore: line\n\n exports.copyTo(function (fileEntry) {\n\n exports.remove(function () {\n successCallback(fileEntry);\n }, errorCallback, [srcPath]);\n\n }, errorCallback, args);\n };\n\n exports.resolveLocalFileSystemURI = function(successCallback, errorCallback, args) {\n var path = args[0];\n\n // Ignore parameters\n if (path.indexOf('?') !== -1) {\n path = String(path).split(\"?\")[0];\n }\n\n // support for encodeURI\n if (/\\%5/g.test(path) || /\\%20/g.test(path)) {\n path = decodeURI(path);\n }\n\n if (path.trim()[0] === '/') {\n if (errorCallback) {\n errorCallback(FileError.ENCODING_ERR);\n }\n return;\n }\n\n //support for cdvfile\n if (path.trim().substr(0,7) === \"cdvfile\") {\n if (path.indexOf(\"cdvfile://localhost\") === -1) {\n if (errorCallback) {\n errorCallback(FileError.ENCODING_ERR);\n }\n return;\n }\n\n var indexPersistent = path.indexOf(\"persistent\");\n var indexTemporary = path.indexOf(\"temporary\");\n\n //cdvfile://localhost/persistent/path/to/file\n if (indexPersistent !== -1) {\n path = \"file:///persistent\" + path.substr(indexPersistent + 10);\n } else if (indexTemporary !== -1) {\n path = \"file:///temporary\" + path.substr(indexTemporary + 9);\n } else {\n if (errorCallback) {\n errorCallback(FileError.ENCODING_ERR);\n }\n return;\n }\n }\n\n // to avoid path form of '///path/to/file'\n function handlePathSlashes(path) {\n var cutIndex = 0;\n for (var i = 0; i < path.length - 1; i++) {\n if (path[i] === DIR_SEPARATOR && path[i + 1] === DIR_SEPARATOR) {\n cutIndex = i + 1;\n } else break;\n }\n\n return path.substr(cutIndex);\n }\n\n // Handle localhost containing paths (see specs )\n if (path.indexOf('file://localhost/') === 0) {\n path = path.replace('file://localhost/', 'file:///');\n }\n\n if (path.indexOf(pathsPrefix.dataDirectory) === 0) {\n path = path.substring(pathsPrefix.dataDirectory.length - 1);\n path = handlePathSlashes(path);\n\n exports.requestFileSystem(function() {\n exports.getFile(successCallback, function() {\n exports.getDirectory(successCallback, errorCallback, [pathsPrefix.dataDirectory, path,\n {create: false}]);\n }, [pathsPrefix.dataDirectory, path, {create: false}]);\n }, errorCallback, [LocalFileSystem.PERSISTENT]);\n } else if (path.indexOf(pathsPrefix.cacheDirectory) === 0) {\n path = path.substring(pathsPrefix.cacheDirectory.length - 1);\n path = handlePathSlashes(path);\n\n exports.requestFileSystem(function() {\n exports.getFile(successCallback, function() {\n exports.getDirectory(successCallback, errorCallback, [pathsPrefix.cacheDirectory, path,\n {create: false}]);\n }, [pathsPrefix.cacheDirectory, path, {create: false}]);\n }, errorCallback, [LocalFileSystem.TEMPORARY]);\n } else if (path.indexOf(pathsPrefix.applicationDirectory) === 0) {\n path = path.substring(pathsPrefix.applicationDirectory.length);\n //TODO: need to cut out redundant slashes?\n\n var xhr = new XMLHttpRequest();\n xhr.open(\"GET\", path, true);\n xhr.onreadystatechange = function () {\n if (xhr.status === 200 && xhr.readyState === 4) {\n exports.requestFileSystem(function(fs) {\n fs.name = location.hostname;\n\n //TODO: need to call exports.getFile(...) to handle errors correct\n fs.root.getFile(path, {create: true}, writeFile, errorCallback);\n }, errorCallback, [LocalFileSystem.PERSISTENT]);\n }\n };\n\n xhr.onerror = function () {\n if(errorCallback) {\n errorCallback(FileError.NOT_READABLE_ERR);\n }\n };\n\n xhr.send();\n } else {\n if(errorCallback) {\n errorCallback(FileError.NOT_FOUND_ERR);\n }\n }\n\n function writeFile(entry) {\n entry.createWriter(function (fileWriter) {\n fileWriter.onwriteend = function (evt) {\n if (!evt.target.error) {\n entry.filesystemName = location.hostname;\n successCallback(entry);\n }\n };\n fileWriter.onerror = function () {\n if (errorCallback) {\n errorCallback(FileError.NOT_READABLE_ERR);\n }\n };\n fileWriter.write(new Blob([xhr.response]));\n }, errorCallback);\n }\n };\n\n exports.requestAllPaths = function(successCallback) {\n successCallback(pathsPrefix);\n };\n\n /*** Helpers ***/\n\n /**\n * Interface to wrap the native File interface.\n *\n * This interface is necessary for creating zero-length (empty) files,\n * something the Filesystem API allows you to do. Unfortunately, File's\n * constructor cannot be called directly, making it impossible to instantiate\n * an empty File in JS.\n *\n * @param {Object} opts Initial values.\n * @constructor\n */\n function MyFile(opts) {\n var blob_ = new Blob();\n\n this.size = opts.size || 0;\n this.name = opts.name || '';\n this.type = opts.type || '';\n this.lastModifiedDate = opts.lastModifiedDate || null;\n this.storagePath = opts.storagePath || '';\n\n // Need some black magic to correct the object's size/name/type based on the\n // blob that is saved.\n Object.defineProperty(this, 'blob_', {\n enumerable: true,\n get: function() {\n return blob_;\n },\n set: function(val) {\n blob_ = val;\n this.size = blob_.size;\n this.name = blob_.name;\n this.type = blob_.type;\n this.lastModifiedDate = blob_.lastModifiedDate;\n }.bind(this)\n });\n }\n\n MyFile.prototype.constructor = MyFile;\n\n // When saving an entry, the fullPath should always lead with a slash and never\n // end with one (e.g. a directory). Also, resolve '.' and '..' to an absolute\n // one. This method ensures path is legit!\n function resolveToFullPath_(cwdFullPath, path) {\n path = path || '';\n var fullPath = path;\n var prefix = '';\n\n cwdFullPath = cwdFullPath || DIR_SEPARATOR;\n if (cwdFullPath.indexOf(FILESYSTEM_PREFIX) === 0) {\n prefix = cwdFullPath.substring(0, cwdFullPath.indexOf(DIR_SEPARATOR, FILESYSTEM_PREFIX.length));\n cwdFullPath = cwdFullPath.substring(cwdFullPath.indexOf(DIR_SEPARATOR, FILESYSTEM_PREFIX.length));\n }\n\n var relativePath = path[0] !== DIR_SEPARATOR;\n if (relativePath) {\n fullPath = cwdFullPath;\n if (cwdFullPath !== DIR_SEPARATOR) {\n fullPath += DIR_SEPARATOR + path;\n } else {\n fullPath += path;\n }\n }\n\n // Remove doubled separator substrings\n var re = new RegExp(DIR_SEPARATOR + DIR_SEPARATOR, 'g');\n fullPath = fullPath.replace(re, DIR_SEPARATOR);\n\n // Adjust '..'s by removing parent directories when '..' flows in path.\n var parts = fullPath.split(DIR_SEPARATOR);\n for (var i = 0; i < parts.length; ++i) {\n var part = parts[i];\n if (part === '..') {\n parts[i - 1] = '';\n parts[i] = '';\n }\n }\n fullPath = parts.filter(function(el) {\n return el;\n }).join(DIR_SEPARATOR);\n\n // Add back in leading slash.\n if (fullPath[0] !== DIR_SEPARATOR) {\n fullPath = DIR_SEPARATOR + fullPath;\n }\n\n // Replace './' by current dir. ('./one/./two' -> one/two)\n fullPath = fullPath.replace(/\\.\\//g, DIR_SEPARATOR);\n\n // Replace '//' with '/'.\n fullPath = fullPath.replace(/\\/\\//g, DIR_SEPARATOR);\n\n // Replace '/.' with '/'.\n fullPath = fullPath.replace(/\\/\\./g, DIR_SEPARATOR);\n\n // Remove '/' if it appears on the end.\n if (fullPath[fullPath.length - 1] === DIR_SEPARATOR &&\n fullPath !== DIR_SEPARATOR) {\n fullPath = fullPath.substring(0, fullPath.length - 1);\n }\n\n var storagePath = prefix + fullPath;\n storagePath = decodeURI(storagePath);\n fullPath = decodeURI(fullPath);\n\n return {\n storagePath: storagePath,\n fullPath: fullPath,\n fileName: fullPath.split(DIR_SEPARATOR).pop(),\n fsName: prefix.split(DIR_SEPARATOR).pop()\n };\n }\n\n function fileEntryFromIdbEntry(fileEntry) {\n // IDB won't save methods, so we need re-create the FileEntry.\n var clonedFileEntry = new FileEntry(fileEntry.name, fileEntry.fullPath, fileEntry.filesystem);\n clonedFileEntry.file_ = fileEntry.file_;\n\n return clonedFileEntry;\n }\n\n function readAs(what, fullPath, encoding, startPos, endPos, successCallback, errorCallback) {\n exports.getFile(function(fileEntry) {\n var fileReader = new FileReader(),\n blob = fileEntry.file_.blob_.slice(startPos, endPos);\n\n fileReader.onload = function(e) {\n successCallback(e.target.result);\n };\n\n fileReader.onerror = errorCallback;\n\n switch (what) {\n case 'text':\n fileReader.readAsText(blob, encoding);\n break;\n case 'dataURL':\n fileReader.readAsDataURL(blob);\n break;\n case 'arrayBuffer':\n fileReader.readAsArrayBuffer(blob);\n break;\n case 'binaryString':\n fileReader.readAsBinaryString(blob);\n break;\n }\n\n }, errorCallback, [fullPath, null]);\n }\n\n /*** Core logic to handle IDB operations ***/\n\n idb_.open = function(dbName, successCallback, errorCallback) {\n var self = this;\n\n // TODO: FF 12.0a1 isn't liking a db name with : in it.\n var request = indexedDB.open(dbName.replace(':', '_')/*, 1 /*version*/);\n\n request.onerror = errorCallback || onError;\n\n request.onupgradeneeded = function(e) {\n // First open was called or higher db version was used.\n\n // console.log('onupgradeneeded: oldVersion:' + e.oldVersion,\n // 'newVersion:' + e.newVersion);\n\n self.db = e.target.result;\n self.db.onerror = onError;\n\n if (!self.db.objectStoreNames.contains(FILE_STORE_)) {\n self.db.createObjectStore(FILE_STORE_/*,{keyPath: 'id', autoIncrement: true}*/);\n }\n };\n\n request.onsuccess = function(e) {\n self.db = e.target.result;\n self.db.onerror = onError;\n successCallback(e);\n };\n\n request.onblocked = errorCallback || onError;\n };\n\n idb_.close = function() {\n this.db.close();\n this.db = null;\n };\n\n idb_.get = function(fullPath, successCallback, errorCallback) {\n if (!this.db) {\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n return;\n }\n\n var tx = this.db.transaction([FILE_STORE_], 'readonly');\n\n var request = tx.objectStore(FILE_STORE_).get(fullPath);\n\n tx.onabort = errorCallback || onError;\n tx.oncomplete = function() {\n successCallback(request.result);\n };\n };\n\n idb_.getAllEntries = function(fullPath, storagePath, successCallback, errorCallback) {\n if (!this.db) {\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n return;\n }\n\n var results = [];\n\n if (storagePath[storagePath.length - 1] === DIR_SEPARATOR) {\n storagePath = storagePath.substring(0, storagePath.length - 1);\n }\n\n var range = IDBKeyRange.bound(storagePath + DIR_SEPARATOR + ' ',\n storagePath + DIR_SEPARATOR + String.fromCharCode(unicodeLastChar));\n\n var tx = this.db.transaction([FILE_STORE_], 'readonly');\n tx.onabort = errorCallback || onError;\n tx.oncomplete = function() {\n results = results.filter(function(val) {\n var pathWithoutSlash = val.fullPath;\n\n if (val.fullPath[val.fullPath.length - 1] === DIR_SEPARATOR) {\n pathWithoutSlash = pathWithoutSlash.substr(0, pathWithoutSlash.length - 1);\n }\n\n var valPartsLen = pathWithoutSlash.split(DIR_SEPARATOR).length;\n var fullPathPartsLen = fullPath.split(DIR_SEPARATOR).length;\n\n /* Input fullPath parameter equals '//' for root folder */\n /* Entries in root folder has valPartsLen equals 2 (see below) */\n if (fullPath[fullPath.length -1] === DIR_SEPARATOR && fullPath.trim().length === 2) {\n fullPathPartsLen = 1;\n } else if (fullPath[fullPath.length -1] === DIR_SEPARATOR) {\n fullPathPartsLen = fullPath.substr(0, fullPath.length - 1).split(DIR_SEPARATOR).length;\n } else {\n fullPathPartsLen = fullPath.split(DIR_SEPARATOR).length;\n }\n\n if (valPartsLen === fullPathPartsLen + 1) {\n // If this a subfolder and entry is a direct child, include it in\n // the results. Otherwise, it's not an entry of this folder.\n return val;\n } else return false;\n });\n\n successCallback(results);\n };\n\n var request = tx.objectStore(FILE_STORE_).openCursor(range);\n\n request.onsuccess = function(e) {\n var cursor = e.target.result;\n if (cursor) {\n var val = cursor.value;\n\n results.push(val.isFile ? fileEntryFromIdbEntry(val) : new DirectoryEntry(val.name, val.fullPath, val.filesystem));\n cursor['continue']();\n }\n };\n };\n\n idb_['delete'] = function(fullPath, successCallback, errorCallback, isDirectory) {\n if (!idb_.db) {\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n return;\n }\n\n var tx = this.db.transaction([FILE_STORE_], 'readwrite');\n tx.oncomplete = successCallback;\n tx.onabort = errorCallback || onError;\n tx.oncomplete = function() {\n if (isDirectory) {\n //We delete nested files and folders after deleting parent folder\n //We use ranges: https://developer.mozilla.org/en-US/docs/Web/API/IDBKeyRange\n fullPath = fullPath + DIR_SEPARATOR;\n\n //Range contains all entries in the form fullPath where\n //symbol in the range from ' ' to symbol which has code `unicodeLastChar`\n var range = IDBKeyRange.bound(fullPath + ' ', fullPath + String.fromCharCode(unicodeLastChar));\n\n var newTx = this.db.transaction([FILE_STORE_], 'readwrite');\n newTx.oncomplete = successCallback;\n newTx.onabort = errorCallback || onError;\n newTx.objectStore(FILE_STORE_)['delete'](range);\n } else {\n successCallback();\n }\n };\n tx.objectStore(FILE_STORE_)['delete'](fullPath);\n };\n\n idb_.put = function(entry, storagePath, successCallback, errorCallback) {\n if (!this.db) {\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n return;\n }\n\n var tx = this.db.transaction([FILE_STORE_], 'readwrite');\n tx.onabort = errorCallback || onError;\n tx.oncomplete = function() {\n // TODO: Error is thrown if we pass the request event back instead.\n successCallback(entry);\n };\n\n tx.objectStore(FILE_STORE_).put(entry, storagePath);\n };\n\n // Global error handler. Errors bubble from request, to transaction, to db.\n function onError(e) {\n switch (e.target.errorCode) {\n case 12:\n console.log('Error - Attempt to open db with a lower version than the ' +\n 'current one.');\n break;\n default:\n console.log('errorCode: ' + e.target.errorCode);\n }\n\n console.log(e, e.code, e.message);\n }\n\n })(module.exports, window);\n\n require(\"cordova/exec/proxy\").add(\"File\", module.exports);\n})();\n"
},
{
"path": "plugins/cordova-plugin-file/src/firefoxos/FileProxy.js",
"content": "/*\n *\n * Licensed to the Apache Software Foundation (ASF) under one\n * or more contributor license agreements. See the NOTICE file\n * distributed with this work for additional information\n * regarding copyright ownership. The ASF licenses this file\n * to you under the Apache License, Version 2.0 (the\n * \"License\"); you may not use this file except in compliance\n * with the License. You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n *\n */\n\n/* global IDBKeyRange */\n\nvar LocalFileSystem = require('./LocalFileSystem'),\n FileSystem = require('./FileSystem'),\n FileEntry = require('./FileEntry'),\n FileError = require('./FileError'),\n DirectoryEntry = require('./DirectoryEntry'),\n File = require('./File');\n\n/*\nQUIRKS:\n Does not fail when removing non-empty directories\n Does not support metadata for directories\n Does not support requestAllFileSystems\n Does not support resolveLocalFileSystemURI\n Methods copyTo and moveTo do not support directories\n\n Heavily based on https://github.com/ebidel/idb.filesystem.js\n */\n\n\n(function(exports, global) {\n var indexedDB = global.indexedDB || global.mozIndexedDB;\n if (!indexedDB) {\n throw \"Firefox OS File plugin: indexedDB not supported\";\n }\n\n var fs_ = null;\n\n var idb_ = {};\n idb_.db = null;\n var FILE_STORE_ = 'entries';\n\n var DIR_SEPARATOR = '/';\n var DIR_OPEN_BOUND = String.fromCharCode(DIR_SEPARATOR.charCodeAt(0) + 1);\n\n var pathsPrefix = {\n // Read-only directory where the application is installed.\n applicationDirectory: location.origin + \"/\",\n // Where to put app-specific data files.\n dataDirectory: 'file:///persistent/',\n // Cached files that should survive app restarts.\n // Apps should not rely on the OS to delete files in here.\n cacheDirectory: 'file:///temporary/',\n };\n\n/*** Exported functionality ***/\n\n exports.requestFileSystem = function(successCallback, errorCallback, args) {\n var type = args[0];\n //var size = args[1];\n\n if (type !== LocalFileSystem.TEMPORARY && type !== LocalFileSystem.PERSISTENT) {\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n return;\n }\n\n var name = type === LocalFileSystem.TEMPORARY ? 'temporary' : 'persistent';\n var storageName = (location.protocol + location.host).replace(/:/g, '_');\n\n var root = new DirectoryEntry('', DIR_SEPARATOR);\n fs_ = new FileSystem(name, root);\n\n idb_.open(storageName, function() {\n successCallback(fs_);\n }, errorCallback);\n };\n\n require('./fileSystems').getFs = function(name, callback) {\n callback(new FileSystem(name, fs_.root));\n };\n\n // list a directory's contents (files and folders).\n exports.readEntries = function(successCallback, errorCallback, args) {\n var fullPath = args[0];\n\n if (!successCallback) {\n throw Error('Expected successCallback argument.');\n }\n\n var path = resolveToFullPath_(fullPath);\n\n idb_.getAllEntries(path.fullPath, path.storagePath, function(entries) {\n successCallback(entries);\n }, errorCallback);\n };\n\n exports.getFile = function(successCallback, errorCallback, args) {\n var fullPath = args[0];\n var path = args[1];\n var options = args[2] || {};\n\n // Create an absolute path if we were handed a relative one.\n path = resolveToFullPath_(fullPath, path);\n\n idb_.get(path.storagePath, function(fileEntry) {\n if (options.create === true && options.exclusive === true && fileEntry) {\n // If create and exclusive are both true, and the path already exists,\n // getFile must fail.\n\n if (errorCallback) {\n errorCallback(FileError.PATH_EXISTS_ERR);\n }\n } else if (options.create === true && !fileEntry) {\n // If create is true, the path doesn't exist, and no other error occurs,\n // getFile must create it as a zero-length file and return a corresponding\n // FileEntry.\n var newFileEntry = new FileEntry(path.fileName, path.fullPath, new FileSystem(path.fsName, fs_.root));\n\n newFileEntry.file_ = new MyFile({\n size: 0,\n name: newFileEntry.name,\n lastModifiedDate: new Date(),\n storagePath: path.storagePath\n });\n\n idb_.put(newFileEntry, path.storagePath, successCallback, errorCallback);\n } else if (options.create === true && fileEntry) {\n if (fileEntry.isFile) {\n // Overwrite file, delete then create new.\n idb_['delete'](path.storagePath, function() {\n var newFileEntry = new FileEntry(path.fileName, path.fullPath, new FileSystem(path.fsName, fs_.root));\n\n newFileEntry.file_ = new MyFile({\n size: 0,\n name: newFileEntry.name,\n lastModifiedDate: new Date(),\n storagePath: path.storagePath\n });\n\n idb_.put(newFileEntry, path.storagePath, successCallback, errorCallback);\n }, errorCallback);\n } else {\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n }\n } else if ((!options.create || options.create === false) && !fileEntry) {\n // If create is not true and the path doesn't exist, getFile must fail.\n if (errorCallback) {\n errorCallback(FileError.NOT_FOUND_ERR);\n }\n } else if ((!options.create || options.create === false) && fileEntry &&\n fileEntry.isDirectory) {\n // If create is not true and the path exists, but is a directory, getFile\n // must fail.\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n } else {\n // Otherwise, if no other error occurs, getFile must return a FileEntry\n // corresponding to path.\n\n successCallback(fileEntryFromIdbEntry(fileEntry));\n }\n }, errorCallback);\n };\n\n exports.getFileMetadata = function(successCallback, errorCallback, args) {\n var fullPath = args[0];\n\n exports.getFile(function(fileEntry) {\n successCallback(new File(fileEntry.file_.name, fileEntry.fullPath, '', fileEntry.file_.lastModifiedDate,\n fileEntry.file_.size));\n }, errorCallback, [fullPath, null]);\n };\n\n exports.getMetadata = function(successCallback, errorCallback, args) {\n exports.getFile(function (fileEntry) {\n successCallback(\n {\n modificationTime: fileEntry.file_.lastModifiedDate,\n size: fileEntry.file_.lastModifiedDate\n });\n }, errorCallback, args);\n };\n\n exports.setMetadata = function(successCallback, errorCallback, args) {\n var fullPath = args[0];\n var metadataObject = args[1];\n\n exports.getFile(function (fileEntry) {\n fileEntry.file_.lastModifiedDate = metadataObject.modificationTime;\n }, errorCallback, [fullPath, null]);\n };\n\n exports.write = function(successCallback, errorCallback, args) {\n var fileName = args[0],\n data = args[1],\n position = args[2];\n //isBinary = args[3];\n\n if (!data) {\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n return;\n }\n\n exports.getFile(function(fileEntry) {\n var blob_ = fileEntry.file_.blob_;\n\n if (!blob_) {\n blob_ = new Blob([data], {type: data.type});\n } else {\n // Calc the head and tail fragments\n var head = blob_.slice(0, position);\n var tail = blob_.slice(position + data.byteLength);\n\n // Calc the padding\n var padding = position - head.size;\n if (padding < 0) {\n padding = 0;\n }\n\n // Do the \"write\". In fact, a full overwrite of the Blob.\n blob_ = new Blob([head, new Uint8Array(padding), data, tail],\n {type: data.type});\n }\n\n // Set the blob we're writing on this file entry so we can recall it later.\n fileEntry.file_.blob_ = blob_;\n fileEntry.file_.lastModifiedDate = data.lastModifiedDate || null;\n fileEntry.file_.size = blob_.size;\n fileEntry.file_.name = blob_.name;\n fileEntry.file_.type = blob_.type;\n\n idb_.put(fileEntry, fileEntry.file_.storagePath, function() {\n successCallback(data.byteLength);\n }, errorCallback);\n }, errorCallback, [fileName, null]);\n };\n\n exports.readAsText = function(successCallback, errorCallback, args) {\n var fileName = args[0],\n enc = args[1],\n startPos = args[2],\n endPos = args[3];\n\n readAs('text', fileName, enc, startPos, endPos, successCallback, errorCallback);\n };\n\n exports.readAsDataURL = function(successCallback, errorCallback, args) {\n var fileName = args[0],\n startPos = args[1],\n endPos = args[2];\n\n readAs('dataURL', fileName, null, startPos, endPos, successCallback, errorCallback);\n };\n\n exports.readAsBinaryString = function(successCallback, errorCallback, args) {\n var fileName = args[0],\n startPos = args[1],\n endPos = args[2];\n\n readAs('binaryString', fileName, null, startPos, endPos, successCallback, errorCallback);\n };\n\n exports.readAsArrayBuffer = function(successCallback, errorCallback, args) {\n var fileName = args[0],\n startPos = args[1],\n endPos = args[2];\n\n readAs('arrayBuffer', fileName, null, startPos, endPos, successCallback, errorCallback);\n };\n\n exports.removeRecursively = exports.remove = function(successCallback, errorCallback, args) {\n var fullPath = args[0];\n\n // TODO: This doesn't protect against directories that have content in it.\n // Should throw an error instead if the dirEntry is not empty.\n idb_['delete'](fullPath, function() {\n successCallback();\n }, errorCallback);\n };\n\n exports.getDirectory = function(successCallback, errorCallback, args) {\n var fullPath = args[0];\n var path = args[1];\n var options = args[2];\n\n // Create an absolute path if we were handed a relative one.\n path = resolveToFullPath_(fullPath, path);\n\n idb_.get(path.storagePath, function(folderEntry) {\n if (!options) {\n options = {};\n }\n\n if (options.create === true && options.exclusive === true && folderEntry) {\n // If create and exclusive are both true, and the path already exists,\n // getDirectory must fail.\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n } else if (options.create === true && !folderEntry) {\n // If create is true, the path doesn't exist, and no other error occurs,\n // getDirectory must create it as a zero-length file and return a corresponding\n // MyDirectoryEntry.\n var dirEntry = new DirectoryEntry(path.fileName, path.fullPath, new FileSystem(path.fsName, fs_.root));\n\n idb_.put(dirEntry, path.storagePath, successCallback, errorCallback);\n } else if (options.create === true && folderEntry) {\n\n if (folderEntry.isDirectory) {\n // IDB won't save methods, so we need re-create the MyDirectoryEntry.\n successCallback(new DirectoryEntry(folderEntry.name, folderEntry.fullPath, folderEntry.fileSystem));\n } else {\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n }\n } else if ((!options.create || options.create === false) && !folderEntry) {\n // Handle root special. It should always exist.\n if (path.fullPath === DIR_SEPARATOR) {\n successCallback(fs_.root);\n return;\n }\n\n // If create is not true and the path doesn't exist, getDirectory must fail.\n if (errorCallback) {\n errorCallback(FileError.NOT_FOUND_ERR);\n }\n } else if ((!options.create || options.create === false) && folderEntry &&\n folderEntry.isFile) {\n // If create is not true and the path exists, but is a file, getDirectory\n // must fail.\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n } else {\n // Otherwise, if no other error occurs, getDirectory must return a\n // MyDirectoryEntry corresponding to path.\n\n // IDB won't' save methods, so we need re-create MyDirectoryEntry.\n successCallback(new DirectoryEntry(folderEntry.name, folderEntry.fullPath, folderEntry.fileSystem));\n }\n }, errorCallback);\n };\n\n exports.getParent = function(successCallback, errorCallback, args) {\n var fullPath = args[0];\n\n if (fullPath === DIR_SEPARATOR) {\n successCallback(fs_.root);\n return;\n }\n\n var pathArr = fullPath.split(DIR_SEPARATOR);\n pathArr.pop();\n var namesa = pathArr.pop();\n var path = pathArr.join(DIR_SEPARATOR);\n\n exports.getDirectory(successCallback, errorCallback, [path, namesa, {create: false}]);\n };\n\n exports.copyTo = function(successCallback, errorCallback, args) {\n var srcPath = args[0];\n var parentFullPath = args[1];\n var name = args[2];\n\n // Read src file\n exports.getFile(function(srcFileEntry) {\n\n // Create dest file\n exports.getFile(function(dstFileEntry) {\n\n exports.write(function() {\n successCallback(dstFileEntry);\n }, errorCallback, [dstFileEntry.file_.storagePath, srcFileEntry.file_.blob_, 0]);\n\n }, errorCallback, [parentFullPath, name, {create: true}]);\n\n }, errorCallback, [srcPath, null]);\n };\n\n exports.moveTo = function(successCallback, errorCallback, args) {\n var srcPath = args[0];\n //var parentFullPath = args[1];\n //var name = args[2];\n\n exports.copyTo(function (fileEntry) {\n\n exports.remove(function () {\n successCallback(fileEntry);\n }, errorCallback, [srcPath]);\n\n }, errorCallback, args);\n };\n\n exports.resolveLocalFileSystemURI = function(successCallback, errorCallback, args) {\n var path = args[0];\n\n // Ignore parameters\n if (path.indexOf('?') !== -1) {\n path = String(path).split(\"?\")[0];\n }\n\n // support for encodeURI\n if (/\\%5/g.test(path)) {\n path = decodeURI(path);\n }\n\n if (path.indexOf(pathsPrefix.dataDirectory) === 0) {\n path = path.substring(pathsPrefix.dataDirectory.length - 1);\n\n exports.requestFileSystem(function(fs) {\n fs.root.getFile(path, {create: false}, successCallback, function() {\n fs.root.getDirectory(path, {create: false}, successCallback, errorCallback);\n });\n }, errorCallback, [LocalFileSystem.PERSISTENT]);\n } else if (path.indexOf(pathsPrefix.cacheDirectory) === 0) {\n path = path.substring(pathsPrefix.cacheDirectory.length - 1);\n\n exports.requestFileSystem(function(fs) {\n fs.root.getFile(path, {create: false}, successCallback, function() {\n fs.root.getDirectory(path, {create: false}, successCallback, errorCallback);\n });\n }, errorCallback, [LocalFileSystem.TEMPORARY]);\n } else if (path.indexOf(pathsPrefix.applicationDirectory) === 0) {\n path = path.substring(pathsPrefix.applicationDirectory.length);\n\n var xhr = new XMLHttpRequest();\n xhr.open(\"GET\", path, true);\n xhr.onreadystatechange = function () {\n if (xhr.status === 200 && xhr.readyState === 4) {\n exports.requestFileSystem(function(fs) {\n fs.name = location.hostname;\n fs.root.getFile(path, {create: true}, writeFile, errorCallback);\n }, errorCallback, [LocalFileSystem.PERSISTENT]);\n }\n };\n\n xhr.onerror = function () {\n if (errorCallback) {\n errorCallback(FileError.NOT_READABLE_ERR);\n }\n };\n\n xhr.send();\n } else {\n if (errorCallback) {\n errorCallback(FileError.NOT_FOUND_ERR);\n }\n }\n\n function writeFile(entry) {\n entry.createWriter(function (fileWriter) {\n fileWriter.onwriteend = function (evt) {\n if (!evt.target.error) {\n entry.filesystemName = location.hostname;\n successCallback(entry);\n }\n };\n fileWriter.onerror = function () {\n if (errorCallback) {\n errorCallback(FileError.NOT_READABLE_ERR);\n }\n };\n fileWriter.write(new Blob([xhr.response]));\n }, errorCallback);\n }\n };\n\n exports.requestAllPaths = function(successCallback) {\n successCallback(pathsPrefix);\n };\n\n/*** Helpers ***/\n\n /**\n * Interface to wrap the native File interface.\n *\n * This interface is necessary for creating zero-length (empty) files,\n * something the Filesystem API allows you to do. Unfortunately, File's\n * constructor cannot be called directly, making it impossible to instantiate\n * an empty File in JS.\n *\n * @param {Object} opts Initial values.\n * @constructor\n */\n function MyFile(opts) {\n var blob_ = new Blob();\n\n this.size = opts.size || 0;\n this.name = opts.name || '';\n this.type = opts.type || '';\n this.lastModifiedDate = opts.lastModifiedDate || null;\n this.storagePath = opts.storagePath || '';\n\n // Need some black magic to correct the object's size/name/type based on the\n // blob that is saved.\n Object.defineProperty(this, 'blob_', {\n enumerable: true,\n get: function() {\n return blob_;\n },\n set: function(val) {\n blob_ = val;\n this.size = blob_.size;\n this.name = blob_.name;\n this.type = blob_.type;\n this.lastModifiedDate = blob_.lastModifiedDate;\n }.bind(this)\n });\n }\n\n MyFile.prototype.constructor = MyFile;\n\n // When saving an entry, the fullPath should always lead with a slash and never\n // end with one (e.g. a directory). Also, resolve '.' and '..' to an absolute\n // one. This method ensures path is legit!\n function resolveToFullPath_(cwdFullPath, path) {\n path = path || '';\n var fullPath = path;\n var prefix = '';\n\n cwdFullPath = cwdFullPath || DIR_SEPARATOR;\n if (cwdFullPath.indexOf(FILESYSTEM_PREFIX) === 0) {\n prefix = cwdFullPath.substring(0, cwdFullPath.indexOf(DIR_SEPARATOR, FILESYSTEM_PREFIX.length));\n cwdFullPath = cwdFullPath.substring(cwdFullPath.indexOf(DIR_SEPARATOR, FILESYSTEM_PREFIX.length));\n }\n\n var relativePath = path[0] !== DIR_SEPARATOR;\n if (relativePath) {\n fullPath = cwdFullPath;\n if (cwdFullPath != DIR_SEPARATOR) {\n fullPath += DIR_SEPARATOR + path;\n } else {\n fullPath += path;\n }\n }\n\n // Adjust '..'s by removing parent directories when '..' flows in path.\n var parts = fullPath.split(DIR_SEPARATOR);\n for (var i = 0; i < parts.length; ++i) {\n var part = parts[i];\n if (part == '..') {\n parts[i - 1] = '';\n parts[i] = '';\n }\n }\n fullPath = parts.filter(function(el) {\n return el;\n }).join(DIR_SEPARATOR);\n\n // Add back in leading slash.\n if (fullPath[0] !== DIR_SEPARATOR) {\n fullPath = DIR_SEPARATOR + fullPath;\n }\n\n // Replace './' by current dir. ('./one/./two' -> one/two)\n fullPath = fullPath.replace(/\\.\\//g, DIR_SEPARATOR);\n\n // Replace '//' with '/'.\n fullPath = fullPath.replace(/\\/\\//g, DIR_SEPARATOR);\n\n // Replace '/.' with '/'.\n fullPath = fullPath.replace(/\\/\\./g, DIR_SEPARATOR);\n\n // Remove '/' if it appears on the end.\n if (fullPath[fullPath.length - 1] == DIR_SEPARATOR &&\n fullPath != DIR_SEPARATOR) {\n fullPath = fullPath.substring(0, fullPath.length - 1);\n }\n\n return {\n storagePath: prefix + fullPath,\n fullPath: fullPath,\n fileName: fullPath.split(DIR_SEPARATOR).pop(),\n fsName: prefix.split(DIR_SEPARATOR).pop()\n };\n }\n\n function fileEntryFromIdbEntry(fileEntry) {\n // IDB won't save methods, so we need re-create the FileEntry.\n var clonedFileEntry = new FileEntry(fileEntry.name, fileEntry.fullPath, fileEntry.fileSystem);\n clonedFileEntry.file_ = fileEntry.file_;\n\n return clonedFileEntry;\n }\n\n function readAs(what, fullPath, encoding, startPos, endPos, successCallback, errorCallback) {\n exports.getFile(function(fileEntry) {\n var fileReader = new FileReader(),\n blob = fileEntry.file_.blob_.slice(startPos, endPos);\n\n fileReader.onload = function(e) {\n successCallback(e.target.result);\n };\n\n fileReader.onerror = errorCallback;\n\n switch (what) {\n case 'text':\n fileReader.readAsText(blob, encoding);\n break;\n case 'dataURL':\n fileReader.readAsDataURL(blob);\n break;\n case 'arrayBuffer':\n fileReader.readAsArrayBuffer(blob);\n break;\n case 'binaryString':\n fileReader.readAsBinaryString(blob);\n break;\n }\n\n }, errorCallback, [fullPath, null]);\n }\n\n/*** Core logic to handle IDB operations ***/\n\n idb_.open = function(dbName, successCallback, errorCallback) {\n var self = this;\n\n // TODO: FF 12.0a1 isn't liking a db name with : in it.\n var request = indexedDB.open(dbName.replace(':', '_')/*, 1 /*version*/);\n\n request.onerror = errorCallback || onError;\n\n request.onupgradeneeded = function(e) {\n // First open was called or higher db version was used.\n\n // console.log('onupgradeneeded: oldVersion:' + e.oldVersion,\n // 'newVersion:' + e.newVersion);\n\n self.db = e.target.result;\n self.db.onerror = onError;\n\n if (!self.db.objectStoreNames.contains(FILE_STORE_)) {\n self.db.createObjectStore(FILE_STORE_/*,{keyPath: 'id', autoIncrement: true}*/);\n }\n };\n\n request.onsuccess = function(e) {\n self.db = e.target.result;\n self.db.onerror = onError;\n successCallback(e);\n };\n\n request.onblocked = errorCallback || onError;\n };\n\n idb_.close = function() {\n this.db.close();\n this.db = null;\n };\n\n idb_.get = function(fullPath, successCallback, errorCallback) {\n if (!this.db) {\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n return;\n }\n\n var tx = this.db.transaction([FILE_STORE_], 'readonly');\n\n //var request = tx.objectStore(FILE_STORE_).get(fullPath);\n var range = IDBKeyRange.bound(fullPath, fullPath + DIR_OPEN_BOUND,\n false, true);\n var request = tx.objectStore(FILE_STORE_).get(range);\n\n tx.onabort = errorCallback || onError;\n tx.oncomplete = function(e) {\n successCallback(request.result);\n };\n };\n\n idb_.getAllEntries = function(fullPath, storagePath, successCallback, errorCallback) {\n if (!this.db) {\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n return;\n }\n\n var results = [];\n\n if (storagePath[storagePath.length - 1] === DIR_SEPARATOR) {\n storagePath = storagePath.substring(0, storagePath.length - 1);\n }\n\n var range = IDBKeyRange.bound(\n storagePath + DIR_SEPARATOR, storagePath + DIR_OPEN_BOUND, false, true);\n\n var tx = this.db.transaction([FILE_STORE_], 'readonly');\n tx.onabort = errorCallback || onError;\n tx.oncomplete = function(e) {\n results = results.filter(function(val) {\n var valPartsLen = val.fullPath.split(DIR_SEPARATOR).length;\n var fullPathPartsLen = fullPath.split(DIR_SEPARATOR).length;\n\n if (fullPath === DIR_SEPARATOR && valPartsLen < fullPathPartsLen + 1) {\n // Hack to filter out entries in the root folder. This is inefficient\n // because reading the entires of fs.root (e.g. '/') returns ALL\n // results in the database, then filters out the entries not in '/'.\n return val;\n } else if (fullPath !== DIR_SEPARATOR &&\n valPartsLen === fullPathPartsLen + 1) {\n // If this a subfolder and entry is a direct child, include it in\n // the results. Otherwise, it's not an entry of this folder.\n return val;\n }\n });\n\n successCallback(results);\n };\n\n var request = tx.objectStore(FILE_STORE_).openCursor(range);\n\n request.onsuccess = function(e) {\n var cursor = e.target.result;\n if (cursor) {\n var val = cursor.value;\n\n results.push(val.isFile ? fileEntryFromIdbEntry(val) : new DirectoryEntry(val.name, val.fullPath, val.fileSystem));\n cursor['continue']();\n }\n };\n };\n\n idb_['delete'] = function(fullPath, successCallback, errorCallback) {\n if (!this.db) {\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n return;\n }\n\n var tx = this.db.transaction([FILE_STORE_], 'readwrite');\n tx.oncomplete = successCallback;\n tx.onabort = errorCallback || onError;\n\n //var request = tx.objectStore(FILE_STORE_).delete(fullPath);\n var range = IDBKeyRange.bound(\n fullPath, fullPath + DIR_OPEN_BOUND, false, true);\n tx.objectStore(FILE_STORE_)['delete'](range);\n };\n\n idb_.put = function(entry, storagePath, successCallback, errorCallback) {\n if (!this.db) {\n if (errorCallback) {\n errorCallback(FileError.INVALID_MODIFICATION_ERR);\n }\n return;\n }\n\n var tx = this.db.transaction([FILE_STORE_], 'readwrite');\n tx.onabort = errorCallback || onError;\n tx.oncomplete = function(e) {\n // TODO: Error is thrown if we pass the request event back instead.\n successCallback(entry);\n };\n\n tx.objectStore(FILE_STORE_).put(entry, storagePath);\n };\n\n // Global error handler. Errors bubble from request, to transaction, to db.\n function onError(e) {\n switch (e.target.errorCode) {\n case 12:\n console.log('Error - Attempt to open db with a lower version than the ' +\n 'current one.');\n break;\n default:\n console.log('errorCode: ' + e.target.errorCode);\n }\n\n console.log(e, e.code, e.message);\n }\n\n// Clean up.\n// TODO: Is there a place for this?\n// global.addEventListener('beforeunload', function(e) {\n// idb_.db && idb_.db.close();\n// }, false);\n\n})(module.exports, window);\n\nrequire(\"cordova/exec/proxy\").add(\"File\", module.exports);\n"
},
{
"path": "plugins/cordova-plugin-file/src/ios/CDVAssetLibraryFilesystem.h",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\n\n#import \"CDVFile.h\"\n\nextern NSString* const kCDVAssetsLibraryPrefix;\nextern NSString* const kCDVAssetsLibraryScheme;\n\n@interface CDVAssetLibraryFilesystem : NSObject {\n}\n\n- (id) initWithName:(NSString *)name;\n\n@end\n"
},
{
"path": "plugins/cordova-plugin-file/src/ios/CDVAssetLibraryFilesystem.m",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\n\n#import \"CDVFile.h\"\n#import \"CDVAssetLibraryFilesystem.h\"\n#import \n#import \n#import \n#import \n#import \n\nNSString* const kCDVAssetsLibraryPrefix = @\"assets-library://\";\nNSString* const kCDVAssetsLibraryScheme = @\"assets-library\";\n\n@implementation CDVAssetLibraryFilesystem\n@synthesize name=_name, urlTransformer;\n\n\n/*\n The CDVAssetLibraryFilesystem works with resources which are identified\n by iOS as\n asset-library://\n and represents them internally as URLs of the form\n cdvfile://localhost/assets-library/\n */\n\n- (NSURL *)assetLibraryURLForLocalURL:(CDVFilesystemURL *)url\n{\n if ([url.url.scheme isEqualToString:kCDVFilesystemURLPrefix]) {\n NSString *path = [[url.url absoluteString] substringFromIndex:[@\"cdvfile://localhost/assets-library\" length]];\n return [NSURL URLWithString:[NSString stringWithFormat:@\"assets-library:/%@\", path]];\n }\n return url.url;\n}\n\n- (CDVPluginResult *)entryForLocalURI:(CDVFilesystemURL *)url\n{\n NSDictionary* entry = [self makeEntryForLocalURL:url];\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:entry];\n}\n\n- (NSDictionary *)makeEntryForLocalURL:(CDVFilesystemURL *)url {\n return [self makeEntryForPath:url.fullPath isDirectory:NO];\n}\n\n- (NSDictionary*)makeEntryForPath:(NSString*)fullPath isDirectory:(BOOL)isDir\n{\n NSMutableDictionary* dirEntry = [NSMutableDictionary dictionaryWithCapacity:5];\n NSString* lastPart = [fullPath lastPathComponent];\n if (isDir && ![fullPath hasSuffix:@\"/\"]) {\n fullPath = [fullPath stringByAppendingString:@\"/\"];\n }\n [dirEntry setObject:[NSNumber numberWithBool:!isDir] forKey:@\"isFile\"];\n [dirEntry setObject:[NSNumber numberWithBool:isDir] forKey:@\"isDirectory\"];\n [dirEntry setObject:fullPath forKey:@\"fullPath\"];\n [dirEntry setObject:lastPart forKey:@\"name\"];\n [dirEntry setObject:self.name forKey: @\"filesystemName\"];\n\n NSURL* nativeURL = [NSURL URLWithString:[NSString stringWithFormat:@\"assets-library:/%@\",fullPath]];\n if (self.urlTransformer) {\n nativeURL = self.urlTransformer(nativeURL);\n }\n dirEntry[@\"nativeURL\"] = [nativeURL absoluteString];\n\n return dirEntry;\n}\n\n/* helper function to get the mimeType from the file extension\n * IN:\n *\tNSString* fullPath - filename (may include path)\n * OUT:\n *\tNSString* the mime type as type/subtype. nil if not able to determine\n */\n+ (NSString*)getMimeTypeFromPath:(NSString*)fullPath\n{\n NSString* mimeType = nil;\n\n if (fullPath) {\n CFStringRef typeId = UTTypeCreatePreferredIdentifierForTag(kUTTagClassFilenameExtension, (__bridge CFStringRef)[fullPath pathExtension], NULL);\n if (typeId) {\n mimeType = (__bridge_transfer NSString*)UTTypeCopyPreferredTagWithClass(typeId, kUTTagClassMIMEType);\n if (!mimeType) {\n // special case for m4a\n if ([(__bridge NSString*)typeId rangeOfString : @\"m4a-audio\"].location != NSNotFound) {\n mimeType = @\"audio/mp4\";\n } else if ([[fullPath pathExtension] rangeOfString:@\"wav\"].location != NSNotFound) {\n mimeType = @\"audio/wav\";\n } else if ([[fullPath pathExtension] rangeOfString:@\"css\"].location != NSNotFound) {\n mimeType = @\"text/css\";\n }\n }\n CFRelease(typeId);\n }\n }\n return mimeType;\n}\n\n- (id)initWithName:(NSString *)name\n{\n if (self) {\n self.name = name;\n }\n return self;\n}\n\n- (CDVPluginResult *)getFileForURL:(CDVFilesystemURL *)baseURI requestedPath:(NSString *)requestedPath options:(NSDictionary *)options\n{\n // return unsupported result for assets-library URLs\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_MALFORMED_URL_EXCEPTION messageAsString:@\"getFile not supported for assets-library URLs.\"];\n}\n\n- (CDVPluginResult*)getParentForURL:(CDVFilesystemURL *)localURI\n{\n // we don't (yet?) support getting the parent of an asset\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NOT_READABLE_ERR];\n}\n\n- (CDVPluginResult*)setMetadataForURL:(CDVFilesystemURL *)localURI withObject:(NSDictionary *)options\n{\n // setMetadata doesn't make sense for asset library files\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];\n}\n\n- (CDVPluginResult *)removeFileAtURL:(CDVFilesystemURL *)localURI\n{\n // return error for assets-library URLs\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:INVALID_MODIFICATION_ERR];\n}\n\n- (CDVPluginResult *)recursiveRemoveFileAtURL:(CDVFilesystemURL *)localURI\n{\n // return error for assets-library URLs\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_MALFORMED_URL_EXCEPTION messageAsString:@\"removeRecursively not supported for assets-library URLs.\"];\n}\n\n- (CDVPluginResult *)readEntriesAtURL:(CDVFilesystemURL *)localURI\n{\n // return unsupported result for assets-library URLs\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_MALFORMED_URL_EXCEPTION messageAsString:@\"readEntries not supported for assets-library URLs.\"];\n}\n\n- (CDVPluginResult *)truncateFileAtURL:(CDVFilesystemURL *)localURI atPosition:(unsigned long long)pos\n{\n // assets-library files can't be truncated\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NO_MODIFICATION_ALLOWED_ERR];\n}\n\n- (CDVPluginResult *)writeToFileAtURL:(CDVFilesystemURL *)localURL withData:(NSData*)encData append:(BOOL)shouldAppend\n{\n // text can't be written into assets-library files\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NO_MODIFICATION_ALLOWED_ERR];\n}\n\n- (void)copyFileToURL:(CDVFilesystemURL *)destURL withName:(NSString *)newName fromFileSystem:(NSObject *)srcFs atURL:(CDVFilesystemURL *)srcURL copy:(BOOL)bCopy callback:(void (^)(CDVPluginResult *))callback\n{\n // Copying to an assets library file is not doable, since we can't write it.\n CDVPluginResult *result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:INVALID_MODIFICATION_ERR];\n callback(result);\n}\n\n- (NSString *)filesystemPathForURL:(CDVFilesystemURL *)url\n{\n NSString *path = nil;\n if ([[url.url scheme] isEqualToString:kCDVAssetsLibraryScheme]) {\n path = [url.url path];\n } else {\n path = url.fullPath;\n }\n if ([path hasSuffix:@\"/\"]) {\n path = [path substringToIndex:([path length]-1)];\n }\n return path;\n}\n\n- (void)readFileAtURL:(CDVFilesystemURL *)localURL start:(NSInteger)start end:(NSInteger)end callback:(void (^)(NSData*, NSString* mimeType, CDVFileError))callback\n{\n ALAssetsLibraryAssetForURLResultBlock resultBlock = ^(ALAsset* asset) {\n if (asset) {\n // We have the asset! Get the data and send it off.\n ALAssetRepresentation* assetRepresentation = [asset defaultRepresentation];\n NSUInteger size = (end > start) ? (end - start) : [assetRepresentation size];\n Byte* buffer = (Byte*)malloc(size);\n NSUInteger bufferSize = [assetRepresentation getBytes:buffer fromOffset:start length:size error:nil];\n NSData* data = [NSData dataWithBytesNoCopy:buffer length:bufferSize freeWhenDone:YES];\n NSString* MIMEType = (__bridge_transfer NSString*)UTTypeCopyPreferredTagWithClass((__bridge CFStringRef)[assetRepresentation UTI], kUTTagClassMIMEType);\n\n callback(data, MIMEType, NO_ERROR);\n } else {\n callback(nil, nil, NOT_FOUND_ERR);\n }\n };\n\n ALAssetsLibraryAccessFailureBlock failureBlock = ^(NSError* error) {\n // Retrieving the asset failed for some reason. Send the appropriate error.\n NSLog(@\"Error: %@\", error);\n callback(nil, nil, SECURITY_ERR);\n };\n\n ALAssetsLibrary* assetsLibrary = [[ALAssetsLibrary alloc] init];\n [assetsLibrary assetForURL:[self assetLibraryURLForLocalURL:localURL] resultBlock:resultBlock failureBlock:failureBlock];\n}\n\n- (void)getFileMetadataForURL:(CDVFilesystemURL *)localURL callback:(void (^)(CDVPluginResult *))callback\n{\n // In this case, we need to use an asynchronous method to retrieve the file.\n // Because of this, we can't just assign to `result` and send it at the end of the method.\n // Instead, we return after calling the asynchronous method and send `result` in each of the blocks.\n ALAssetsLibraryAssetForURLResultBlock resultBlock = ^(ALAsset* asset) {\n if (asset) {\n // We have the asset! Populate the dictionary and send it off.\n NSMutableDictionary* fileInfo = [NSMutableDictionary dictionaryWithCapacity:5];\n ALAssetRepresentation* assetRepresentation = [asset defaultRepresentation];\n [fileInfo setObject:[NSNumber numberWithUnsignedLongLong:[assetRepresentation size]] forKey:@\"size\"];\n [fileInfo setObject:localURL.fullPath forKey:@\"fullPath\"];\n NSString* filename = [assetRepresentation filename];\n [fileInfo setObject:filename forKey:@\"name\"];\n [fileInfo setObject:[CDVAssetLibraryFilesystem getMimeTypeFromPath:filename] forKey:@\"type\"];\n NSDate* creationDate = [asset valueForProperty:ALAssetPropertyDate];\n NSNumber* msDate = [NSNumber numberWithDouble:[creationDate timeIntervalSince1970] * 1000];\n [fileInfo setObject:msDate forKey:@\"lastModifiedDate\"];\n\n callback([CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:fileInfo]);\n } else {\n // We couldn't find the asset. Send the appropriate error.\n callback([CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NOT_FOUND_ERR]);\n }\n };\n ALAssetsLibraryAccessFailureBlock failureBlock = ^(NSError* error) {\n // Retrieving the asset failed for some reason. Send the appropriate error.\n callback([CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsString:[error localizedDescription]]);\n };\n\n ALAssetsLibrary* assetsLibrary = [[ALAssetsLibrary alloc] init];\n [assetsLibrary assetForURL:[self assetLibraryURLForLocalURL:localURL] resultBlock:resultBlock failureBlock:failureBlock];\n return;\n}\n@end\n"
},
{
"path": "plugins/cordova-plugin-file/src/ios/CDVFile.h",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\n\n#import \n#import \n\nNSString* const kCDVAssetsLibraryPrefix;\nNSString* const kCDVFilesystemURLPrefix;\n\nenum CDVFileError {\n NO_ERROR = 0,\n NOT_FOUND_ERR = 1,\n SECURITY_ERR = 2,\n ABORT_ERR = 3,\n NOT_READABLE_ERR = 4,\n ENCODING_ERR = 5,\n NO_MODIFICATION_ALLOWED_ERR = 6,\n INVALID_STATE_ERR = 7,\n SYNTAX_ERR = 8,\n INVALID_MODIFICATION_ERR = 9,\n QUOTA_EXCEEDED_ERR = 10,\n TYPE_MISMATCH_ERR = 11,\n PATH_EXISTS_ERR = 12\n};\ntypedef int CDVFileError;\n\n@interface CDVFilesystemURL : NSObject {\n NSURL *_url;\n NSString *_fileSystemName;\n NSString *_fullPath;\n}\n\n- (id) initWithString:(NSString*)strURL;\n- (id) initWithURL:(NSURL*)URL;\n+ (CDVFilesystemURL *)fileSystemURLWithString:(NSString *)strURL;\n+ (CDVFilesystemURL *)fileSystemURLWithURL:(NSURL *)URL;\n\n- (NSString *)absoluteURL;\n\n@property (atomic) NSURL *url;\n@property (atomic) NSString *fileSystemName;\n@property (atomic) NSString *fullPath;\n\n@end\n\n@interface CDVFilesystemURLProtocol : NSURLProtocol\n@end\n\n@protocol CDVFileSystem\n- (CDVPluginResult *)entryForLocalURI:(CDVFilesystemURL *)url;\n- (CDVPluginResult *)getFileForURL:(CDVFilesystemURL *)baseURI requestedPath:(NSString *)requestedPath options:(NSDictionary *)options;\n- (CDVPluginResult *)getParentForURL:(CDVFilesystemURL *)localURI;\n- (CDVPluginResult *)setMetadataForURL:(CDVFilesystemURL *)localURI withObject:(NSDictionary *)options;\n- (CDVPluginResult *)removeFileAtURL:(CDVFilesystemURL *)localURI;\n- (CDVPluginResult *)recursiveRemoveFileAtURL:(CDVFilesystemURL *)localURI;\n- (CDVPluginResult *)readEntriesAtURL:(CDVFilesystemURL *)localURI;\n- (CDVPluginResult *)truncateFileAtURL:(CDVFilesystemURL *)localURI atPosition:(unsigned long long)pos;\n- (CDVPluginResult *)writeToFileAtURL:(CDVFilesystemURL *)localURL withData:(NSData*)encData append:(BOOL)shouldAppend;\n- (void)copyFileToURL:(CDVFilesystemURL *)destURL withName:(NSString *)newName fromFileSystem:(NSObject *)srcFs atURL:(CDVFilesystemURL *)srcURL copy:(BOOL)bCopy callback:(void (^)(CDVPluginResult *))callback;\n- (void)readFileAtURL:(CDVFilesystemURL *)localURL start:(NSInteger)start end:(NSInteger)end callback:(void (^)(NSData*, NSString* mimeType, CDVFileError))callback;\n- (void)getFileMetadataForURL:(CDVFilesystemURL *)localURL callback:(void (^)(CDVPluginResult *))callback;\n\n- (NSDictionary *)makeEntryForLocalURL:(CDVFilesystemURL *)url;\n- (NSDictionary*)makeEntryForPath:(NSString*)fullPath isDirectory:(BOOL)isDir;\n\n@property (nonatomic,strong) NSString *name;\n@property (nonatomic, copy) NSURL*(^urlTransformer)(NSURL*);\n\n@optional\n- (NSString *)filesystemPathForURL:(CDVFilesystemURL *)localURI;\n- (CDVFilesystemURL *)URLforFilesystemPath:(NSString *)path;\n\n@end\n\n@interface CDVFile : CDVPlugin {\n NSString* rootDocsPath;\n NSString* appDocsPath;\n NSString* appLibraryPath;\n NSString* appTempPath;\n\n NSMutableArray* fileSystems_;\n BOOL userHasAllowed;\n}\n\n- (NSNumber*)checkFreeDiskSpace:(NSString*)appPath;\n- (NSDictionary*)makeEntryForPath:(NSString*)fullPath fileSystemName:(NSString *)fsName isDirectory:(BOOL)isDir;\n- (NSDictionary *)makeEntryForURL:(NSURL *)URL;\n- (CDVFilesystemURL *)fileSystemURLforLocalPath:(NSString *)localPath;\n\n- (NSObject *)filesystemForURL:(CDVFilesystemURL *)localURL;\n\n/* Native Registration API */\n- (void)registerFilesystem:(NSObject *)fs;\n- (NSObject *)fileSystemByName:(NSString *)fsName;\n\n/* Exec API */\n- (void)requestFileSystem:(CDVInvokedUrlCommand*)command;\n- (void)resolveLocalFileSystemURI:(CDVInvokedUrlCommand*)command;\n- (void)getDirectory:(CDVInvokedUrlCommand*)command;\n- (void)getFile:(CDVInvokedUrlCommand*)command;\n- (void)getParent:(CDVInvokedUrlCommand*)command;\n- (void)removeRecursively:(CDVInvokedUrlCommand*)command;\n- (void)remove:(CDVInvokedUrlCommand*)command;\n- (void)copyTo:(CDVInvokedUrlCommand*)command;\n- (void)moveTo:(CDVInvokedUrlCommand*)command;\n- (void)getFileMetadata:(CDVInvokedUrlCommand*)command;\n- (void)readEntries:(CDVInvokedUrlCommand*)command;\n- (void)readAsText:(CDVInvokedUrlCommand*)command;\n- (void)readAsDataURL:(CDVInvokedUrlCommand*)command;\n- (void)readAsArrayBuffer:(CDVInvokedUrlCommand*)command;\n- (void)write:(CDVInvokedUrlCommand*)command;\n- (void)testFileExists:(CDVInvokedUrlCommand*)command;\n- (void)testDirectoryExists:(CDVInvokedUrlCommand*)command;\n- (void)getFreeDiskSpace:(CDVInvokedUrlCommand*)command;\n- (void)truncate:(CDVInvokedUrlCommand*)command;\n- (void)doCopyMove:(CDVInvokedUrlCommand*)command isCopy:(BOOL)bCopy;\n\n/* Compatibilty with older File API */\n- (NSString*)getMimeTypeFromPath:(NSString*)fullPath;\n- (NSDictionary *)getDirectoryEntry:(NSString *)target isDirectory:(BOOL)bDirRequest;\n\n/* Conversion between filesystem paths and URLs */\n- (NSString *)filesystemPathForURL:(CDVFilesystemURL *)URL;\n\n/* Internal methods for testing */\n- (void)_getLocalFilesystemPath:(CDVInvokedUrlCommand*)command;\n\n@property (nonatomic, strong) NSString* rootDocsPath;\n@property (nonatomic, strong) NSString* appDocsPath;\n@property (nonatomic, strong) NSString* appLibraryPath;\n@property (nonatomic, strong) NSString* appTempPath;\n@property (nonatomic, strong) NSString* persistentPath;\n@property (nonatomic, strong) NSString* temporaryPath;\n@property (nonatomic, strong) NSMutableArray* fileSystems;\n\n@property BOOL userHasAllowed;\n\n@end\n\n#define kW3FileTemporary @\"temporary\"\n#define kW3FilePersistent @\"persistent\"\n"
},
{
"path": "plugins/cordova-plugin-file/src/ios/CDVFile.m",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\n\n#import \n#import \"CDVFile.h\"\n#import \"CDVLocalFilesystem.h\"\n#import \"CDVAssetLibraryFilesystem.h\"\n#import \n\nstatic NSString* toBase64(NSData* data) {\n SEL s1 = NSSelectorFromString(@\"cdv_base64EncodedString\");\n SEL s2 = NSSelectorFromString(@\"base64EncodedString\");\n SEL s3 = NSSelectorFromString(@\"base64EncodedStringWithOptions:\");\n \n if ([data respondsToSelector:s1]) {\n NSString* (*func)(id, SEL) = (void *)[data methodForSelector:s1];\n return func(data, s1);\n } else if ([data respondsToSelector:s2]) {\n NSString* (*func)(id, SEL) = (void *)[data methodForSelector:s2];\n return func(data, s2);\n } else if ([data respondsToSelector:s3]) {\n NSString* (*func)(id, SEL, NSUInteger) = (void *)[data methodForSelector:s3];\n return func(data, s3, 0);\n } else {\n return nil;\n }\n}\n\nCDVFile *filePlugin = nil;\n\nextern NSString * const NSURLIsExcludedFromBackupKey __attribute__((weak_import));\n\n#ifndef __IPHONE_5_1\n NSString* const NSURLIsExcludedFromBackupKey = @\"NSURLIsExcludedFromBackupKey\";\n#endif\n\nNSString* const kCDVFilesystemURLPrefix = @\"cdvfile\";\n\n@implementation CDVFilesystemURL\n@synthesize url=_url;\n@synthesize fileSystemName=_fileSystemName;\n@synthesize fullPath=_fullPath;\n\n- (id) initWithString:(NSString *)strURL\n{\n if ( self = [super init] ) {\n NSURL *decodedURL = [NSURL URLWithString:strURL];\n return [self initWithURL:decodedURL];\n }\n return nil;\n}\n\n-(id) initWithURL:(NSURL *)URL\n{\n if ( self = [super init] ) {\n self.url = URL;\n self.fileSystemName = [self filesystemNameForLocalURI:URL];\n self.fullPath = [self fullPathForLocalURI:URL];\n }\n return self;\n}\n\n/*\n * IN\n * NSString localURI\n * OUT\n * NSString FileSystem Name for this URI, or nil if it is not recognized.\n */\n- (NSString *)filesystemNameForLocalURI:(NSURL *)uri\n{\n if ([[uri scheme] isEqualToString:kCDVFilesystemURLPrefix] && [[uri host] isEqualToString:@\"localhost\"]) {\n NSArray *pathComponents = [uri pathComponents];\n if (pathComponents != nil && pathComponents.count > 1) {\n return [pathComponents objectAtIndex:1];\n }\n } else if ([[uri scheme] isEqualToString:kCDVAssetsLibraryScheme]) {\n return @\"assets-library\";\n }\n return nil;\n}\n\n/*\n * IN\n * NSString localURI\n * OUT\n * NSString fullPath component suitable for an Entry object.\n * The incoming URI should be properly escaped. The returned fullPath is unescaped.\n */\n- (NSString *)fullPathForLocalURI:(NSURL *)uri\n{\n if ([[uri scheme] isEqualToString:kCDVFilesystemURLPrefix] && [[uri host] isEqualToString:@\"localhost\"]) {\n NSString *path = [uri path];\n if ([uri query]) {\n path = [NSString stringWithFormat:@\"%@?%@\", path, [uri query]];\n }\n NSRange slashRange = [path rangeOfString:@\"/\" options:0 range:NSMakeRange(1, path.length-1)];\n if (slashRange.location == NSNotFound) {\n return @\"\";\n }\n return [path substringFromIndex:slashRange.location];\n } else if ([[uri scheme] isEqualToString:kCDVAssetsLibraryScheme]) {\n return [[uri absoluteString] substringFromIndex:[kCDVAssetsLibraryScheme length]+2];\n }\n return nil;\n}\n\n+ (CDVFilesystemURL *)fileSystemURLWithString:(NSString *)strURL\n{\n return [[CDVFilesystemURL alloc] initWithString:strURL];\n}\n\n+ (CDVFilesystemURL *)fileSystemURLWithURL:(NSURL *)URL\n{\n return [[CDVFilesystemURL alloc] initWithURL:URL];\n}\n\n- (NSString *)absoluteURL\n{\n return [NSString stringWithFormat:@\"cdvfile://localhost/%@%@\", self.fileSystemName, self.fullPath];\n}\n\n@end\n\n@implementation CDVFilesystemURLProtocol\n\n+ (BOOL)canInitWithRequest:(NSURLRequest*)request\n{\n NSURL* url = [request URL];\n return [[url scheme] isEqualToString:kCDVFilesystemURLPrefix];\n}\n\n+ (NSURLRequest*)canonicalRequestForRequest:(NSURLRequest*)request\n{\n return request;\n}\n\n+ (BOOL)requestIsCacheEquivalent:(NSURLRequest*)requestA toRequest:(NSURLRequest*)requestB\n{\n return [[[requestA URL] resourceSpecifier] isEqualToString:[[requestB URL] resourceSpecifier]];\n}\n\n- (void)startLoading\n{\n CDVFilesystemURL* url = [CDVFilesystemURL fileSystemURLWithURL:[[self request] URL]];\n NSObject *fs = [filePlugin filesystemForURL:url];\n __weak CDVFilesystemURLProtocol* weakSelf = self;\n \n [fs readFileAtURL:url start:0 end:-1 callback:^void(NSData *data, NSString *mimetype, CDVFileError error) {\n NSMutableDictionary* responseHeaders = [[NSMutableDictionary alloc] init];\n responseHeaders[@\"Cache-Control\"] = @\"no-cache\";\n\n if (!error) {\n responseHeaders[@\"Content-Type\"] = mimetype;\n NSURLResponse *response = [[NSHTTPURLResponse alloc] initWithURL:url.url statusCode:200 HTTPVersion:@\"HTTP/1.1\"headerFields:responseHeaders];\n [[weakSelf client] URLProtocol:weakSelf didReceiveResponse:response cacheStoragePolicy:NSURLCacheStorageNotAllowed];\n [[weakSelf client] URLProtocol:weakSelf didLoadData:data];\n [[weakSelf client] URLProtocolDidFinishLoading:weakSelf];\n } else {\n NSURLResponse *response = [[NSHTTPURLResponse alloc] initWithURL:url.url statusCode:404 HTTPVersion:@\"HTTP/1.1\"headerFields:responseHeaders];\n [[weakSelf client] URLProtocol:weakSelf didReceiveResponse:response cacheStoragePolicy:NSURLCacheStorageNotAllowed];\n [[weakSelf client] URLProtocolDidFinishLoading:weakSelf];\n }\n }];\n}\n\n- (void)stopLoading\n{}\n\n- (NSCachedURLResponse *)connection:(NSURLConnection *)connection\n willCacheResponse:(NSCachedURLResponse*)cachedResponse {\n return nil;\n}\n\n@end\n\n\n@implementation CDVFile\n\n@synthesize rootDocsPath, appDocsPath, appLibraryPath, appTempPath, userHasAllowed, fileSystems=fileSystems_;\n\n- (void)registerFilesystem:(NSObject *)fs {\n __weak CDVFile* weakSelf = self;\n SEL sel = NSSelectorFromString(@\"urlTransformer\");\n // for backwards compatibility - we check if this property is there\n // we create a wrapper block because the urlTransformer property\n // on the commandDelegate might be set dynamically at a future time\n // (and not dependent on plugin loading order)\n if ([self.commandDelegate respondsToSelector:sel]) {\n fs.urlTransformer = ^NSURL*(NSURL* urlToTransform) {\n // grab the block from the commandDelegate\n NSURL* (^urlTransformer)(NSURL*) = ((id(*)(id, SEL))objc_msgSend)(weakSelf.commandDelegate, sel);\n // if block is not null, we call it\n if (urlTransformer) {\n return urlTransformer(urlToTransform);\n } else { // else we return the same url\n return urlToTransform;\n }\n };\n }\n [fileSystems_ addObject:fs];\n}\n\n- (NSObject *)fileSystemByName:(NSString *)fsName\n{\n if (self.fileSystems != nil) {\n for (NSObject *fs in self.fileSystems) {\n if ([fs.name isEqualToString:fsName]) {\n return fs;\n }\n }\n }\n return nil;\n}\n\n- (NSObject *)filesystemForURL:(CDVFilesystemURL *)localURL {\n if (localURL.fileSystemName == nil) return nil;\n @try {\n return [self fileSystemByName:localURL.fileSystemName];\n }\n @catch (NSException *e) {\n return nil;\n }\n}\n\n- (NSArray *)getExtraFileSystemsPreference:(UIViewController *)vc\n{\n NSString *filesystemsStr = nil;\n if([self.viewController isKindOfClass:[CDVViewController class]]) {\n CDVViewController *vc = (CDVViewController *)self.viewController;\n NSDictionary *settings = [vc settings];\n filesystemsStr = [settings[@\"iosextrafilesystems\"] lowercaseString];\n }\n if (!filesystemsStr) {\n filesystemsStr = @\"library,library-nosync,documents,documents-nosync,cache,bundle,root\";\n }\n return [filesystemsStr componentsSeparatedByString:@\",\"];\n}\n\n- (void)makeNonSyncable:(NSString*)path {\n [[NSFileManager defaultManager] createDirectoryAtPath:path\n withIntermediateDirectories:YES\n attributes:nil\n error:nil];\n NSURL* url = [NSURL fileURLWithPath:path];\n [url setResourceValue: [NSNumber numberWithBool: YES]\n forKey: NSURLIsExcludedFromBackupKey error:nil];\n\n}\n\n- (void)registerExtraFileSystems:(NSArray *)filesystems fromAvailableSet:(NSDictionary *)availableFileSystems\n{\n NSMutableSet *installedFilesystems = [[NSMutableSet alloc] initWithCapacity:7];\n\n /* Build non-syncable directories as necessary */\n for (NSString *nonSyncFS in @[@\"library-nosync\", @\"documents-nosync\"]) {\n if ([filesystems containsObject:nonSyncFS]) {\n [self makeNonSyncable:availableFileSystems[nonSyncFS]];\n }\n }\n\n /* Register filesystems in order */\n for (NSString *fsName in filesystems) {\n if (![installedFilesystems containsObject:fsName]) {\n NSString *fsRoot = availableFileSystems[fsName];\n if (fsRoot) {\n [filePlugin registerFilesystem:[[CDVLocalFilesystem alloc] initWithName:fsName root:fsRoot]];\n [installedFilesystems addObject:fsName];\n } else {\n NSLog(@\"Unrecognized extra filesystem identifier: %@\", fsName);\n }\n }\n }\n}\n\n- (NSDictionary *)getAvailableFileSystems\n{\n NSString *libPath = [NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES) objectAtIndex:0];\n NSString *docPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) objectAtIndex:0];\n return @{\n @\"library\": libPath,\n @\"library-nosync\": [libPath stringByAppendingPathComponent:@\"NoCloud\"],\n @\"documents\": docPath,\n @\"documents-nosync\": [docPath stringByAppendingPathComponent:@\"NoCloud\"],\n @\"cache\": [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) objectAtIndex:0],\n @\"bundle\": [[NSBundle mainBundle] bundlePath],\n @\"root\": @\"/\"\n };\n}\n\n- (void)pluginInitialize\n{\n filePlugin = self;\n [NSURLProtocol registerClass:[CDVFilesystemURLProtocol class]];\n\n fileSystems_ = [[NSMutableArray alloc] initWithCapacity:3];\n\n // Get the Library directory path\n NSArray* paths = NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES);\n self.appLibraryPath = [[paths objectAtIndex:0] stringByAppendingPathComponent:@\"files\"];\n\n // Get the Temporary directory path\n self.appTempPath = [NSTemporaryDirectory()stringByStandardizingPath]; // remove trailing slash from NSTemporaryDirectory()\n\n // Get the Documents directory path\n paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);\n self.rootDocsPath = [paths objectAtIndex:0];\n self.appDocsPath = [self.rootDocsPath stringByAppendingPathComponent:@\"files\"];\n\n\n NSString *location = nil;\n if([self.viewController isKindOfClass:[CDVViewController class]]) {\n CDVViewController *vc = (CDVViewController *)self.viewController;\n NSMutableDictionary *settings = vc.settings;\n location = [[settings objectForKey:@\"iospersistentfilelocation\"] lowercaseString];\n }\n if (location == nil) {\n // Compatibilty by default (if the config preference is not set, or\n // if we're not embedded in a CDVViewController somehow.)\n location = @\"compatibility\";\n }\n\n NSError *error;\n if ([[NSFileManager defaultManager] createDirectoryAtPath:self.appTempPath\n withIntermediateDirectories:YES\n attributes:nil\n error:&error]) {\n [self registerFilesystem:[[CDVLocalFilesystem alloc] initWithName:@\"temporary\" root:self.appTempPath]];\n } else {\n NSLog(@\"Unable to create temporary directory: %@\", error);\n }\n if ([location isEqualToString:@\"library\"]) {\n if ([[NSFileManager defaultManager] createDirectoryAtPath:self.appLibraryPath\n withIntermediateDirectories:YES\n attributes:nil\n error:&error]) {\n [self registerFilesystem:[[CDVLocalFilesystem alloc] initWithName:@\"persistent\" root:self.appLibraryPath]];\n } else {\n NSLog(@\"Unable to create library directory: %@\", error);\n }\n } else if ([location isEqualToString:@\"compatibility\"]) {\n /*\n * Fall-back to compatibility mode -- this is the logic implemented in\n * earlier versions of this plugin, and should be maintained here so\n * that apps which were originally deployed with older versions of the\n * plugin can continue to provide access to files stored under those\n * versions.\n */\n [self registerFilesystem:[[CDVLocalFilesystem alloc] initWithName:@\"persistent\" root:self.rootDocsPath]];\n } else {\n NSAssert(false,\n @\"File plugin configuration error: Please set iosPersistentFileLocation in config.xml to one of \\\"library\\\" (for new applications) or \\\"compatibility\\\" (for compatibility with previous versions)\");\n }\n [self registerFilesystem:[[CDVAssetLibraryFilesystem alloc] initWithName:@\"assets-library\"]];\n\n [self registerExtraFileSystems:[self getExtraFileSystemsPreference:self.viewController]\n fromAvailableSet:[self getAvailableFileSystems]];\n\n}\n\n- (CDVFilesystemURL *)fileSystemURLforArg:(NSString *)urlArg\n{\n CDVFilesystemURL* ret = nil;\n if ([urlArg hasPrefix:@\"file://\"]) {\n /* This looks like a file url. Get the path, and see if any handlers recognize it. */\n NSURL *fileURL = [NSURL URLWithString:urlArg];\n NSURL *resolvedFileURL = [fileURL URLByResolvingSymlinksInPath];\n NSString *path = [resolvedFileURL path];\n ret = [self fileSystemURLforLocalPath:path];\n } else {\n ret = [CDVFilesystemURL fileSystemURLWithString:urlArg];\n }\n return ret;\n}\n\n- (CDVFilesystemURL *)fileSystemURLforLocalPath:(NSString *)localPath\n{\n CDVFilesystemURL *localURL = nil;\n NSUInteger shortestFullPath = 0;\n\n // Try all installed filesystems, in order. Return the most match url.\n for (id object in self.fileSystems) {\n if ([object respondsToSelector:@selector(URLforFilesystemPath:)]) {\n CDVFilesystemURL *url = [object URLforFilesystemPath:localPath];\n if (url){\n // A shorter fullPath would imply that the filesystem is a better match for the local path\n if (!localURL || ([[url fullPath] length] < shortestFullPath)) {\n localURL = url;\n shortestFullPath = [[url fullPath] length];\n }\n }\n }\n }\n return localURL;\n}\n\n- (NSNumber*)checkFreeDiskSpace:(NSString*)appPath\n{\n NSFileManager* fMgr = [[NSFileManager alloc] init];\n\n NSError* __autoreleasing pError = nil;\n\n NSDictionary* pDict = [fMgr attributesOfFileSystemForPath:appPath error:&pError];\n NSNumber* pNumAvail = (NSNumber*)[pDict objectForKey:NSFileSystemFreeSize];\n\n return pNumAvail;\n}\n\n/* Request the File System info\n *\n * IN:\n * arguments[0] - type (number as string)\n *\tTEMPORARY = 0, PERSISTENT = 1;\n * arguments[1] - size\n *\n * OUT:\n *\tDictionary representing FileSystem object\n *\t\tname - the human readable directory name\n *\t\troot = DirectoryEntry object\n *\t\t\tbool isDirectory\n *\t\t\tbool isFile\n *\t\t\tstring name\n *\t\t\tstring fullPath\n *\t\t\tfileSystem = FileSystem object - !! ignored because creates circular reference !!\n */\n\n- (void)requestFileSystem:(CDVInvokedUrlCommand*)command\n{\n // arguments\n NSString* strType = [command argumentAtIndex:0];\n unsigned long long size = [[command argumentAtIndex:1] longLongValue];\n\n int type = [strType intValue];\n CDVPluginResult* result = nil;\n\n if (type >= self.fileSystems.count) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:NOT_FOUND_ERR];\n NSLog(@\"No filesystem of type requested\");\n } else {\n NSString* fullPath = @\"/\";\n // check for avail space for size request\n NSNumber* pNumAvail = [self checkFreeDiskSpace:self.rootDocsPath];\n // NSLog(@\"Free space: %@\", [NSString stringWithFormat:@\"%qu\", [ pNumAvail unsignedLongLongValue ]]);\n if (pNumAvail && ([pNumAvail unsignedLongLongValue] < size)) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:QUOTA_EXCEEDED_ERR];\n } else {\n NSObject *rootFs = [self.fileSystems objectAtIndex:type];\n if (rootFs == nil) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:NOT_FOUND_ERR];\n NSLog(@\"No filesystem of type requested\");\n } else {\n NSMutableDictionary* fileSystem = [NSMutableDictionary dictionaryWithCapacity:2];\n [fileSystem setObject:rootFs.name forKey:@\"name\"];\n NSDictionary* dirEntry = [self makeEntryForPath:fullPath fileSystemName:rootFs.name isDirectory:YES];\n [fileSystem setObject:dirEntry forKey:@\"root\"];\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:fileSystem];\n }\n }\n }\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n\n- (void)requestAllFileSystems:(CDVInvokedUrlCommand*)command\n{\n NSMutableArray* ret = [[NSMutableArray alloc] init];\n for (NSObject* root in fileSystems_) {\n [ret addObject:[self makeEntryForPath:@\"/\" fileSystemName:root.name isDirectory:YES]];\n }\n CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsArray:ret];\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n- (void)requestAllPaths:(CDVInvokedUrlCommand*)command\n{\n NSString* libPath = NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES)[0];\n NSString* libPathSync = [libPath stringByAppendingPathComponent:@\"Cloud\"];\n NSString* libPathNoSync = [libPath stringByAppendingPathComponent:@\"NoCloud\"];\n NSString* docPath = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)[0];\n NSString* storagePath = [libPath stringByDeletingLastPathComponent];\n NSString* cachePath = NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES)[0];\n\n // Create the directories if necessary.\n [[NSFileManager defaultManager] createDirectoryAtPath:libPathSync withIntermediateDirectories:YES attributes:nil error:nil];\n [[NSFileManager defaultManager] createDirectoryAtPath:libPathNoSync withIntermediateDirectories:YES attributes:nil error:nil];\n // Mark NoSync as non-iCloud.\n [[NSURL fileURLWithPath:libPathNoSync] setResourceValue: [NSNumber numberWithBool: YES]\n forKey: NSURLIsExcludedFromBackupKey error:nil];\n\n NSDictionary* ret = @{\n @\"applicationDirectory\": [[NSURL fileURLWithPath:[[NSBundle mainBundle] bundlePath]] absoluteString],\n @\"applicationStorageDirectory\": [[NSURL fileURLWithPath:storagePath] absoluteString],\n @\"dataDirectory\": [[NSURL fileURLWithPath:libPathNoSync] absoluteString],\n @\"syncedDataDirectory\": [[NSURL fileURLWithPath:libPathSync] absoluteString],\n @\"documentsDirectory\": [[NSURL fileURLWithPath:docPath] absoluteString],\n @\"cacheDirectory\": [[NSURL fileURLWithPath:cachePath] absoluteString],\n @\"tempDirectory\": [[NSURL fileURLWithPath:NSTemporaryDirectory()] absoluteString]\n };\n\n CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:ret];\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n/* Creates and returns a dictionary representing an Entry Object\n *\n * IN:\n * NSString* fullPath of the entry\n * int fsType - FileSystem type\n * BOOL isDirectory - YES if this is a directory, NO if is a file\n * OUT:\n * NSDictionary* Entry object\n *\t\tbool as NSNumber isDirectory\n *\t\tbool as NSNumber isFile\n *\t\tNSString* name - last part of path\n *\t\tNSString* fullPath\n *\t\tNSString* filesystemName - FileSystem name -- actual filesystem will be created on the JS side if necessary, to avoid\n * creating circular reference (FileSystem contains DirectoryEntry which contains FileSystem.....!!)\n */\n- (NSDictionary*)makeEntryForPath:(NSString*)fullPath fileSystemName:(NSString *)fsName isDirectory:(BOOL)isDir\n{\n NSObject *fs = [self fileSystemByName:fsName];\n return [fs makeEntryForPath:fullPath isDirectory:isDir];\n}\n\n- (NSDictionary *)makeEntryForLocalURL:(CDVFilesystemURL *)localURL\n{\n NSObject *fs = [self filesystemForURL:localURL];\n return [fs makeEntryForLocalURL:localURL];\n}\n\n- (NSDictionary *)makeEntryForURL:(NSURL *)URL\n{\n CDVFilesystemURL* fsURL = [self fileSystemURLforArg:[URL absoluteString]];\n return [self makeEntryForLocalURL:fsURL];\n}\n\n/*\n * Given a URI determine the File System information associated with it and return an appropriate W3C entry object\n * IN\n *\tNSString* localURI: Should be an escaped local filesystem URI\n * OUT\n *\tEntry object\n *\t\tbool isDirectory\n *\t\tbool isFile\n *\t\tstring name\n *\t\tstring fullPath\n *\t\tfileSystem = FileSystem object - !! ignored because creates circular reference FileSystem contains DirectoryEntry which contains FileSystem.....!!\n */\n- (void)resolveLocalFileSystemURI:(CDVInvokedUrlCommand*)command\n{\n // arguments\n NSString* localURIstr = [command argumentAtIndex:0];\n CDVPluginResult* result;\n\n localURIstr = [self encodePath:localURIstr]; //encode path before resolving\n CDVFilesystemURL* inputURI = [self fileSystemURLforArg:localURIstr];\n\n if (inputURI == nil || inputURI.fileSystemName == nil) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:ENCODING_ERR];\n } else {\n NSObject *fs = [self filesystemForURL:inputURI];\n if (fs == nil) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:ENCODING_ERR];\n } else {\n result = [fs entryForLocalURI:inputURI];\n }\n }\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n//encode path with percent escapes\n-(NSString *)encodePath:(NSString *)path\n{\n NSString *decodedPath = [path stringByReplacingPercentEscapesUsingEncoding:NSUTF8StringEncoding]; //decode incase it's already encoded to avoid encoding twice\n return [decodedPath stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];\n}\n\n\n/* Part of DirectoryEntry interface, creates or returns the specified directory\n * IN:\n *\tNSString* localURI - local filesystem URI for this directory\n *\tNSString* path - directory to be created/returned; may be full path or relative path\n *\tNSDictionary* - Flags object\n *\t\tboolean as NSNumber create -\n *\t\t\tif create is true and directory does not exist, create dir and return directory entry\n *\t\t\tif create is true and exclusive is true and directory does exist, return error\n *\t\t\tif create is false and directory does not exist, return error\n *\t\t\tif create is false and the path represents a file, return error\n *\t\tboolean as NSNumber exclusive - used in conjunction with create\n *\t\t\tif exclusive is true and create is true - specifies failure if directory already exists\n *\n *\n */\n- (void)getDirectory:(CDVInvokedUrlCommand*)command\n{\n NSMutableArray* arguments = [NSMutableArray arrayWithArray:command.arguments];\n NSMutableDictionary* options = nil;\n\n if ([arguments count] >= 3) {\n options = [command argumentAtIndex:2 withDefault:nil];\n }\n // add getDir to options and call getFile()\n if (options != nil) {\n options = [NSMutableDictionary dictionaryWithDictionary:options];\n } else {\n options = [NSMutableDictionary dictionaryWithCapacity:1];\n }\n [options setObject:[NSNumber numberWithInt:1] forKey:@\"getDir\"];\n if ([arguments count] >= 3) {\n [arguments replaceObjectAtIndex:2 withObject:options];\n } else {\n [arguments addObject:options];\n }\n CDVInvokedUrlCommand* subCommand =\n [[CDVInvokedUrlCommand alloc] initWithArguments:arguments\n callbackId:command.callbackId\n className:command.className\n methodName:command.methodName];\n\n [self getFile:subCommand];\n}\n\n/* Part of DirectoryEntry interface, creates or returns the specified file\n * IN:\n *\tNSString* baseURI - local filesytem URI for the base directory to search\n *\tNSString* requestedPath - file to be created/returned; may be absolute path or relative path\n *\tNSDictionary* options - Flags object\n *\t\tboolean as NSNumber create -\n *\t\t\tif create is true and file does not exist, create file and return File entry\n *\t\t\tif create is true and exclusive is true and file does exist, return error\n *\t\t\tif create is false and file does not exist, return error\n *\t\t\tif create is false and the path represents a directory, return error\n *\t\tboolean as NSNumber exclusive - used in conjunction with create\n *\t\t\tif exclusive is true and create is true - specifies failure if file already exists\n */\n- (void)getFile:(CDVInvokedUrlCommand*)command\n{\n NSString* baseURIstr = [command argumentAtIndex:0];\n CDVFilesystemURL* baseURI = [self fileSystemURLforArg:baseURIstr];\n NSString* requestedPath = [command argumentAtIndex:1];\n NSDictionary* options = [command argumentAtIndex:2 withDefault:nil];\n\n NSObject *fs = [self filesystemForURL:baseURI];\n CDVPluginResult* result = [fs getFileForURL:baseURI requestedPath:requestedPath options:options];\n\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n/*\n * Look up the parent Entry containing this Entry.\n * If this Entry is the root of its filesystem, its parent is itself.\n * IN:\n * NSArray* arguments\n *\t0 - NSString* localURI\n * NSMutableDictionary* options\n *\tempty\n */\n- (void)getParent:(CDVInvokedUrlCommand*)command\n{\n // arguments are URL encoded\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n\n NSObject *fs = [self filesystemForURL:localURI];\n CDVPluginResult* result = [fs getParentForURL:localURI];\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n/*\n * set MetaData of entry\n * Currently we only support \"com.apple.MobileBackup\" (boolean)\n */\n- (void)setMetadata:(CDVInvokedUrlCommand*)command\n{\n // arguments\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n NSDictionary* options = [command argumentAtIndex:1 withDefault:nil];\n NSObject *fs = [self filesystemForURL:localURI];\n CDVPluginResult* result = [fs setMetadataForURL:localURI withObject:options];\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n/* removes the directory or file entry\n * IN:\n * NSArray* arguments\n *\t0 - NSString* localURI\n *\n * returns NO_MODIFICATION_ALLOWED_ERR if is top level directory or no permission to delete dir\n * returns INVALID_MODIFICATION_ERR if is non-empty dir or asset library file\n * returns NOT_FOUND_ERR if file or dir is not found\n*/\n- (void)remove:(CDVInvokedUrlCommand*)command\n{\n // arguments\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n CDVPluginResult* result = nil;\n\n if ([localURI.fullPath isEqualToString:@\"\"]) {\n // error if try to remove top level (documents or tmp) dir\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NO_MODIFICATION_ALLOWED_ERR];\n } else {\n NSObject *fs = [self filesystemForURL:localURI];\n result = [fs removeFileAtURL:localURI];\n }\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n/* recursively removes the directory\n * IN:\n * NSArray* arguments\n *\t0 - NSString* localURI\n *\n * returns NO_MODIFICATION_ALLOWED_ERR if is top level directory or no permission to delete dir\n * returns NOT_FOUND_ERR if file or dir is not found\n */\n- (void)removeRecursively:(CDVInvokedUrlCommand*)command\n{\n // arguments\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n CDVPluginResult* result = nil;\n\n if ([localURI.fullPath isEqualToString:@\"\"]) {\n // error if try to remove top level (documents or tmp) dir\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NO_MODIFICATION_ALLOWED_ERR];\n } else {\n NSObject *fs = [self filesystemForURL:localURI];\n result = [fs recursiveRemoveFileAtURL:localURI];\n }\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n- (void)copyTo:(CDVInvokedUrlCommand*)command\n{\n [self doCopyMove:command isCopy:YES];\n}\n\n- (void)moveTo:(CDVInvokedUrlCommand*)command\n{\n [self doCopyMove:command isCopy:NO];\n}\n\n/* Copy/move a file or directory to a new location\n * IN:\n * NSArray* arguments\n *\t0 - NSString* URL of entry to copy\n * 1 - NSString* URL of the directory into which to copy/move the entry\n * 2 - Optionally, the new name of the entry, defaults to the current name\n *\tBOOL - bCopy YES if copy, NO if move\n */\n- (void)doCopyMove:(CDVInvokedUrlCommand*)command isCopy:(BOOL)bCopy\n{\n NSArray* arguments = command.arguments;\n\n // arguments\n NSString* srcURLstr = [command argumentAtIndex:0];\n NSString* destURLstr = [command argumentAtIndex:1];\n\n CDVPluginResult *result;\n\n if (!srcURLstr || !destURLstr) {\n // either no source or no destination provided\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NOT_FOUND_ERR];\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n return;\n }\n\n CDVFilesystemURL* srcURL = [self fileSystemURLforArg:srcURLstr];\n CDVFilesystemURL* destURL = [self fileSystemURLforArg:destURLstr];\n\n NSObject *srcFs = [self filesystemForURL:srcURL];\n NSObject *destFs = [self filesystemForURL:destURL];\n\n // optional argument; use last component from srcFullPath if new name not provided\n NSString* newName = ([arguments count] > 2) ? [command argumentAtIndex:2] : [srcURL.url lastPathComponent];\n if ([newName rangeOfString:@\":\"].location != NSNotFound) {\n // invalid chars in new name\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:ENCODING_ERR];\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n return;\n }\n\n __weak CDVFile* weakSelf = self;\n [destFs copyFileToURL:destURL withName:newName fromFileSystem:srcFs atURL:srcURL copy:bCopy callback:^(CDVPluginResult* result) {\n [weakSelf.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n }];\n\n}\n\n- (void)getFileMetadata:(CDVInvokedUrlCommand*)command\n{\n // arguments\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n NSObject *fs = [self filesystemForURL:localURI];\n __weak CDVFile* weakSelf = self;\n [fs getFileMetadataForURL:localURI callback:^(CDVPluginResult* result) {\n [weakSelf.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n }];\n}\n\n- (void)readEntries:(CDVInvokedUrlCommand*)command\n{\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n NSObject *fs = [self filesystemForURL:localURI];\n CDVPluginResult *result = [fs readEntriesAtURL:localURI];\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n/* read and return file data\n * IN:\n * NSArray* arguments\n *\t0 - NSString* fullPath\n *\t1 - NSString* encoding\n *\t2 - NSString* start\n *\t3 - NSString* end\n */\n- (void)readAsText:(CDVInvokedUrlCommand*)command\n{\n // arguments\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n NSString* encoding = [command argumentAtIndex:1];\n NSInteger start = [[command argumentAtIndex:2] integerValue];\n NSInteger end = [[command argumentAtIndex:3] integerValue];\n\n NSObject *fs = [self filesystemForURL:localURI];\n\n if (fs == nil) {\n CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NOT_FOUND_ERR];\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n return;\n }\n\n // TODO: implement\n if ([@\"UTF-8\" caseInsensitiveCompare : encoding] != NSOrderedSame) {\n NSLog(@\"Only UTF-8 encodings are currently supported by readAsText\");\n CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:ENCODING_ERR];\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n return;\n }\n\n __weak CDVFile* weakSelf = self;\n\n [self.commandDelegate runInBackground:^ {\n [fs readFileAtURL:localURI start:start end:end callback:^(NSData* data, NSString* mimeType, CDVFileError errorCode) {\n CDVPluginResult* result = nil;\n if (data != nil) {\n NSString* str = [[NSString alloc] initWithBytesNoCopy:(void*)[data bytes] length:[data length] encoding:NSUTF8StringEncoding freeWhenDone:NO];\n // Check that UTF8 conversion did not fail.\n if (str != nil) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:str];\n result.associatedObject = data;\n } else {\n errorCode = ENCODING_ERR;\n }\n }\n if (result == nil) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:errorCode];\n }\n\n [weakSelf.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n }];\n }];\n}\n\n/* Read content of text file and return as base64 encoded data url.\n * IN:\n * NSArray* arguments\n *\t0 - NSString* fullPath\n *\t1 - NSString* start\n *\t2 - NSString* end\n *\n * Determines the mime type from the file extension, returns ENCODING_ERR if mimetype can not be determined.\n */\n\n- (void)readAsDataURL:(CDVInvokedUrlCommand*)command\n{\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n NSInteger start = [[command argumentAtIndex:1] integerValue];\n NSInteger end = [[command argumentAtIndex:2] integerValue];\n\n NSObject *fs = [self filesystemForURL:localURI];\n\n __weak CDVFile* weakSelf = self;\n [self.commandDelegate runInBackground:^ {\n [fs readFileAtURL:localURI start:start end:end callback:^(NSData* data, NSString* mimeType, CDVFileError errorCode) {\n CDVPluginResult* result = nil;\n if (data != nil) {\n NSString* b64Str = toBase64(data);\n NSString* output = [NSString stringWithFormat:@\"data:%@;base64,%@\", mimeType, b64Str];\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:output];\n } else {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:errorCode];\n }\n\n [weakSelf.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n }];\n }];\n}\n\n/* Read content of text file and return as an arraybuffer\n * IN:\n * NSArray* arguments\n *\t0 - NSString* fullPath\n *\t1 - NSString* start\n *\t2 - NSString* end\n */\n\n- (void)readAsArrayBuffer:(CDVInvokedUrlCommand*)command\n{\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n NSInteger start = [[command argumentAtIndex:1] integerValue];\n NSInteger end = [[command argumentAtIndex:2] integerValue];\n\n NSObject *fs = [self filesystemForURL:localURI];\n\n __weak CDVFile* weakSelf = self;\n\n [self.commandDelegate runInBackground:^ {\n [fs readFileAtURL:localURI start:start end:end callback:^(NSData* data, NSString* mimeType, CDVFileError errorCode) {\n CDVPluginResult* result = nil;\n if (data != nil) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsArrayBuffer:data];\n } else {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:errorCode];\n }\n\n [weakSelf.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n }];\n }];\n}\n\n- (void)readAsBinaryString:(CDVInvokedUrlCommand*)command\n{\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n NSInteger start = [[command argumentAtIndex:1] integerValue];\n NSInteger end = [[command argumentAtIndex:2] integerValue];\n\n NSObject *fs = [self filesystemForURL:localURI];\n\n __weak CDVFile* weakSelf = self;\n\n [self.commandDelegate runInBackground:^ {\n [fs readFileAtURL:localURI start:start end:end callback:^(NSData* data, NSString* mimeType, CDVFileError errorCode) {\n CDVPluginResult* result = nil;\n if (data != nil) {\n NSString* payload = [[NSString alloc] initWithBytesNoCopy:(void*)[data bytes] length:[data length] encoding:NSASCIIStringEncoding freeWhenDone:NO];\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload];\n result.associatedObject = data;\n } else {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:errorCode];\n }\n\n [weakSelf.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n }];\n }];\n}\n\n\n- (void)truncate:(CDVInvokedUrlCommand*)command\n{\n // arguments\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n unsigned long long pos = (unsigned long long)[[command argumentAtIndex:1] longLongValue];\n\n NSObject *fs = [self filesystemForURL:localURI];\n CDVPluginResult *result = [fs truncateFileAtURL:localURI atPosition:pos];\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n/* write\n * IN:\n * NSArray* arguments\n * 0 - NSString* localURI of file to write to\n * 1 - NSString* or NSData* data to write\n * 2 - NSNumber* position to begin writing\n */\n- (void)write:(CDVInvokedUrlCommand*)command\n{\n __weak CDVFile* weakSelf = self;\n\n [self.commandDelegate runInBackground:^ {\n NSString* callbackId = command.callbackId;\n\n // arguments\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n id argData = [command argumentAtIndex:1];\n unsigned long long pos = (unsigned long long)[[command argumentAtIndex:2] longLongValue];\n\n NSObject *fs = [self filesystemForURL:localURI];\n\n\n [fs truncateFileAtURL:localURI atPosition:pos];\n CDVPluginResult *result;\n if ([argData isKindOfClass:[NSString class]]) {\n NSData *encData = [argData dataUsingEncoding:NSUTF8StringEncoding allowLossyConversion:YES];\n result = [fs writeToFileAtURL:localURI withData:encData append:YES];\n } else if ([argData isKindOfClass:[NSData class]]) {\n result = [fs writeToFileAtURL:localURI withData:argData append:YES];\n } else {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@\"Invalid parameter type\"];\n }\n [weakSelf.commandDelegate sendPluginResult:result callbackId:callbackId];\n }];\n}\n\n#pragma mark Methods for converting between URLs and paths\n\n- (NSString *)filesystemPathForURL:(CDVFilesystemURL *)localURL\n{\n for (NSObject *fs in self.fileSystems) {\n if ([fs.name isEqualToString:localURL.fileSystemName]) {\n if ([fs respondsToSelector:@selector(filesystemPathForURL:)]) {\n return [fs filesystemPathForURL:localURL];\n }\n }\n }\n return nil;\n}\n\n#pragma mark Undocumented Filesystem API\n\n- (void)testFileExists:(CDVInvokedUrlCommand*)command\n{\n // arguments\n NSString* argPath = [command argumentAtIndex:0];\n\n // Get the file manager\n NSFileManager* fMgr = [NSFileManager defaultManager];\n NSString* appFile = argPath; // [ self getFullPath: argPath];\n\n BOOL bExists = [fMgr fileExistsAtPath:appFile];\n CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsInt:(bExists ? 1 : 0)];\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n- (void)testDirectoryExists:(CDVInvokedUrlCommand*)command\n{\n // arguments\n NSString* argPath = [command argumentAtIndex:0];\n\n // Get the file manager\n NSFileManager* fMgr = [[NSFileManager alloc] init];\n NSString* appFile = argPath; // [self getFullPath: argPath];\n BOOL bIsDir = NO;\n BOOL bExists = [fMgr fileExistsAtPath:appFile isDirectory:&bIsDir];\n\n CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsInt:((bExists && bIsDir) ? 1 : 0)];\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n// Returns number of bytes available via callback\n- (void)getFreeDiskSpace:(CDVInvokedUrlCommand*)command\n{\n // no arguments\n \n NSNumber* pNumAvail = [self checkFreeDiskSpace:self.rootDocsPath];\n\n NSString* strFreeSpace = [NSString stringWithFormat:@\"%qu\", [pNumAvail unsignedLongLongValue]];\n // NSLog(@\"Free space is %@\", strFreeSpace );\n\n CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:strFreeSpace];\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n#pragma mark Compatibility with older File API\n\n- (NSString*)getMimeTypeFromPath:(NSString*)fullPath\n{\n return [CDVLocalFilesystem getMimeTypeFromPath:fullPath];\n}\n\n- (NSDictionary *)getDirectoryEntry:(NSString *)localPath isDirectory:(BOOL)bDirRequest\n{\n CDVFilesystemURL *localURL = [self fileSystemURLforLocalPath:localPath];\n return [self makeEntryForPath:localURL.fullPath fileSystemName:localURL.fileSystemName isDirectory:bDirRequest];\n}\n\n#pragma mark Internal methods for testing\n// Internal methods for testing: Get the on-disk location of a local filesystem url.\n// [Currently used for testing file-transfer]\n\n- (void)_getLocalFilesystemPath:(CDVInvokedUrlCommand*)command\n{\n CDVFilesystemURL* localURL = [self fileSystemURLforArg:command.arguments[0]];\n\n NSString* fsPath = [self filesystemPathForURL:localURL];\n CDVPluginResult* result;\n if (fsPath) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:fsPath];\n } else {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@\"Cannot resolve URL to a file\"];\n }\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n@end\n"
},
{
"path": "plugins/cordova-plugin-file/src/ios/CDVLocalFilesystem.h",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\n\n#import \"CDVFile.h\"\n\n@interface CDVLocalFilesystem : NSObject {\n NSString *_name;\n NSString *_fsRoot;\n}\n\n- (id) initWithName:(NSString *)name root:(NSString *)fsRoot;\n+ (NSString*)getMimeTypeFromPath:(NSString*)fullPath;\n\n@property (nonatomic,strong) NSString *fsRoot;\n\n@end\n"
},
{
"path": "plugins/cordova-plugin-file/src/ios/CDVLocalFilesystem.m",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\n\n#import \"CDVFile.h\"\n#import \"CDVLocalFilesystem.h\"\n#import \n#import \n#import \n\n@implementation CDVLocalFilesystem\n@synthesize name=_name, fsRoot=_fsRoot, urlTransformer;\n\n- (id) initWithName:(NSString *)name root:(NSString *)fsRoot\n{\n if (self) {\n self.name = name;\n self.fsRoot = fsRoot;\n }\n return self;\n}\n\n/*\n * IN\n * NSString localURI\n * OUT\n * CDVPluginResult result containing a file or directoryEntry for the localURI, or an error if the\n * URI represents a non-existent path, or is unrecognized or otherwise malformed.\n */\n- (CDVPluginResult *)entryForLocalURI:(CDVFilesystemURL *)url\n{\n CDVPluginResult* result = nil;\n NSDictionary* entry = [self makeEntryForLocalURL:url];\n if (entry) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:entry];\n } else {\n // return NOT_FOUND_ERR\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NOT_FOUND_ERR];\n }\n return result;\n}\n- (NSDictionary *)makeEntryForLocalURL:(CDVFilesystemURL *)url {\n NSString *path = [self filesystemPathForURL:url];\n NSFileManager* fileMgr = [[NSFileManager alloc] init];\n BOOL isDir = NO;\n // see if exists and is file or dir\n BOOL bExists = [fileMgr fileExistsAtPath:path isDirectory:&isDir];\n if (bExists) {\n return [self makeEntryForPath:url.fullPath isDirectory:isDir];\n } else {\n return nil;\n }\n}\n- (NSDictionary*)makeEntryForPath:(NSString*)fullPath isDirectory:(BOOL)isDir\n{\n NSMutableDictionary* dirEntry = [NSMutableDictionary dictionaryWithCapacity:5];\n NSString* lastPart = [[self stripQueryParametersFromPath:fullPath] lastPathComponent];\n if (isDir && ![fullPath hasSuffix:@\"/\"]) {\n fullPath = [fullPath stringByAppendingString:@\"/\"];\n }\n [dirEntry setObject:[NSNumber numberWithBool:!isDir] forKey:@\"isFile\"];\n [dirEntry setObject:[NSNumber numberWithBool:isDir] forKey:@\"isDirectory\"];\n [dirEntry setObject:fullPath forKey:@\"fullPath\"];\n [dirEntry setObject:lastPart forKey:@\"name\"];\n [dirEntry setObject:self.name forKey: @\"filesystemName\"];\n\n NSURL* nativeURL = [NSURL fileURLWithPath:[self filesystemPathForFullPath:fullPath]];\n if (self.urlTransformer) {\n nativeURL = self.urlTransformer(nativeURL);\n }\n\n dirEntry[@\"nativeURL\"] = [nativeURL absoluteString];\n\n return dirEntry;\n}\n\n- (NSString *)stripQueryParametersFromPath:(NSString *)fullPath\n{\n NSRange questionMark = [fullPath rangeOfString:@\"?\"];\n if (questionMark.location != NSNotFound) {\n return [fullPath substringWithRange:NSMakeRange(0,questionMark.location)];\n }\n return fullPath;\n}\n\n- (NSString *)filesystemPathForFullPath:(NSString *)fullPath\n{\n NSString *path = nil;\n NSString *strippedFullPath = [self stripQueryParametersFromPath:fullPath];\n path = [NSString stringWithFormat:@\"%@%@\", self.fsRoot, strippedFullPath];\n if ([path length] > 1 && [path hasSuffix:@\"/\"]) {\n path = [path substringToIndex:([path length]-1)];\n }\n return path;\n}\n/*\n * IN\n * NSString localURI\n * OUT\n * NSString full local filesystem path for the represented file or directory, or nil if no such path is possible\n * The file or directory does not necessarily have to exist. nil is returned if the filesystem type is not recognized,\n * or if the URL is malformed.\n * The incoming URI should be properly escaped (no raw spaces, etc. URI percent-encoding is expected).\n */\n- (NSString *)filesystemPathForURL:(CDVFilesystemURL *)url\n{\n return [self filesystemPathForFullPath:url.fullPath];\n}\n\n- (CDVFilesystemURL *)URLforFullPath:(NSString *)fullPath\n{\n if (fullPath) {\n NSString* escapedPath = [fullPath stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];\n if ([fullPath hasPrefix:@\"/\"]) {\n return [CDVFilesystemURL fileSystemURLWithString:[NSString stringWithFormat:@\"%@://localhost/%@%@\", kCDVFilesystemURLPrefix, self.name, escapedPath]];\n }\n return [CDVFilesystemURL fileSystemURLWithString:[NSString stringWithFormat:@\"%@://localhost/%@/%@\", kCDVFilesystemURLPrefix, self.name, escapedPath]];\n }\n return nil;\n}\n\n- (CDVFilesystemURL *)URLforFilesystemPath:(NSString *)path\n{\n return [self URLforFullPath:[self fullPathForFileSystemPath:path]];\n\n}\n\n- (NSString *)normalizePath:(NSString *)rawPath\n{\n // If this is an absolute path, the first path component will be '/'. Skip it if that's the case\n BOOL isAbsolutePath = [rawPath hasPrefix:@\"/\"];\n if (isAbsolutePath) {\n rawPath = [rawPath substringFromIndex:1];\n }\n NSMutableArray *components = [NSMutableArray arrayWithArray:[rawPath pathComponents]];\n for (int index = 0; index < [components count]; ++index) {\n if ([[components objectAtIndex:index] isEqualToString:@\"..\"]) {\n [components removeObjectAtIndex:index];\n if (index > 0) {\n [components removeObjectAtIndex:index-1];\n --index;\n }\n }\n }\n\n if (isAbsolutePath) {\n return [NSString stringWithFormat:@\"/%@\", [components componentsJoinedByString:@\"/\"]];\n } else {\n return [components componentsJoinedByString:@\"/\"];\n }\n\n\n}\n\n- (BOOL)valueForKeyIsNumber:(NSDictionary*)dict key:(NSString*)key\n{\n BOOL bNumber = NO;\n NSObject* value = dict[key];\n if (value) {\n bNumber = [value isKindOfClass:[NSNumber class]];\n }\n return bNumber;\n}\n\n- (CDVPluginResult *)getFileForURL:(CDVFilesystemURL *)baseURI requestedPath:(NSString *)requestedPath options:(NSDictionary *)options\n{\n CDVPluginResult* result = nil;\n BOOL bDirRequest = NO;\n BOOL create = NO;\n BOOL exclusive = NO;\n int errorCode = 0; // !!! risky - no error code currently defined for 0\n\n if ([self valueForKeyIsNumber:options key:@\"create\"]) {\n create = [(NSNumber*)[options valueForKey:@\"create\"] boolValue];\n }\n if ([self valueForKeyIsNumber:options key:@\"exclusive\"]) {\n exclusive = [(NSNumber*)[options valueForKey:@\"exclusive\"] boolValue];\n }\n if ([self valueForKeyIsNumber:options key:@\"getDir\"]) {\n // this will not exist for calls directly to getFile but will have been set by getDirectory before calling this method\n bDirRequest = [(NSNumber*)[options valueForKey:@\"getDir\"] boolValue];\n }\n // see if the requested path has invalid characters - should we be checking for more than just \":\"?\n if ([requestedPath rangeOfString:@\":\"].location != NSNotFound) {\n errorCode = ENCODING_ERR;\n } else {\n // Build new fullPath for the requested resource.\n // We concatenate the two paths together, and then scan the resulting string to remove\n // parent (\"..\") references. Any parent references at the beginning of the string are\n // silently removed.\n NSString *combinedPath = [baseURI.fullPath stringByAppendingPathComponent:requestedPath];\n combinedPath = [self normalizePath:combinedPath];\n CDVFilesystemURL* requestedURL = [self URLforFullPath:combinedPath];\n\n NSFileManager* fileMgr = [[NSFileManager alloc] init];\n BOOL bIsDir;\n BOOL bExists = [fileMgr fileExistsAtPath:[self filesystemPathForURL:requestedURL] isDirectory:&bIsDir];\n if (bExists && (create == NO) && (bIsDir == !bDirRequest)) {\n // path exists and is not of requested type - return TYPE_MISMATCH_ERR\n errorCode = TYPE_MISMATCH_ERR;\n } else if (!bExists && (create == NO)) {\n // path does not exist and create is false - return NOT_FOUND_ERR\n errorCode = NOT_FOUND_ERR;\n } else if (bExists && (create == YES) && (exclusive == YES)) {\n // file/dir already exists and exclusive and create are both true - return PATH_EXISTS_ERR\n errorCode = PATH_EXISTS_ERR;\n } else {\n // if bExists and create == YES - just return data\n // if bExists and create == NO - just return data\n // if !bExists and create == YES - create and return data\n BOOL bSuccess = YES;\n NSError __autoreleasing* pError = nil;\n if (!bExists && (create == YES)) {\n if (bDirRequest) {\n // create the dir\n bSuccess = [fileMgr createDirectoryAtPath:[self filesystemPathForURL:requestedURL] withIntermediateDirectories:NO attributes:nil error:&pError];\n } else {\n // create the empty file\n bSuccess = [fileMgr createFileAtPath:[self filesystemPathForURL:requestedURL] contents:nil attributes:nil];\n }\n }\n if (!bSuccess) {\n errorCode = ABORT_ERR;\n if (pError) {\n NSLog(@\"error creating directory: %@\", [pError localizedDescription]);\n }\n } else {\n // NSLog(@\"newly created file/dir (%@) exists: %d\", reqFullPath, [fileMgr fileExistsAtPath:reqFullPath]);\n // file existed or was created\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:[self makeEntryForPath:requestedURL.fullPath isDirectory:bDirRequest]];\n }\n } // are all possible conditions met?\n }\n\n if (errorCode > 0) {\n // create error callback\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:errorCode];\n }\n return result;\n\n}\n\n- (CDVPluginResult*)getParentForURL:(CDVFilesystemURL *)localURI\n{\n CDVPluginResult* result = nil;\n CDVFilesystemURL *newURI = nil;\n if ([localURI.fullPath isEqualToString:@\"\"]) {\n // return self\n newURI = localURI;\n } else {\n newURI = [CDVFilesystemURL fileSystemURLWithURL:[localURI.url URLByDeletingLastPathComponent]]; /* TODO: UGLY - FIX */\n }\n NSFileManager* fileMgr = [[NSFileManager alloc] init];\n BOOL bIsDir;\n BOOL bExists = [fileMgr fileExistsAtPath:[self filesystemPathForURL:newURI] isDirectory:&bIsDir];\n if (bExists) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:[self makeEntryForPath:newURI.fullPath isDirectory:bIsDir]];\n } else {\n // invalid path or file does not exist\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NOT_FOUND_ERR];\n }\n return result;\n}\n\n- (CDVPluginResult*)setMetadataForURL:(CDVFilesystemURL *)localURI withObject:(NSDictionary *)options\n{\n BOOL ok = NO;\n\n NSString* filePath = [self filesystemPathForURL:localURI];\n // we only care about this iCloud key for now.\n // set to 1/true to skip backup, set to 0/false to back it up (effectively removing the attribute)\n NSString* iCloudBackupExtendedAttributeKey = @\"com.apple.MobileBackup\";\n id iCloudBackupExtendedAttributeValue = [options objectForKey:iCloudBackupExtendedAttributeKey];\n\n if ((iCloudBackupExtendedAttributeValue != nil) && [iCloudBackupExtendedAttributeValue isKindOfClass:[NSNumber class]]) {\n if (IsAtLeastiOSVersion(@\"5.1\")) {\n NSURL* url = [NSURL fileURLWithPath:filePath];\n NSError* __autoreleasing error = nil;\n\n ok = [url setResourceValue:[NSNumber numberWithBool:[iCloudBackupExtendedAttributeValue boolValue]] forKey:NSURLIsExcludedFromBackupKey error:&error];\n } else { // below 5.1 (deprecated - only really supported in 5.01)\n u_int8_t value = [iCloudBackupExtendedAttributeValue intValue];\n if (value == 0) { // remove the attribute (allow backup, the default)\n ok = (removexattr([filePath fileSystemRepresentation], [iCloudBackupExtendedAttributeKey cStringUsingEncoding:NSUTF8StringEncoding], 0) == 0);\n } else { // set the attribute (skip backup)\n ok = (setxattr([filePath fileSystemRepresentation], [iCloudBackupExtendedAttributeKey cStringUsingEncoding:NSUTF8StringEncoding], &value, sizeof(value), 0, 0) == 0);\n }\n }\n }\n\n if (ok) {\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];\n } else {\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];\n }\n}\n\n/* remove the file or directory (recursively)\n * IN:\n * NSString* fullPath - the full path to the file or directory to be removed\n * NSString* callbackId\n * called from remove and removeRecursively - check all pubic api specific error conditions (dir not empty, etc) before calling\n */\n\n- (CDVPluginResult*)doRemove:(NSString*)fullPath\n{\n CDVPluginResult* result = nil;\n BOOL bSuccess = NO;\n NSError* __autoreleasing pError = nil;\n NSFileManager* fileMgr = [[NSFileManager alloc] init];\n\n @try {\n bSuccess = [fileMgr removeItemAtPath:fullPath error:&pError];\n if (bSuccess) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];\n } else {\n // see if we can give a useful error\n CDVFileError errorCode = ABORT_ERR;\n NSLog(@\"error removing filesystem entry at %@: %@\", fullPath, [pError localizedDescription]);\n if ([pError code] == NSFileNoSuchFileError) {\n errorCode = NOT_FOUND_ERR;\n } else if ([pError code] == NSFileWriteNoPermissionError) {\n errorCode = NO_MODIFICATION_ALLOWED_ERR;\n }\n\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:errorCode];\n }\n } @catch(NSException* e) { // NSInvalidArgumentException if path is . or ..\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:SYNTAX_ERR];\n }\n\n return result;\n}\n\n- (CDVPluginResult *)removeFileAtURL:(CDVFilesystemURL *)localURI\n{\n NSString *fileSystemPath = [self filesystemPathForURL:localURI];\n\n NSFileManager* fileMgr = [[NSFileManager alloc] init];\n BOOL bIsDir = NO;\n BOOL bExists = [fileMgr fileExistsAtPath:fileSystemPath isDirectory:&bIsDir];\n if (!bExists) {\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NOT_FOUND_ERR];\n }\n if (bIsDir && ([[fileMgr contentsOfDirectoryAtPath:fileSystemPath error:nil] count] != 0)) {\n // dir is not empty\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:INVALID_MODIFICATION_ERR];\n }\n return [self doRemove:fileSystemPath];\n}\n\n- (CDVPluginResult *)recursiveRemoveFileAtURL:(CDVFilesystemURL *)localURI\n{\n NSString *fileSystemPath = [self filesystemPathForURL:localURI];\n return [self doRemove:fileSystemPath];\n}\n\n/*\n * IN\n * NSString localURI\n * OUT\n * NSString full local filesystem path for the represented file or directory, or nil if no such path is possible\n * The file or directory does not necessarily have to exist. nil is returned if the filesystem type is not recognized,\n * or if the URL is malformed.\n * The incoming URI should be properly escaped (no raw spaces, etc. URI percent-encoding is expected).\n */\n- (NSString *)fullPathForFileSystemPath:(NSString *)fsPath\n{\n if ([fsPath hasPrefix:self.fsRoot]) {\n return [fsPath substringFromIndex:[self.fsRoot length]];\n }\n return nil;\n}\n\n\n- (CDVPluginResult *)readEntriesAtURL:(CDVFilesystemURL *)localURI\n{\n NSFileManager* fileMgr = [[NSFileManager alloc] init];\n NSError* __autoreleasing error = nil;\n NSString *fileSystemPath = [self filesystemPathForURL:localURI];\n\n NSArray* contents = [fileMgr contentsOfDirectoryAtPath:fileSystemPath error:&error];\n\n if (contents) {\n NSMutableArray* entries = [NSMutableArray arrayWithCapacity:1];\n if ([contents count] > 0) {\n // create an Entry (as JSON) for each file/dir\n for (NSString* name in contents) {\n // see if is dir or file\n NSString* entryPath = [fileSystemPath stringByAppendingPathComponent:name];\n BOOL bIsDir = NO;\n [fileMgr fileExistsAtPath:entryPath isDirectory:&bIsDir];\n NSDictionary* entryDict = [self makeEntryForPath:[self fullPathForFileSystemPath:entryPath] isDirectory:bIsDir];\n [entries addObject:entryDict];\n }\n }\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsArray:entries];\n } else {\n // assume not found but could check error for more specific error conditions\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NOT_FOUND_ERR];\n }\n}\n\n- (unsigned long long)truncateFile:(NSString*)filePath atPosition:(unsigned long long)pos\n{\n unsigned long long newPos = 0UL;\n\n NSFileHandle* file = [NSFileHandle fileHandleForWritingAtPath:filePath];\n\n if (file) {\n [file truncateFileAtOffset:(unsigned long long)pos];\n newPos = [file offsetInFile];\n [file synchronizeFile];\n [file closeFile];\n }\n return newPos;\n}\n\n- (CDVPluginResult *)truncateFileAtURL:(CDVFilesystemURL *)localURI atPosition:(unsigned long long)pos\n{\n unsigned long long newPos = [self truncateFile:[self filesystemPathForURL:localURI] atPosition:pos];\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsInt:(int)newPos];\n}\n\n- (CDVPluginResult *)writeToFileAtURL:(CDVFilesystemURL *)localURL withData:(NSData*)encData append:(BOOL)shouldAppend\n{\n NSString *filePath = [self filesystemPathForURL:localURL];\n\n CDVPluginResult* result = nil;\n CDVFileError errCode = INVALID_MODIFICATION_ERR;\n int bytesWritten = 0;\n\n if (filePath) {\n NSOutputStream* fileStream = [NSOutputStream outputStreamToFileAtPath:filePath append:shouldAppend];\n if (fileStream) {\n NSUInteger len = [encData length];\n if (len == 0) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDouble:(double)len];\n } else {\n [fileStream open];\n\n bytesWritten = (int)[fileStream write:[encData bytes] maxLength:len];\n\n [fileStream close];\n if (bytesWritten > 0) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsInt:bytesWritten];\n // } else {\n // can probably get more detailed error info via [fileStream streamError]\n // errCode already set to INVALID_MODIFICATION_ERR;\n // bytesWritten = 0; // may be set to -1 on error\n }\n }\n } // else fileStream not created return INVALID_MODIFICATION_ERR\n } else {\n // invalid filePath\n errCode = NOT_FOUND_ERR;\n }\n if (!result) {\n // was an error\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:errCode];\n }\n return result;\n}\n\n/**\n * Helper function to check to see if the user attempted to copy an entry into its parent without changing its name,\n * or attempted to copy a directory into a directory that it contains directly or indirectly.\n *\n * IN:\n * NSString* srcDir\n * NSString* destinationDir\n * OUT:\n * YES copy/ move is allows\n * NO move is onto itself\n */\n- (BOOL)canCopyMoveSrc:(NSString*)src ToDestination:(NSString*)dest\n{\n // This weird test is to determine if we are copying or moving a directory into itself.\n // Copy /Documents/myDir to /Documents/myDir-backup is okay but\n // Copy /Documents/myDir to /Documents/myDir/backup not okay\n BOOL copyOK = YES;\n NSRange range = [dest rangeOfString:src];\n\n if (range.location != NSNotFound) {\n NSRange testRange = {range.length - 1, ([dest length] - range.length)};\n NSRange resultRange = [dest rangeOfString:@\"/\" options:0 range:testRange];\n if (resultRange.location != NSNotFound) {\n copyOK = NO;\n }\n }\n return copyOK;\n}\n\n- (void)copyFileToURL:(CDVFilesystemURL *)destURL withName:(NSString *)newName fromFileSystem:(NSObject *)srcFs atURL:(CDVFilesystemURL *)srcURL copy:(BOOL)bCopy callback:(void (^)(CDVPluginResult *))callback\n{\n NSFileManager *fileMgr = [[NSFileManager alloc] init];\n NSString *destRootPath = [self filesystemPathForURL:destURL];\n BOOL bDestIsDir = NO;\n BOOL bDestExists = [fileMgr fileExistsAtPath:destRootPath isDirectory:&bDestIsDir];\n\n NSString *newFileSystemPath = [destRootPath stringByAppendingPathComponent:newName];\n NSString *newFullPath = [self fullPathForFileSystemPath:newFileSystemPath];\n\n BOOL bNewIsDir = NO;\n BOOL bNewExists = [fileMgr fileExistsAtPath:newFileSystemPath isDirectory:&bNewIsDir];\n\n CDVPluginResult *result = nil;\n int errCode = 0;\n\n if (!bDestExists) {\n // the destination root does not exist\n errCode = NOT_FOUND_ERR;\n }\n\n else if ([srcFs isKindOfClass:[CDVLocalFilesystem class]]) {\n /* Same FS, we can shortcut with NSFileManager operations */\n NSString *srcFullPath = [srcFs filesystemPathForURL:srcURL];\n\n BOOL bSrcIsDir = NO;\n BOOL bSrcExists = [fileMgr fileExistsAtPath:srcFullPath isDirectory:&bSrcIsDir];\n\n if (!bSrcExists) {\n // the source does not exist\n errCode = NOT_FOUND_ERR;\n } else if ([newFileSystemPath isEqualToString:srcFullPath]) {\n // source and destination can not be the same\n errCode = INVALID_MODIFICATION_ERR;\n } else if (bSrcIsDir && (bNewExists && !bNewIsDir)) {\n // can't copy/move dir to file\n errCode = INVALID_MODIFICATION_ERR;\n } else { // no errors yet\n NSError* __autoreleasing error = nil;\n BOOL bSuccess = NO;\n if (bCopy) {\n if (bSrcIsDir && ![self canCopyMoveSrc:srcFullPath ToDestination:newFileSystemPath]) {\n // can't copy dir into self\n errCode = INVALID_MODIFICATION_ERR;\n } else if (bNewExists) {\n // the full destination should NOT already exist if a copy\n errCode = PATH_EXISTS_ERR;\n } else {\n bSuccess = [fileMgr copyItemAtPath:srcFullPath toPath:newFileSystemPath error:&error];\n }\n } else { // move\n // iOS requires that destination must not exist before calling moveTo\n // is W3C INVALID_MODIFICATION_ERR error if destination dir exists and has contents\n //\n if (!bSrcIsDir && (bNewExists && bNewIsDir)) {\n // can't move a file to directory\n errCode = INVALID_MODIFICATION_ERR;\n } else if (bSrcIsDir && ![self canCopyMoveSrc:srcFullPath ToDestination:newFileSystemPath]) {\n // can't move a dir into itself\n errCode = INVALID_MODIFICATION_ERR;\n } else if (bNewExists) {\n if (bNewIsDir && ([[fileMgr contentsOfDirectoryAtPath:newFileSystemPath error:NULL] count] != 0)) {\n // can't move dir to a dir that is not empty\n errCode = INVALID_MODIFICATION_ERR;\n newFileSystemPath = nil; // so we won't try to move\n } else {\n // remove destination so can perform the moveItemAtPath\n bSuccess = [fileMgr removeItemAtPath:newFileSystemPath error:NULL];\n if (!bSuccess) {\n errCode = INVALID_MODIFICATION_ERR; // is this the correct error?\n newFileSystemPath = nil;\n }\n }\n } else if (bNewIsDir && [newFileSystemPath hasPrefix:srcFullPath]) {\n // can't move a directory inside itself or to any child at any depth;\n errCode = INVALID_MODIFICATION_ERR;\n newFileSystemPath = nil;\n }\n\n if (newFileSystemPath != nil) {\n bSuccess = [fileMgr moveItemAtPath:srcFullPath toPath:newFileSystemPath error:&error];\n }\n }\n if (bSuccess) {\n // should verify it is there and of the correct type???\n NSDictionary* newEntry = [self makeEntryForPath:newFullPath isDirectory:bSrcIsDir];\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:newEntry];\n } else {\n if (error) {\n if (([error code] == NSFileReadUnknownError) || ([error code] == NSFileReadTooLargeError)) {\n errCode = NOT_READABLE_ERR;\n } else if ([error code] == NSFileWriteOutOfSpaceError) {\n errCode = QUOTA_EXCEEDED_ERR;\n } else if ([error code] == NSFileWriteNoPermissionError) {\n errCode = NO_MODIFICATION_ALLOWED_ERR;\n }\n }\n }\n }\n } else {\n // Need to copy the hard way\n [srcFs readFileAtURL:srcURL start:0 end:-1 callback:^(NSData* data, NSString* mimeType, CDVFileError errorCode) {\n CDVPluginResult* result = nil;\n if (data != nil) {\n BOOL bSuccess = [data writeToFile:newFileSystemPath atomically:YES];\n if (bSuccess) {\n // should verify it is there and of the correct type???\n NSDictionary* newEntry = [self makeEntryForPath:newFullPath isDirectory:NO];\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:newEntry];\n } else {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:ABORT_ERR];\n }\n } else {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:errorCode];\n }\n callback(result);\n }];\n return; // Async IO; return without callback.\n }\n if (result == nil) {\n if (!errCode) {\n errCode = INVALID_MODIFICATION_ERR; // Catch-all default\n }\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:errCode];\n }\n callback(result);\n}\n\n/* helper function to get the mimeType from the file extension\n * IN:\n *\tNSString* fullPath - filename (may include path)\n * OUT:\n *\tNSString* the mime type as type/subtype. nil if not able to determine\n */\n+ (NSString*)getMimeTypeFromPath:(NSString*)fullPath\n{\n NSString* mimeType = nil;\n\n if (fullPath) {\n CFStringRef typeId = UTTypeCreatePreferredIdentifierForTag(kUTTagClassFilenameExtension, (__bridge CFStringRef)[fullPath pathExtension], NULL);\n if (typeId) {\n mimeType = (__bridge_transfer NSString*)UTTypeCopyPreferredTagWithClass(typeId, kUTTagClassMIMEType);\n if (!mimeType) {\n // special case for m4a\n if ([(__bridge NSString*)typeId rangeOfString : @\"m4a-audio\"].location != NSNotFound) {\n mimeType = @\"audio/mp4\";\n } else if ([[fullPath pathExtension] rangeOfString:@\"wav\"].location != NSNotFound) {\n mimeType = @\"audio/wav\";\n } else if ([[fullPath pathExtension] rangeOfString:@\"css\"].location != NSNotFound) {\n mimeType = @\"text/css\";\n }\n }\n CFRelease(typeId);\n }\n }\n return mimeType;\n}\n\n- (void)readFileAtURL:(CDVFilesystemURL *)localURL start:(NSInteger)start end:(NSInteger)end callback:(void (^)(NSData*, NSString* mimeType, CDVFileError))callback\n{\n NSString *path = [self filesystemPathForURL:localURL];\n\n NSString* mimeType = [CDVLocalFilesystem getMimeTypeFromPath:path];\n if (mimeType == nil) {\n mimeType = @\"*/*\";\n }\n NSFileHandle* file = [NSFileHandle fileHandleForReadingAtPath:path];\n if (start > 0) {\n [file seekToFileOffset:start];\n }\n\n NSData* readData;\n if (end < 0) {\n readData = [file readDataToEndOfFile];\n } else {\n readData = [file readDataOfLength:(end - start)];\n }\n [file closeFile];\n\n callback(readData, mimeType, readData != nil ? NO_ERROR : NOT_FOUND_ERR);\n}\n\n- (void)getFileMetadataForURL:(CDVFilesystemURL *)localURL callback:(void (^)(CDVPluginResult *))callback\n{\n NSString *path = [self filesystemPathForURL:localURL];\n CDVPluginResult *result;\n NSFileManager* fileMgr = [[NSFileManager alloc] init];\n\n NSError* __autoreleasing error = nil;\n NSDictionary* fileAttrs = [fileMgr attributesOfItemAtPath:path error:&error];\n\n if (fileAttrs) {\n\n // create dictionary of file info\n NSMutableDictionary* fileInfo = [NSMutableDictionary dictionaryWithCapacity:5];\n\n [fileInfo setObject:localURL.fullPath forKey:@\"fullPath\"];\n [fileInfo setObject:@\"\" forKey:@\"type\"]; // can't easily get the mimetype unless create URL, send request and read response so skipping\n [fileInfo setObject:[path lastPathComponent] forKey:@\"name\"];\n\n // Ensure that directories (and other non-regular files) report size of 0\n unsigned long long size = ([fileAttrs fileType] == NSFileTypeRegular ? [fileAttrs fileSize] : 0);\n [fileInfo setObject:[NSNumber numberWithUnsignedLongLong:size] forKey:@\"size\"];\n\n NSDate* modDate = [fileAttrs fileModificationDate];\n if (modDate) {\n [fileInfo setObject:[NSNumber numberWithDouble:[modDate timeIntervalSince1970] * 1000] forKey:@\"lastModifiedDate\"];\n }\n\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:fileInfo];\n\n } else {\n // didn't get fileAttribs\n CDVFileError errorCode = ABORT_ERR;\n NSLog(@\"error getting metadata: %@\", [error localizedDescription]);\n if ([error code] == NSFileNoSuchFileError || [error code] == NSFileReadNoSuchFileError) {\n errorCode = NOT_FOUND_ERR;\n }\n // log [NSNumber numberWithDouble: theMessage] objCtype to see what it returns\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:errorCode];\n }\n\n callback(result);\n}\n\n@end\n"
},
{
"path": "plugins/cordova-plugin-file/src/osx/CDVFile.h",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\n\n#import \n#import \n\nNSString* const kCDVFilesystemURLPrefix;\n\n/**\n* The default filesystems if non are specified.\n*/\n#define CDV_FILESYSTEMS_DEFAULT @\"documents,cache,bundle,root\"\n\n/**\n* Preference name of the extra filesystems to be \"mounted\". the following are supported:\n* 'bundle' - mounts the application directory\n* 'documents' - mounts the users Documents directory (~/Documents)\n* 'root' - mounts the root file system\n* 'cache' - mounts the caches directory (~/Library/Caches/ *)srcFs atURL:(CDVFilesystemURL *)srcURL copy:(BOOL)bCopy callback:(void (^)(CDVPluginResult *))callback;\n- (void)readFileAtURL:(CDVFilesystemURL *)localURL start:(NSInteger)start end:(NSInteger)end callback:(void (^)(NSData*, NSString* mimeType, CDVFileError))callback;\n- (void)getFileMetadataForURL:(CDVFilesystemURL *)localURL callback:(void (^)(CDVPluginResult *))callback;\n\n- (NSDictionary *)makeEntryForLocalURL:(CDVFilesystemURL *)url;\n- (NSDictionary*)makeEntryForPath:(NSString*)fullPath isDirectory:(BOOL)isDir;\n\n@property (nonatomic,strong) NSString *name;\n@property (nonatomic, copy) NSURL*(^urlTransformer)(NSURL*);\n\n@optional\n- (NSString *)filesystemPathForURL:(CDVFilesystemURL *)localURI;\n- (CDVFilesystemURL *)URLforFilesystemPath:(NSString *)path;\n\n@end\n\n@interface CDVFile : CDVPlugin {\n NSString* rootDocsPath;\n NSString* appDocsPath;\n NSString* appLibraryPath;\n NSString* appTempPath;\n\n NSMutableArray* fileSystems_;\n BOOL userHasAllowed;\n}\n\n- (NSNumber*)checkFreeDiskSpace:(NSString*)appPath;\n- (NSDictionary*)makeEntryForPath:(NSString*)fullPath fileSystemName:(NSString *)fsName isDirectory:(BOOL)isDir;\n- (NSDictionary *)makeEntryForURL:(NSURL *)URL;\n- (CDVFilesystemURL *)fileSystemURLforLocalPath:(NSString *)localPath;\n\n- (NSObject *)filesystemForURL:(CDVFilesystemURL *)localURL;\n\n/* Native Registration API */\n- (void)registerFilesystem:(NSObject *)fs;\n- (NSObject *)fileSystemByName:(NSString *)fsName;\n\n/* Exec API */\n- (void)requestFileSystem:(CDVInvokedUrlCommand*)command;\n- (void)resolveLocalFileSystemURI:(CDVInvokedUrlCommand*)command;\n- (void)getDirectory:(CDVInvokedUrlCommand*)command;\n- (void)getFile:(CDVInvokedUrlCommand*)command;\n- (void)getParent:(CDVInvokedUrlCommand*)command;\n- (void)removeRecursively:(CDVInvokedUrlCommand*)command;\n- (void)remove:(CDVInvokedUrlCommand*)command;\n- (void)copyTo:(CDVInvokedUrlCommand*)command;\n- (void)moveTo:(CDVInvokedUrlCommand*)command;\n- (void)getFileMetadata:(CDVInvokedUrlCommand*)command;\n- (void)readEntries:(CDVInvokedUrlCommand*)command;\n- (void)readAsText:(CDVInvokedUrlCommand*)command;\n- (void)readAsDataURL:(CDVInvokedUrlCommand*)command;\n- (void)readAsArrayBuffer:(CDVInvokedUrlCommand*)command;\n- (void)write:(CDVInvokedUrlCommand*)command;\n- (void)testFileExists:(CDVInvokedUrlCommand*)command;\n- (void)testDirectoryExists:(CDVInvokedUrlCommand*)command;\n- (void)getFreeDiskSpace:(CDVInvokedUrlCommand*)command;\n- (void)truncate:(CDVInvokedUrlCommand*)command;\n- (void)doCopyMove:(CDVInvokedUrlCommand*)command isCopy:(BOOL)bCopy;\n\n/* Compatibilty with older File API */\n- (NSString*)getMimeTypeFromPath:(NSString*)fullPath;\n- (NSDictionary *)getDirectoryEntry:(NSString *)target isDirectory:(BOOL)bDirRequest;\n\n/* Conversion between filesystem paths and URLs */\n- (NSString *)filesystemPathForURL:(CDVFilesystemURL *)URL;\n\n/* Internal methods for testing */\n- (void)_getLocalFilesystemPath:(CDVInvokedUrlCommand*)command;\n\n/**\n * local path of the 'documents' file system (~/Documents)\n */\n@property (nonatomic, strong) NSString* appDocsPath;\n\n/**\n* local path of the 'applicationStorageDirectory' file system (~/Library/Application Support/)\n*/\n@property (nonatomic, strong) NSString* appSupportPath;\n\n/**\n* local path of the 'persistent' file system (~/Library/Application Support//files)\n*/\n@property (nonatomic, strong) NSString* appDataPath;\n\n/**\n* local path of the 'documents' file system (~/Documents)\n*/\n@property (nonatomic, strong) NSString* appTempPath;\n\n/**\n* local path of the 'cache' file system (~/Library/Caches/)\n*/\n@property (nonatomic, strong) NSString* appCachePath;\n\n/**\n * registered file systems\n */\n@property (nonatomic, strong) NSMutableArray* fileSystems;\n\n@property BOOL userHasAllowed;\n\n@end\n"
},
{
"path": "plugins/cordova-plugin-file/src/osx/CDVFile.m",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\n\n#import \"CDVFile.h\"\n#import \"CDVLocalFilesystem.h\"\n#import \n\nstatic NSString* toBase64(NSData* data) {\n SEL s1 = NSSelectorFromString(@\"cdv_base64EncodedString\");\n SEL s2 = NSSelectorFromString(@\"base64EncodedString\");\n SEL s3 = NSSelectorFromString(@\"base64EncodedStringWithOptions:\");\n\n if ([data respondsToSelector:s1]) {\n NSString* (*func)(id, SEL) = (void *)[data methodForSelector:s1];\n return func(data, s1);\n } else if ([data respondsToSelector:s2]) {\n NSString* (*func)(id, SEL) = (void *)[data methodForSelector:s2];\n return func(data, s2);\n } else if ([data respondsToSelector:s3]) {\n NSString* (*func)(id, SEL, NSUInteger) = (void *)[data methodForSelector:s3];\n return func(data, s3, 0);\n } else {\n return nil;\n }\n}\n\nCDVFile *filePlugin = nil;\n\nextern NSString * const NSURLIsExcludedFromBackupKey __attribute__((weak_import));\n\n#ifndef __IPHONE_5_1\n NSString* const NSURLIsExcludedFromBackupKey = @\"NSURLIsExcludedFromBackupKey\";\n#endif\n\nNSString* const kCDVFilesystemURLPrefix = @\"cdvfile\";\n\n@implementation CDVFilesystemURL\n@synthesize url=_url;\n@synthesize fileSystemName=_fileSystemName;\n@synthesize fullPath=_fullPath;\n\n- (id) initWithString:(NSString *)strURL\n{\n if ( self = [super init] ) {\n NSURL *decodedURL = [NSURL URLWithString:strURL];\n return [self initWithURL:decodedURL];\n }\n return nil;\n}\n\n-(id) initWithURL:(NSURL *)URL\n{\n if ( self = [super init] ) {\n _url = URL;\n _fileSystemName = [self filesystemNameForLocalURI:URL];\n _fullPath = [self fullPathForLocalURI:URL];\n }\n return self;\n}\n\n/*\n * IN\n * NSString localURI\n * OUT\n * NSString FileSystem Name for this URI, or nil if it is not recognized.\n */\n- (NSString *)filesystemNameForLocalURI:(NSURL *)uri\n{\n if ([[uri scheme] isEqualToString:kCDVFilesystemURLPrefix] && [[uri host] isEqualToString:@\"localhost\"]) {\n NSArray *pathComponents = [uri pathComponents];\n if (pathComponents != nil && pathComponents.count > 1) {\n return [pathComponents objectAtIndex:1];\n }\n }\n return nil;\n}\n\n/*\n * IN\n * NSString localURI\n * OUT\n * NSString fullPath component suitable for an Entry object.\n * The incoming URI should be properly escaped. The returned fullPath is unescaped.\n */\n- (NSString *)fullPathForLocalURI:(NSURL *)uri\n{\n if ([[uri scheme] isEqualToString:kCDVFilesystemURLPrefix] && [[uri host] isEqualToString:@\"localhost\"]) {\n NSString *path = [uri path];\n if ([uri query]) {\n path = [NSString stringWithFormat:@\"%@?%@\", path, [uri query]];\n }\n NSRange slashRange = [path rangeOfString:@\"/\" options:0 range:NSMakeRange(1, path.length-1)];\n if (slashRange.location == NSNotFound) {\n return @\"\";\n }\n return [path substringFromIndex:slashRange.location];\n }\n return nil;\n}\n\n+ (CDVFilesystemURL *)fileSystemURLWithString:(NSString *)strURL\n{\n return [[CDVFilesystemURL alloc] initWithString:strURL];\n}\n\n+ (CDVFilesystemURL *)fileSystemURLWithURL:(NSURL *)URL\n{\n return [[CDVFilesystemURL alloc] initWithURL:URL];\n}\n\n- (NSString *)absoluteURL\n{\n return [NSString stringWithFormat:@\"cdvfile://localhost/%@%@\", self.fileSystemName, self.fullPath];\n}\n\n@end\n\n@implementation CDVFilesystemURLProtocol\n\n+ (BOOL)canInitWithRequest:(NSURLRequest*)request\n{\n NSURL* url = [request URL];\n return [[url scheme] isEqualToString:kCDVFilesystemURLPrefix];\n}\n\n+ (NSURLRequest*)canonicalRequestForRequest:(NSURLRequest*)request\n{\n return request;\n}\n\n+ (BOOL)requestIsCacheEquivalent:(NSURLRequest*)requestA toRequest:(NSURLRequest*)requestB\n{\n return [[[requestA URL] resourceSpecifier] isEqualToString:[[requestB URL] resourceSpecifier]];\n}\n\n- (void)startLoading\n{\n CDVFilesystemURL* url = [CDVFilesystemURL fileSystemURLWithURL:[[self request] URL]];\n NSObject *fs = [filePlugin filesystemForURL:url];\n [fs readFileAtURL:url start:0 end:-1 callback:^void(NSData *data, NSString *mimetype, CDVFileError error) {\n NSMutableDictionary* responseHeaders = [[NSMutableDictionary alloc] init];\n responseHeaders[@\"Cache-Control\"] = @\"no-cache\";\n\n if (!error) {\n responseHeaders[@\"Content-Type\"] = mimetype;\n NSURLResponse *response = [[NSHTTPURLResponse alloc] initWithURL:url.url statusCode:200 HTTPVersion:@\"HTTP/1.1\"headerFields:responseHeaders];\n [[self client] URLProtocol:self didReceiveResponse:response cacheStoragePolicy:NSURLCacheStorageNotAllowed];\n [[self client] URLProtocol:self didLoadData:data];\n [[self client] URLProtocolDidFinishLoading:self];\n } else {\n NSURLResponse *response = [[NSHTTPURLResponse alloc] initWithURL:url.url statusCode:404 HTTPVersion:@\"HTTP/1.1\"headerFields:responseHeaders];\n [[self client] URLProtocol:self didReceiveResponse:response cacheStoragePolicy:NSURLCacheStorageNotAllowed];\n [[self client] URLProtocolDidFinishLoading:self];\n }\n }];\n}\n\n- (void)stopLoading\n{}\n\n- (NSCachedURLResponse *)connection:(NSURLConnection *)connection\n willCacheResponse:(NSCachedURLResponse*)cachedResponse {\n return nil;\n}\n\n@end\n\n\n@implementation CDVFile\n\n@synthesize appDocsPath, appDataPath, appSupportPath, appTempPath, appCachePath, userHasAllowed, fileSystems=fileSystems_;\n\n- (void)registerFilesystem:(NSObject *)fs {\n __weak CDVFile* weakSelf = self;\n SEL sel = NSSelectorFromString(@\"urlTransformer\");\n // for backwards compatibility - we check if this property is there\n // we create a wrapper block because the urlTransformer property\n // on the commandDelegate might be set dynamically at a future time\n // (and not dependent on plugin loading order)\n if ([self.commandDelegate respondsToSelector:sel]) {\n fs.urlTransformer = ^NSURL*(NSURL* urlToTransform) {\n // grab the block from the commandDelegate\n NSURL* (^urlTransformer)(NSURL*) = ((id(*)(id, SEL))objc_msgSend)(weakSelf.commandDelegate, sel);\n // if block is not null, we call it\n if (urlTransformer) {\n return urlTransformer(urlToTransform);\n } else { // else we return the same url\n return urlToTransform;\n }\n };\n }\n [fileSystems_ addObject:fs];\n}\n\n- (NSObject *)fileSystemByName:(NSString *)fsName\n{\n if (self.fileSystems != nil) {\n for (NSObject *fs in self.fileSystems) {\n if ([fs.name isEqualToString:fsName]) {\n return fs;\n }\n }\n }\n return nil;\n\n}\n\n- (NSObject *)filesystemForURL:(CDVFilesystemURL *)localURL {\n if (localURL.fileSystemName == nil) return nil;\n @try {\n return [self fileSystemByName:localURL.fileSystemName];\n }\n @catch (NSException *e) {\n return nil;\n }\n}\n\n- (NSArray *)getExtraFileSystemsPreference:(NSWindowController *)vc\n{\n NSString *filesystemsStr = nil;\n if([self.viewController isKindOfClass:[CDVViewController class]]) {\n CDVViewController *vc = self.viewController;\n NSDictionary *settings = [vc settings];\n filesystemsStr = [settings[CDV_PREF_EXTRA_FILESYSTEM] lowercaseString];\n }\n if (!filesystemsStr) {\n filesystemsStr = CDV_FILESYSTEMS_DEFAULT;\n }\n return [filesystemsStr componentsSeparatedByString:@\",\"];\n}\n\n- (void)makeNonSyncable:(NSString*)path {\n [[NSFileManager defaultManager] createDirectoryAtPath:path\n withIntermediateDirectories:YES\n attributes:nil\n error:nil];\n NSURL* url = [NSURL fileURLWithPath:path];\n [url setResourceValue: [NSNumber numberWithBool: YES]\n forKey: NSURLIsExcludedFromBackupKey error:nil];\n\n}\n\n- (void)registerExtraFileSystems:(NSArray *)filesystems fromAvailableSet:(NSDictionary *)availableFileSystems\n{\n NSMutableSet *installedFilesystems = [[NSMutableSet alloc] initWithCapacity:7];\n\n /* Register filesystems in order */\n for (NSString *fsName in filesystems) {\n if (![installedFilesystems containsObject:fsName]) {\n NSString *fsRoot = availableFileSystems[fsName];\n if (fsRoot) {\n [filePlugin registerFilesystem:[[CDVLocalFilesystem alloc] initWithName:fsName root:fsRoot]];\n [installedFilesystems addObject:fsName];\n } else {\n NSLog(@\"Unrecognized extra filesystem identifier: %@\", fsName);\n }\n }\n }\n}\n\n- (NSDictionary *)getAvailableFileSystems\n{\n return @{\n @\"documents\": self.appDocsPath,\n @\"cache\": self.appCachePath,\n @\"bundle\": [[NSBundle mainBundle] bundlePath],\n @\"root\": @\"/\"\n };\n}\n\n- (void)pluginInitialize\n{ filePlugin = self;\n [NSURLProtocol registerClass:[CDVFilesystemURLProtocol class]];\n\n fileSystems_ = [[NSMutableArray alloc] initWithCapacity:3];\n\n // Get the Temporary directory path\n self.appTempPath = [NSTemporaryDirectory()stringByStandardizingPath]; // remove trailing slash from NSTemporaryDirectory()\n [self registerFilesystem:[[CDVLocalFilesystem alloc] initWithName:@\"temporary\" root:self.appTempPath]];\n\n // ~/Library/Application Support/\n self.appSupportPath = [self getSupportDirectoryFor:NSApplicationSupportDirectory pathComponents:nil];\n\n // ~/Library/Application Support//files\n self.appDataPath = [self getSupportDirectoryFor:NSApplicationSupportDirectory pathComponents:@[@\"files\"]];\n [self registerFilesystem:[[CDVLocalFilesystem alloc] initWithName:@\"persistent\" root:self.appDataPath]];\n\n // ~/Documents/\n self.appDocsPath = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)[0];\n\n // ~/Library/Caches//files\n self.appCachePath = [self getSupportDirectoryFor:NSCachesDirectory pathComponents:nil];\n\n [self registerExtraFileSystems:[self getExtraFileSystemsPreference:self.viewController]\n fromAvailableSet:[self getAvailableFileSystems]];\n}\n\n- (NSString*) getSupportDirectoryFor: (NSSearchPathDirectory) directory pathComponents: (NSArray*) components {\n NSError* error;\n NSFileManager* fm = [NSFileManager defaultManager];\n NSURL* supportDir = [fm URLForDirectory:directory inDomain:NSUserDomainMask appropriateForURL:nil create:YES error:&error];\n if (supportDir == nil) {\n NSLog(@\"unable to get support directory: %@\", error);\n return nil;\n }\n\n NSString* bundleID = [[NSBundle mainBundle] bundleIdentifier];\n NSURL *dirPath = [supportDir URLByAppendingPathComponent:bundleID];\n for (NSString* pathComponent in components) {\n dirPath = [dirPath URLByAppendingPathComponent:pathComponent];\n }\n\n if (![fm fileExistsAtPath:dirPath.path]) {\n if (![fm createDirectoryAtURL:dirPath withIntermediateDirectories:YES attributes:nil error:&error]) {\n NSLog(@\"unable to create support directory: %@\", error);\n return nil;\n }\n }\n return dirPath.path;\n}\n\n\n- (CDVFilesystemURL *)fileSystemURLforArg:(NSString *)urlArg\n{\n CDVFilesystemURL* ret = nil;\n if ([urlArg hasPrefix:@\"file://\"]) {\n /* This looks like a file url. Get the path, and see if any handlers recognize it. */\n NSURL *fileURL = [NSURL URLWithString:urlArg];\n NSURL *resolvedFileURL = [fileURL URLByResolvingSymlinksInPath];\n NSString *path = [resolvedFileURL path];\n ret = [self fileSystemURLforLocalPath:path];\n } else {\n ret = [CDVFilesystemURL fileSystemURLWithString:urlArg];\n }\n return ret;\n}\n\n- (CDVFilesystemURL *)fileSystemURLforLocalPath:(NSString *)localPath\n{\n CDVFilesystemURL *localURL = nil;\n NSUInteger shortestFullPath = 0;\n\n // Try all installed filesystems, in order. Return the most match url.\n for (id object in self.fileSystems) {\n if ([object respondsToSelector:@selector(URLforFilesystemPath:)]) {\n CDVFilesystemURL *url = [object URLforFilesystemPath:localPath];\n if (url){\n // A shorter fullPath would imply that the filesystem is a better match for the local path\n if (!localURL || ([[url fullPath] length] < shortestFullPath)) {\n localURL = url;\n shortestFullPath = [[url fullPath] length];\n }\n }\n }\n }\n return localURL;\n}\n\n- (NSNumber*)checkFreeDiskSpace:(NSString*)appPath\n{\n NSFileManager* fMgr = [[NSFileManager alloc] init];\n\n NSError* __autoreleasing pError = nil;\n\n NSDictionary* pDict = [fMgr attributesOfFileSystemForPath:appPath error:&pError];\n NSNumber* pNumAvail = (NSNumber*)[pDict objectForKey:NSFileSystemFreeSize];\n\n return pNumAvail;\n}\n\n/* Request the File System info\n *\n * IN:\n * arguments[0] - type (number as string)\n *\tTEMPORARY = 0, PERSISTENT = 1;\n * arguments[1] - size\n *\n * OUT:\n *\tDictionary representing FileSystem object\n *\t\tname - the human readable directory name\n *\t\troot = DirectoryEntry object\n *\t\t\tbool isDirectory\n *\t\t\tbool isFile\n *\t\t\tstring name\n *\t\t\tstring fullPath\n *\t\t\tfileSystem = FileSystem object - !! ignored because creates circular reference !!\n */\n\n- (void)requestFileSystem:(CDVInvokedUrlCommand*)command\n{\n // arguments\n NSString* strType = [command argumentAtIndex:0];\n unsigned long long size = [[command argumentAtIndex:1] longLongValue];\n\n int type = [strType intValue];\n CDVPluginResult* result = nil;\n\n if (type > self.fileSystems.count) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:NOT_FOUND_ERR];\n NSLog(@\"No filesystem of type requested\");\n } else {\n NSString* fullPath = @\"/\";\n // check for avail space for size request\n NSNumber* pNumAvail = [self checkFreeDiskSpace:self.appSupportPath];\n // NSLog(@\"Free space: %@\", [NSString stringWithFormat:@\"%qu\", [ pNumAvail unsignedLongLongValue ]]);\n if (pNumAvail && ([pNumAvail unsignedLongLongValue] < size)) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:QUOTA_EXCEEDED_ERR];\n } else {\n NSObject *rootFs = [self.fileSystems objectAtIndex:type];\n if (rootFs == nil) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:NOT_FOUND_ERR];\n NSLog(@\"No filesystem of type requested\");\n } else {\n NSMutableDictionary* fileSystem = [NSMutableDictionary dictionaryWithCapacity:2];\n [fileSystem setObject:rootFs.name forKey:@\"name\"];\n NSDictionary* dirEntry = [self makeEntryForPath:fullPath fileSystemName:rootFs.name isDirectory:YES];\n [fileSystem setObject:dirEntry forKey:@\"root\"];\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:fileSystem];\n }\n }\n }\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n\n- (void)requestAllFileSystems:(CDVInvokedUrlCommand*)command\n{\n NSMutableArray* ret = [[NSMutableArray alloc] init];\n for (NSObject* root in fileSystems_) {\n [ret addObject:[self makeEntryForPath:@\"/\" fileSystemName:root.name isDirectory:YES]];\n }\n CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsArray:ret];\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n- (void)requestAllPaths:(CDVInvokedUrlCommand*)command\n{\n NSDictionary* ret = @{\n @\"applicationDirectory\": [[NSURL fileURLWithPath:[[NSBundle mainBundle] resourcePath]] absoluteString],\n @\"applicationStorageDirectory\": [[NSURL fileURLWithPath:self.appSupportPath] absoluteString],\n @\"dataDirectory\": [[NSURL fileURLWithPath:self.appDataPath] absoluteString],\n @\"documentsDirectory\": [[NSURL fileURLWithPath:self.appDocsPath] absoluteString],\n @\"cacheDirectory\": [[NSURL fileURLWithPath:self.appCachePath] absoluteString],\n @\"tempDirectory\":[[NSURL fileURLWithPath:self.appTempPath] absoluteString],\n @\"rootDirectory\": @\"file:///\",\n };\n\n CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:ret];\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n/* Creates and returns a dictionary representing an Entry Object\n *\n * IN:\n * NSString* fullPath of the entry\n * int fsType - FileSystem type\n * BOOL isDirectory - YES if this is a directory, NO if is a file\n * OUT:\n * NSDictionary* Entry object\n *\t\tbool as NSNumber isDirectory\n *\t\tbool as NSNumber isFile\n *\t\tNSString* name - last part of path\n *\t\tNSString* fullPath\n *\t\tNSString* filesystemName - FileSystem name -- actual filesystem will be created on the JS side if necessary, to avoid\n * creating circular reference (FileSystem contains DirectoryEntry which contains FileSystem.....!!)\n */\n- (NSDictionary*)makeEntryForPath:(NSString*)fullPath fileSystemName:(NSString *)fsName isDirectory:(BOOL)isDir\n{\n NSObject *fs = [self fileSystemByName:fsName];\n return [fs makeEntryForPath:fullPath isDirectory:isDir];\n}\n\n- (NSDictionary *)makeEntryForLocalURL:(CDVFilesystemURL *)localURL\n{\n NSObject *fs = [self filesystemForURL:localURL];\n return [fs makeEntryForLocalURL:localURL];\n}\n\n- (NSDictionary *)makeEntryForURL:(NSURL *)URL\n{\n CDVFilesystemURL* fsURL = [self fileSystemURLforArg:[URL absoluteString]];\n return [self makeEntryForLocalURL:fsURL];\n}\n\n/*\n * Given a URI determine the File System information associated with it and return an appropriate W3C entry object\n * IN\n *\tNSString* localURI: Should be an escaped local filesystem URI\n * OUT\n *\tEntry object\n *\t\tbool isDirectory\n *\t\tbool isFile\n *\t\tstring name\n *\t\tstring fullPath\n *\t\tfileSystem = FileSystem object - !! ignored because creates circular reference FileSystem contains DirectoryEntry which contains FileSystem.....!!\n */\n- (void)resolveLocalFileSystemURI:(CDVInvokedUrlCommand*)command\n{\n // arguments\n NSString* localURIstr = [command argumentAtIndex:0];\n CDVPluginResult* result;\n\n localURIstr = [self encodePath:localURIstr]; //encode path before resolving\n CDVFilesystemURL* inputURI = [self fileSystemURLforArg:localURIstr];\n\n if (inputURI == nil || inputURI.fileSystemName == nil) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:ENCODING_ERR];\n } else {\n NSObject *fs = [self filesystemForURL:inputURI];\n if (fs == nil) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:ENCODING_ERR];\n } else {\n result = [fs entryForLocalURI:inputURI];\n }\n }\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n//encode path with percent escapes\n-(NSString *)encodePath:(NSString *)path\n{\n NSString *decodedPath = [path stringByReplacingPercentEscapesUsingEncoding:NSUTF8StringEncoding]; //decode incase it's already encoded to avoid encoding twice\n return [decodedPath stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];\n}\n\n\n/* Part of DirectoryEntry interface, creates or returns the specified directory\n * IN:\n *\tNSString* localURI - local filesystem URI for this directory\n *\tNSString* path - directory to be created/returned; may be full path or relative path\n *\tNSDictionary* - Flags object\n *\t\tboolean as NSNumber create -\n *\t\t\tif create is true and directory does not exist, create dir and return directory entry\n *\t\t\tif create is true and exclusive is true and directory does exist, return error\n *\t\t\tif create is false and directory does not exist, return error\n *\t\t\tif create is false and the path represents a file, return error\n *\t\tboolean as NSNumber exclusive - used in conjunction with create\n *\t\t\tif exclusive is true and create is true - specifies failure if directory already exists\n *\n *\n */\n- (void)getDirectory:(CDVInvokedUrlCommand*)command\n{\n NSMutableArray* arguments = [NSMutableArray arrayWithArray:command.arguments];\n NSMutableDictionary* options = nil;\n\n if ([arguments count] >= 3) {\n options = [command argumentAtIndex:2 withDefault:nil];\n }\n // add getDir to options and call getFile()\n if (options != nil) {\n options = [NSMutableDictionary dictionaryWithDictionary:options];\n } else {\n options = [NSMutableDictionary dictionaryWithCapacity:1];\n }\n [options setObject:[NSNumber numberWithInt:1] forKey:@\"getDir\"];\n if ([arguments count] >= 3) {\n [arguments replaceObjectAtIndex:2 withObject:options];\n } else {\n [arguments addObject:options];\n }\n CDVInvokedUrlCommand* subCommand =\n [[CDVInvokedUrlCommand alloc] initWithArguments:arguments\n callbackId:command.callbackId\n className:command.className\n methodName:command.methodName];\n\n [self getFile:subCommand];\n}\n\n/* Part of DirectoryEntry interface, creates or returns the specified file\n * IN:\n *\tNSString* baseURI - local filesytem URI for the base directory to search\n *\tNSString* requestedPath - file to be created/returned; may be absolute path or relative path\n *\tNSDictionary* options - Flags object\n *\t\tboolean as NSNumber create -\n *\t\t\tif create is true and file does not exist, create file and return File entry\n *\t\t\tif create is true and exclusive is true and file does exist, return error\n *\t\t\tif create is false and file does not exist, return error\n *\t\t\tif create is false and the path represents a directory, return error\n *\t\tboolean as NSNumber exclusive - used in conjunction with create\n *\t\t\tif exclusive is true and create is true - specifies failure if file already exists\n */\n- (void)getFile:(CDVInvokedUrlCommand*)command\n{\n NSString* baseURIstr = [command argumentAtIndex:0];\n CDVFilesystemURL* baseURI = [self fileSystemURLforArg:baseURIstr];\n NSString* requestedPath = [command argumentAtIndex:1];\n NSDictionary* options = [command argumentAtIndex:2 withDefault:nil];\n\n NSObject *fs = [self filesystemForURL:baseURI];\n CDVPluginResult* result = [fs getFileForURL:baseURI requestedPath:requestedPath options:options];\n\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n/*\n * Look up the parent Entry containing this Entry.\n * If this Entry is the root of its filesystem, its parent is itself.\n * IN:\n * NSArray* arguments\n *\t0 - NSString* localURI\n * NSMutableDictionary* options\n *\tempty\n */\n- (void)getParent:(CDVInvokedUrlCommand*)command\n{\n // arguments are URL encoded\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n\n NSObject *fs = [self filesystemForURL:localURI];\n CDVPluginResult* result = [fs getParentForURL:localURI];\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n/*\n * set MetaData of entry\n * Currently we only support \"com.apple.MobileBackup\" (boolean)\n */\n- (void)setMetadata:(CDVInvokedUrlCommand*)command\n{\n // arguments\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n NSDictionary* options = [command argumentAtIndex:1 withDefault:nil];\n NSObject *fs = [self filesystemForURL:localURI];\n CDVPluginResult* result = [fs setMetadataForURL:localURI withObject:options];\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n/* removes the directory or file entry\n * IN:\n * NSArray* arguments\n *\t0 - NSString* localURI\n *\n * returns NO_MODIFICATION_ALLOWED_ERR if is top level directory or no permission to delete dir\n * returns INVALID_MODIFICATION_ERR if is non-empty dir or asset library file\n * returns NOT_FOUND_ERR if file or dir is not found\n*/\n- (void)remove:(CDVInvokedUrlCommand*)command\n{\n // arguments\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n CDVPluginResult* result = nil;\n\n if ([localURI.fullPath isEqualToString:@\"\"]) {\n // error if try to remove top level (documents or tmp) dir\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NO_MODIFICATION_ALLOWED_ERR];\n } else {\n NSObject *fs = [self filesystemForURL:localURI];\n result = [fs removeFileAtURL:localURI];\n }\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n/* recursively removes the directory\n * IN:\n * NSArray* arguments\n *\t0 - NSString* localURI\n *\n * returns NO_MODIFICATION_ALLOWED_ERR if is top level directory or no permission to delete dir\n * returns NOT_FOUND_ERR if file or dir is not found\n */\n- (void)removeRecursively:(CDVInvokedUrlCommand*)command\n{\n // arguments\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n CDVPluginResult* result = nil;\n\n if ([localURI.fullPath isEqualToString:@\"\"]) {\n // error if try to remove top level (documents or tmp) dir\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NO_MODIFICATION_ALLOWED_ERR];\n } else {\n NSObject *fs = [self filesystemForURL:localURI];\n result = [fs recursiveRemoveFileAtURL:localURI];\n }\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n- (void)copyTo:(CDVInvokedUrlCommand*)command\n{\n [self doCopyMove:command isCopy:YES];\n}\n\n- (void)moveTo:(CDVInvokedUrlCommand*)command\n{\n [self doCopyMove:command isCopy:NO];\n}\n\n/* Copy/move a file or directory to a new location\n * IN:\n * NSArray* arguments\n *\t0 - NSString* URL of entry to copy\n * 1 - NSString* URL of the directory into which to copy/move the entry\n * 2 - Optionally, the new name of the entry, defaults to the current name\n *\tBOOL - bCopy YES if copy, NO if move\n */\n- (void)doCopyMove:(CDVInvokedUrlCommand*)command isCopy:(BOOL)bCopy\n{\n NSArray* arguments = command.arguments;\n\n // arguments\n NSString* srcURLstr = [command argumentAtIndex:0];\n NSString* destURLstr = [command argumentAtIndex:1];\n\n CDVPluginResult *result;\n\n if (!srcURLstr || !destURLstr) {\n // either no source or no destination provided\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NOT_FOUND_ERR];\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n return;\n }\n\n CDVFilesystemURL* srcURL = [self fileSystemURLforArg:srcURLstr];\n CDVFilesystemURL* destURL = [self fileSystemURLforArg:destURLstr];\n\n NSObject *srcFs = [self filesystemForURL:srcURL];\n NSObject *destFs = [self filesystemForURL:destURL];\n\n // optional argument; use last component from srcFullPath if new name not provided\n NSString* newName = ([arguments count] > 2) ? [command argumentAtIndex:2] : [srcURL.url lastPathComponent];\n if ([newName rangeOfString:@\":\"].location != NSNotFound) {\n // invalid chars in new name\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:ENCODING_ERR];\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n return;\n }\n\n [destFs copyFileToURL:destURL withName:newName fromFileSystem:srcFs atURL:srcURL copy:bCopy callback:^(CDVPluginResult* result) {\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n }];\n\n}\n\n- (void)getFileMetadata:(CDVInvokedUrlCommand*)command\n{\n // arguments\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n NSObject *fs = [self filesystemForURL:localURI];\n\n [fs getFileMetadataForURL:localURI callback:^(CDVPluginResult* result) {\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n }];\n}\n\n- (void)readEntries:(CDVInvokedUrlCommand*)command\n{\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n NSObject *fs = [self filesystemForURL:localURI];\n CDVPluginResult *result = [fs readEntriesAtURL:localURI];\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n/* read and return file data\n * IN:\n * NSArray* arguments\n *\t0 - NSString* fullPath\n *\t1 - NSString* encoding\n *\t2 - NSString* start\n *\t3 - NSString* end\n */\n- (void)readAsText:(CDVInvokedUrlCommand*)command\n{\n // arguments\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n NSString* encoding = [command argumentAtIndex:1];\n NSInteger start = [[command argumentAtIndex:2] integerValue];\n NSInteger end = [[command argumentAtIndex:3] integerValue];\n\n NSObject *fs = [self filesystemForURL:localURI];\n\n if (fs == nil) {\n CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NOT_FOUND_ERR];\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n return;\n }\n\n // TODO: implement\n if ([@\"UTF-8\" caseInsensitiveCompare : encoding] != NSOrderedSame) {\n NSLog(@\"Only UTF-8 encodings are currently supported by readAsText\");\n CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:ENCODING_ERR];\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n return;\n }\n\n [self.commandDelegate runInBackground:^ {\n [fs readFileAtURL:localURI start:start end:end callback:^(NSData* data, NSString* mimeType, CDVFileError errorCode) {\n CDVPluginResult* result = nil;\n if (data != nil) {\n NSString* str = [[NSString alloc] initWithBytesNoCopy:(void*)[data bytes] length:[data length] encoding:NSUTF8StringEncoding freeWhenDone:NO];\n // Check that UTF8 conversion did not fail.\n if (str != nil) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:str];\n result.associatedObject = data;\n } else {\n errorCode = ENCODING_ERR;\n }\n }\n if (result == nil) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:errorCode];\n }\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n }];\n }];\n}\n\n/* Read content of text file and return as base64 encoded data url.\n * IN:\n * NSArray* arguments\n *\t0 - NSString* fullPath\n *\t1 - NSString* start\n *\t2 - NSString* end\n *\n * Determines the mime type from the file extension, returns ENCODING_ERR if mimetype can not be determined.\n */\n\n- (void)readAsDataURL:(CDVInvokedUrlCommand*)command\n{\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n NSInteger start = [[command argumentAtIndex:1] integerValue];\n NSInteger end = [[command argumentAtIndex:2] integerValue];\n\n NSObject *fs = [self filesystemForURL:localURI];\n\n [self.commandDelegate runInBackground:^ {\n [fs readFileAtURL:localURI start:start end:end callback:^(NSData* data, NSString* mimeType, CDVFileError errorCode) {\n CDVPluginResult* result = nil;\n if (data != nil) {\n NSString* b64Str = toBase64(data);\n NSString* output = [NSString stringWithFormat:@\"data:%@;base64,%@\", mimeType, b64Str];\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:output];\n } else {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:errorCode];\n }\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n }];\n }];\n}\n\n/* Read content of text file and return as an arraybuffer\n * IN:\n * NSArray* arguments\n *\t0 - NSString* fullPath\n *\t1 - NSString* start\n *\t2 - NSString* end\n */\n\n- (void)readAsArrayBuffer:(CDVInvokedUrlCommand*)command\n{\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n NSInteger start = [[command argumentAtIndex:1] integerValue];\n NSInteger end = [[command argumentAtIndex:2] integerValue];\n\n NSObject *fs = [self filesystemForURL:localURI];\n\n [self.commandDelegate runInBackground:^ {\n [fs readFileAtURL:localURI start:start end:end callback:^(NSData* data, NSString* mimeType, CDVFileError errorCode) {\n CDVPluginResult* result = nil;\n if (data != nil) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsArrayBuffer:data];\n } else {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:errorCode];\n }\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n }];\n }];\n}\n\n- (void)readAsBinaryString:(CDVInvokedUrlCommand*)command\n{\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n NSInteger start = [[command argumentAtIndex:1] integerValue];\n NSInteger end = [[command argumentAtIndex:2] integerValue];\n\n NSObject *fs = [self filesystemForURL:localURI];\n\n [self.commandDelegate runInBackground:^ {\n [fs readFileAtURL:localURI start:start end:end callback:^(NSData* data, NSString* mimeType, CDVFileError errorCode) {\n CDVPluginResult* result = nil;\n if (data != nil) {\n NSString* payload = [[NSString alloc] initWithBytesNoCopy:(void*)[data bytes] length:[data length] encoding:NSASCIIStringEncoding freeWhenDone:NO];\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload];\n result.associatedObject = data;\n } else {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:errorCode];\n }\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n }];\n }];\n}\n\n\n- (void)truncate:(CDVInvokedUrlCommand*)command\n{\n // arguments\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n unsigned long long pos = (unsigned long long)[[command argumentAtIndex:1] longLongValue];\n\n NSObject *fs = [self filesystemForURL:localURI];\n CDVPluginResult *result = [fs truncateFileAtURL:localURI atPosition:pos];\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n/* write\n * IN:\n * NSArray* arguments\n * 0 - NSString* localURI of file to write to\n * 1 - NSString* or NSData* data to write\n * 2 - NSNumber* position to begin writing\n */\n- (void)write:(CDVInvokedUrlCommand*)command\n{\n [self.commandDelegate runInBackground:^ {\n NSString* callbackId = command.callbackId;\n\n // arguments\n CDVFilesystemURL* localURI = [self fileSystemURLforArg:command.arguments[0]];\n id argData = [command argumentAtIndex:1];\n unsigned long long pos = (unsigned long long)[[command argumentAtIndex:2] longLongValue];\n\n NSObject *fs = [self filesystemForURL:localURI];\n\n\n [fs truncateFileAtURL:localURI atPosition:pos];\n CDVPluginResult *result;\n if ([argData isKindOfClass:[NSString class]]) {\n NSData *encData = [argData dataUsingEncoding:NSUTF8StringEncoding allowLossyConversion:YES];\n result = [fs writeToFileAtURL:localURI withData:encData append:YES];\n } else if ([argData isKindOfClass:[NSData class]]) {\n result = [fs writeToFileAtURL:localURI withData:argData append:YES];\n } else {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@\"Invalid parameter type\"];\n }\n [self.commandDelegate sendPluginResult:result callbackId:callbackId];\n }];\n}\n\n#pragma mark Methods for converting between URLs and paths\n\n- (NSString *)filesystemPathForURL:(CDVFilesystemURL *)localURL\n{\n for (NSObject *fs in self.fileSystems) {\n if ([fs.name isEqualToString:localURL.fileSystemName]) {\n if ([fs respondsToSelector:@selector(filesystemPathForURL:)]) {\n return [fs filesystemPathForURL:localURL];\n }\n }\n }\n return nil;\n}\n\n#pragma mark Undocumented Filesystem API\n\n- (void)testFileExists:(CDVInvokedUrlCommand*)command\n{\n // arguments\n NSString* argPath = [command argumentAtIndex:0];\n\n // Get the file manager\n NSFileManager* fMgr = [NSFileManager defaultManager];\n NSString* appFile = argPath; // [ self getFullPath: argPath];\n\n BOOL bExists = [fMgr fileExistsAtPath:appFile];\n CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsInt:(bExists ? 1 : 0)];\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n- (void)testDirectoryExists:(CDVInvokedUrlCommand*)command\n{\n // arguments\n NSString* argPath = [command argumentAtIndex:0];\n\n // Get the file manager\n NSFileManager* fMgr = [[NSFileManager alloc] init];\n NSString* appFile = argPath; // [self getFullPath: argPath];\n BOOL bIsDir = NO;\n BOOL bExists = [fMgr fileExistsAtPath:appFile isDirectory:&bIsDir];\n\n CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsInt:((bExists && bIsDir) ? 1 : 0)];\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n// Returns number of bytes available via callback\n- (void)getFreeDiskSpace:(CDVInvokedUrlCommand*)command\n{\n // no arguments\n\n NSNumber* pNumAvail = [self checkFreeDiskSpace:self.appDocsPath];\n\n NSString* strFreeSpace = [NSString stringWithFormat:@\"%qu\", [pNumAvail unsignedLongLongValue]];\n // NSLog(@\"Free space is %@\", strFreeSpace );\n\n CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:strFreeSpace];\n\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n#pragma mark Compatibility with older File API\n\n- (NSString*)getMimeTypeFromPath:(NSString*)fullPath\n{\n return [CDVLocalFilesystem getMimeTypeFromPath:fullPath];\n}\n\n- (NSDictionary *)getDirectoryEntry:(NSString *)localPath isDirectory:(BOOL)bDirRequest\n{\n CDVFilesystemURL *localURL = [self fileSystemURLforLocalPath:localPath];\n return [self makeEntryForPath:localURL.fullPath fileSystemName:localURL.fileSystemName isDirectory:bDirRequest];\n}\n\n#pragma mark Internal methods for testing\n// Internal methods for testing: Get the on-disk location of a local filesystem url.\n// [Currently used for testing file-transfer]\n\n- (void)_getLocalFilesystemPath:(CDVInvokedUrlCommand*)command\n{\n CDVFilesystemURL* localURL = [self fileSystemURLforArg:command.arguments[0]];\n\n NSString* fsPath = [self filesystemPathForURL:localURL];\n CDVPluginResult* result;\n if (fsPath) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:fsPath];\n } else {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@\"Cannot resolve URL to a file\"];\n }\n [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];\n}\n\n@end\n"
},
{
"path": "plugins/cordova-plugin-file/src/osx/CDVLocalFilesystem.h",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\n\n#import \"CDVFile.h\"\n\n@interface CDVLocalFilesystem : NSObject {\n NSString *_name;\n NSString *_fsRoot;\n}\n\n- (id) initWithName:(NSString *)name root:(NSString *)fsRoot;\n+ (NSString*)getMimeTypeFromPath:(NSString*)fullPath;\n\n@property (nonatomic,strong) NSString *fsRoot;\n\n@end\n"
},
{
"path": "plugins/cordova-plugin-file/src/osx/CDVLocalFilesystem.m",
"content": "/*\n Licensed to the Apache Software Foundation (ASF) under one\n or more contributor license agreements. See the NOTICE file\n distributed with this work for additional information\n regarding copyright ownership. The ASF licenses this file\n to you under the Apache License, Version 2.0 (the\n \"License\"); you may not use this file except in compliance\n with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing,\n software distributed under the License is distributed on an\n \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, either express or implied. See the License for the\n specific language governing permissions and limitations\n under the License.\n */\n\n#import \"CDVFile.h\"\n#import \"CDVLocalFilesystem.h\"\n#import \n\n@implementation CDVLocalFilesystem\n@synthesize name=_name, fsRoot=_fsRoot, urlTransformer;\n\n- (id) initWithName:(NSString *)name root:(NSString *)fsRoot\n{\n if (self) {\n _name = name;\n _fsRoot = fsRoot;\n }\n return self;\n}\n\n/*\n * IN\n * NSString localURI\n * OUT\n * CDVPluginResult result containing a file or directoryEntry for the localURI, or an error if the\n * URI represents a non-existent path, or is unrecognized or otherwise malformed.\n */\n- (CDVPluginResult *)entryForLocalURI:(CDVFilesystemURL *)url\n{\n CDVPluginResult* result = nil;\n NSDictionary* entry = [self makeEntryForLocalURL:url];\n if (entry) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:entry];\n } else {\n // return NOT_FOUND_ERR\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NOT_FOUND_ERR];\n }\n return result;\n}\n- (NSDictionary *)makeEntryForLocalURL:(CDVFilesystemURL *)url {\n NSString *path = [self filesystemPathForURL:url];\n NSFileManager* fileMgr = [[NSFileManager alloc] init];\n BOOL isDir = NO;\n // see if exists and is file or dir\n BOOL bExists = [fileMgr fileExistsAtPath:path isDirectory:&isDir];\n if (bExists) {\n return [self makeEntryForPath:url.fullPath isDirectory:isDir];\n } else {\n return nil;\n }\n}\n- (NSDictionary*)makeEntryForPath:(NSString*)fullPath isDirectory:(BOOL)isDir\n{\n NSMutableDictionary* dirEntry = [NSMutableDictionary dictionaryWithCapacity:5];\n NSString* lastPart = [[self stripQueryParametersFromPath:fullPath] lastPathComponent];\n if (isDir && ![fullPath hasSuffix:@\"/\"]) {\n fullPath = [fullPath stringByAppendingString:@\"/\"];\n }\n [dirEntry setObject:[NSNumber numberWithBool:!isDir] forKey:@\"isFile\"];\n [dirEntry setObject:[NSNumber numberWithBool:isDir] forKey:@\"isDirectory\"];\n [dirEntry setObject:fullPath forKey:@\"fullPath\"];\n [dirEntry setObject:lastPart forKey:@\"name\"];\n [dirEntry setObject:self.name forKey: @\"filesystemName\"];\n\n NSURL* nativeURL = [NSURL fileURLWithPath:[self filesystemPathForFullPath:fullPath]];\n if (self.urlTransformer) {\n nativeURL = self.urlTransformer(nativeURL);\n }\n\n dirEntry[@\"nativeURL\"] = [nativeURL absoluteString];\n\n return dirEntry;\n}\n\n- (NSString *)stripQueryParametersFromPath:(NSString *)fullPath\n{\n NSRange questionMark = [fullPath rangeOfString:@\"?\"];\n if (questionMark.location != NSNotFound) {\n return [fullPath substringWithRange:NSMakeRange(0,questionMark.location)];\n }\n return fullPath;\n}\n\n- (NSString *)filesystemPathForFullPath:(NSString *)fullPath\n{\n NSString *path = nil;\n NSString *strippedFullPath = [self stripQueryParametersFromPath:fullPath];\n path = [NSString stringWithFormat:@\"%@%@\", self.fsRoot, strippedFullPath];\n if ([path length] > 1 && [path hasSuffix:@\"/\"]) {\n path = [path substringToIndex:([path length]-1)];\n }\n return path;\n}\n/*\n * IN\n * NSString localURI\n * OUT\n * NSString full local filesystem path for the represented file or directory, or nil if no such path is possible\n * The file or directory does not necessarily have to exist. nil is returned if the filesystem type is not recognized,\n * or if the URL is malformed.\n * The incoming URI should be properly escaped (no raw spaces, etc. URI percent-encoding is expected).\n */\n- (NSString *)filesystemPathForURL:(CDVFilesystemURL *)url\n{\n return [self filesystemPathForFullPath:url.fullPath];\n}\n\n- (CDVFilesystemURL *)URLforFullPath:(NSString *)fullPath\n{\n if (fullPath) {\n NSString* escapedPath = [fullPath stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];\n if ([fullPath hasPrefix:@\"/\"]) {\n return [CDVFilesystemURL fileSystemURLWithString:[NSString stringWithFormat:@\"%@://localhost/%@%@\", kCDVFilesystemURLPrefix, self.name, escapedPath]];\n }\n return [CDVFilesystemURL fileSystemURLWithString:[NSString stringWithFormat:@\"%@://localhost/%@/%@\", kCDVFilesystemURLPrefix, self.name, escapedPath]];\n }\n return nil;\n}\n\n- (CDVFilesystemURL *)URLforFilesystemPath:(NSString *)path\n{\n return [self URLforFullPath:[self fullPathForFileSystemPath:path]];\n\n}\n\n- (NSString *)normalizePath:(NSString *)rawPath\n{\n // If this is an absolute path, the first path component will be '/'. Skip it if that's the case\n BOOL isAbsolutePath = [rawPath hasPrefix:@\"/\"];\n if (isAbsolutePath) {\n rawPath = [rawPath substringFromIndex:1];\n }\n NSMutableArray *components = [NSMutableArray arrayWithArray:[rawPath pathComponents]];\n for (int index = 0; index < [components count]; ++index) {\n if ([[components objectAtIndex:index] isEqualToString:@\"..\"]) {\n [components removeObjectAtIndex:index];\n if (index > 0) {\n [components removeObjectAtIndex:index-1];\n --index;\n }\n }\n }\n\n if (isAbsolutePath) {\n return [NSString stringWithFormat:@\"/%@\", [components componentsJoinedByString:@\"/\"]];\n } else {\n return [components componentsJoinedByString:@\"/\"];\n }\n\n\n}\n\n- (BOOL)valueForKeyIsNumber:(NSDictionary*)dict key:(NSString*)key\n{\n BOOL bNumber = NO;\n NSObject* value = dict[key];\n if (value) {\n bNumber = [value isKindOfClass:[NSNumber class]];\n }\n return bNumber;\n}\n\n- (CDVPluginResult *)getFileForURL:(CDVFilesystemURL *)baseURI requestedPath:(NSString *)requestedPath options:(NSDictionary *)options\n{\n CDVPluginResult* result = nil;\n BOOL bDirRequest = NO;\n BOOL create = NO;\n BOOL exclusive = NO;\n int errorCode = 0; // !!! risky - no error code currently defined for 0\n\n if ([self valueForKeyIsNumber:options key:@\"create\"]) {\n create = [(NSNumber*)[options valueForKey:@\"create\"] boolValue];\n }\n if ([self valueForKeyIsNumber:options key:@\"exclusive\"]) {\n exclusive = [(NSNumber*)[options valueForKey:@\"exclusive\"] boolValue];\n }\n if ([self valueForKeyIsNumber:options key:@\"getDir\"]) {\n // this will not exist for calls directly to getFile but will have been set by getDirectory before calling this method\n bDirRequest = [(NSNumber*)[options valueForKey:@\"getDir\"] boolValue];\n }\n // see if the requested path has invalid characters - should we be checking for more than just \":\"?\n if ([requestedPath rangeOfString:@\":\"].location != NSNotFound) {\n errorCode = ENCODING_ERR;\n } else {\n // Build new fullPath for the requested resource.\n // We concatenate the two paths together, and then scan the resulting string to remove\n // parent (\"..\") references. Any parent references at the beginning of the string are\n // silently removed.\n NSString *combinedPath = [baseURI.fullPath stringByAppendingPathComponent:requestedPath];\n combinedPath = [self normalizePath:combinedPath];\n CDVFilesystemURL* requestedURL = [self URLforFullPath:combinedPath];\n\n NSFileManager* fileMgr = [[NSFileManager alloc] init];\n BOOL bIsDir;\n BOOL bExists = [fileMgr fileExistsAtPath:[self filesystemPathForURL:requestedURL] isDirectory:&bIsDir];\n if (bExists && (create == NO) && (bIsDir == !bDirRequest)) {\n // path exists and is not of requested type - return TYPE_MISMATCH_ERR\n errorCode = TYPE_MISMATCH_ERR;\n } else if (!bExists && (create == NO)) {\n // path does not exist and create is false - return NOT_FOUND_ERR\n errorCode = NOT_FOUND_ERR;\n } else if (bExists && (create == YES) && (exclusive == YES)) {\n // file/dir already exists and exclusive and create are both true - return PATH_EXISTS_ERR\n errorCode = PATH_EXISTS_ERR;\n } else {\n // if bExists and create == YES - just return data\n // if bExists and create == NO - just return data\n // if !bExists and create == YES - create and return data\n BOOL bSuccess = YES;\n NSError __autoreleasing* pError = nil;\n if (!bExists && (create == YES)) {\n if (bDirRequest) {\n // create the dir\n bSuccess = [fileMgr createDirectoryAtPath:[self filesystemPathForURL:requestedURL] withIntermediateDirectories:NO attributes:nil error:&pError];\n } else {\n // create the empty file\n bSuccess = [fileMgr createFileAtPath:[self filesystemPathForURL:requestedURL] contents:nil attributes:nil];\n }\n }\n if (!bSuccess) {\n errorCode = ABORT_ERR;\n if (pError) {\n NSLog(@\"error creating directory: %@\", [pError localizedDescription]);\n }\n } else {\n // NSLog(@\"newly created file/dir (%@) exists: %d\", reqFullPath, [fileMgr fileExistsAtPath:reqFullPath]);\n // file existed or was created\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:[self makeEntryForPath:requestedURL.fullPath isDirectory:bDirRequest]];\n }\n } // are all possible conditions met?\n }\n\n if (errorCode > 0) {\n // create error callback\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:errorCode];\n }\n return result;\n\n}\n\n- (CDVPluginResult*)getParentForURL:(CDVFilesystemURL *)localURI\n{\n CDVPluginResult* result = nil;\n CDVFilesystemURL *newURI = nil;\n if ([localURI.fullPath isEqualToString:@\"\"]) {\n // return self\n newURI = localURI;\n } else {\n newURI = [CDVFilesystemURL fileSystemURLWithURL:[localURI.url URLByDeletingLastPathComponent]]; /* TODO: UGLY - FIX */\n }\n NSFileManager* fileMgr = [[NSFileManager alloc] init];\n BOOL bIsDir;\n BOOL bExists = [fileMgr fileExistsAtPath:[self filesystemPathForURL:newURI] isDirectory:&bIsDir];\n if (bExists) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:[self makeEntryForPath:newURI.fullPath isDirectory:bIsDir]];\n } else {\n // invalid path or file does not exist\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NOT_FOUND_ERR];\n }\n return result;\n}\n\n- (CDVPluginResult*)setMetadataForURL:(CDVFilesystemURL *)localURI withObject:(NSDictionary *)options\n{\n BOOL ok = NO;\n\n NSString* filePath = [self filesystemPathForURL:localURI];\n // we only care about this iCloud key for now.\n // set to 1/true to skip backup, set to 0/false to back it up (effectively removing the attribute)\n NSString* iCloudBackupExtendedAttributeKey = @\"com.apple.MobileBackup\";\n id iCloudBackupExtendedAttributeValue = [options objectForKey:iCloudBackupExtendedAttributeKey];\n\n if ((iCloudBackupExtendedAttributeValue != nil) && [iCloudBackupExtendedAttributeValue isKindOfClass:[NSNumber class]]) {\n// todo: fix me\n// if (IsAtLeastiOSVersion(@\"5.1\")) {\n// NSURL* url = [NSURL fileURLWithPath:filePath];\n// NSError* __autoreleasing error = nil;\n//\n// ok = [url setResourceValue:[NSNumber numberWithBool:[iCloudBackupExtendedAttributeValue boolValue]] forKey:NSURLIsExcludedFromBackupKey error:&error];\n// } else { // below 5.1 (deprecated - only really supported in 5.01)\n// u_int8_t value = [iCloudBackupExtendedAttributeValue intValue];\n// if (value == 0) { // remove the attribute (allow backup, the default)\n// ok = (removexattr([filePath fileSystemRepresentation], [iCloudBackupExtendedAttributeKey cStringUsingEncoding:NSUTF8StringEncoding], 0) == 0);\n// } else { // set the attribute (skip backup)\n// ok = (setxattr([filePath fileSystemRepresentation], [iCloudBackupExtendedAttributeKey cStringUsingEncoding:NSUTF8StringEncoding], &value, sizeof(value), 0, 0) == 0);\n// }\n// }\n }\n\n if (ok) {\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];\n } else {\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];\n }\n}\n\n/* remove the file or directory (recursively)\n * IN:\n * NSString* fullPath - the full path to the file or directory to be removed\n * NSString* callbackId\n * called from remove and removeRecursively - check all pubic api specific error conditions (dir not empty, etc) before calling\n */\n\n- (CDVPluginResult*)doRemove:(NSString*)fullPath\n{\n CDVPluginResult* result = nil;\n BOOL bSuccess = NO;\n NSError* __autoreleasing pError = nil;\n NSFileManager* fileMgr = [[NSFileManager alloc] init];\n\n @try {\n bSuccess = [fileMgr removeItemAtPath:fullPath error:&pError];\n if (bSuccess) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];\n } else {\n // see if we can give a useful error\n CDVFileError errorCode = ABORT_ERR;\n NSLog(@\"error removing filesystem entry at %@: %@\", fullPath, [pError localizedDescription]);\n if ([pError code] == NSFileNoSuchFileError) {\n errorCode = NOT_FOUND_ERR;\n } else if ([pError code] == NSFileWriteNoPermissionError) {\n errorCode = NO_MODIFICATION_ALLOWED_ERR;\n }\n\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:errorCode];\n }\n } @catch(NSException* e) { // NSInvalidArgumentException if path is . or ..\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:SYNTAX_ERR];\n }\n\n return result;\n}\n\n- (CDVPluginResult *)removeFileAtURL:(CDVFilesystemURL *)localURI\n{\n NSString *fileSystemPath = [self filesystemPathForURL:localURI];\n\n NSFileManager* fileMgr = [[NSFileManager alloc] init];\n BOOL bIsDir = NO;\n BOOL bExists = [fileMgr fileExistsAtPath:fileSystemPath isDirectory:&bIsDir];\n if (!bExists) {\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NOT_FOUND_ERR];\n }\n if (bIsDir && ([[fileMgr contentsOfDirectoryAtPath:fileSystemPath error:nil] count] != 0)) {\n // dir is not empty\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:INVALID_MODIFICATION_ERR];\n }\n return [self doRemove:fileSystemPath];\n}\n\n- (CDVPluginResult *)recursiveRemoveFileAtURL:(CDVFilesystemURL *)localURI\n{\n NSString *fileSystemPath = [self filesystemPathForURL:localURI];\n return [self doRemove:fileSystemPath];\n}\n\n/*\n * IN\n * NSString localURI\n * OUT\n * NSString full local filesystem path for the represented file or directory, or nil if no such path is possible\n * The file or directory does not necessarily have to exist. nil is returned if the filesystem type is not recognized,\n * or if the URL is malformed.\n * The incoming URI should be properly escaped (no raw spaces, etc. URI percent-encoding is expected).\n */\n- (NSString *)fullPathForFileSystemPath:(NSString *)fsPath\n{\n if ([fsPath hasPrefix:self.fsRoot]) {\n return [fsPath substringFromIndex:[self.fsRoot length]];\n }\n return nil;\n}\n\n\n- (CDVPluginResult *)readEntriesAtURL:(CDVFilesystemURL *)localURI\n{\n NSFileManager* fileMgr = [[NSFileManager alloc] init];\n NSError* __autoreleasing error = nil;\n NSString *fileSystemPath = [self filesystemPathForURL:localURI];\n\n NSArray* contents = [fileMgr contentsOfDirectoryAtPath:fileSystemPath error:&error];\n\n if (contents) {\n NSMutableArray* entries = [NSMutableArray arrayWithCapacity:1];\n if ([contents count] > 0) {\n // create an Entry (as JSON) for each file/dir\n for (NSString* name in contents) {\n // see if is dir or file\n NSString* entryPath = [fileSystemPath stringByAppendingPathComponent:name];\n BOOL bIsDir = NO;\n [fileMgr fileExistsAtPath:entryPath isDirectory:&bIsDir];\n NSDictionary* entryDict = [self makeEntryForPath:[self fullPathForFileSystemPath:entryPath] isDirectory:bIsDir];\n [entries addObject:entryDict];\n }\n }\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsArray:entries];\n } else {\n // assume not found but could check error for more specific error conditions\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:NOT_FOUND_ERR];\n }\n}\n\n- (unsigned long long)truncateFile:(NSString*)filePath atPosition:(unsigned long long)pos\n{\n unsigned long long newPos = 0UL;\n\n NSFileHandle* file = [NSFileHandle fileHandleForWritingAtPath:filePath];\n\n if (file) {\n [file truncateFileAtOffset:(unsigned long long)pos];\n newPos = [file offsetInFile];\n [file synchronizeFile];\n [file closeFile];\n }\n return newPos;\n}\n\n- (CDVPluginResult *)truncateFileAtURL:(CDVFilesystemURL *)localURI atPosition:(unsigned long long)pos\n{\n unsigned long long newPos = [self truncateFile:[self filesystemPathForURL:localURI] atPosition:pos];\n return [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsInt:(int)newPos];\n}\n\n- (CDVPluginResult *)writeToFileAtURL:(CDVFilesystemURL *)localURL withData:(NSData*)encData append:(BOOL)shouldAppend\n{\n NSString *filePath = [self filesystemPathForURL:localURL];\n\n CDVPluginResult* result = nil;\n CDVFileError errCode = INVALID_MODIFICATION_ERR;\n int bytesWritten = 0;\n\n if (filePath) {\n NSOutputStream* fileStream = [NSOutputStream outputStreamToFileAtPath:filePath append:shouldAppend];\n if (fileStream) {\n NSUInteger len = [encData length];\n if (len == 0) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDouble:(double)len];\n } else {\n [fileStream open];\n\n bytesWritten = (int)[fileStream write:[encData bytes] maxLength:len];\n\n [fileStream close];\n if (bytesWritten > 0) {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsInt:bytesWritten];\n // } else {\n // can probably get more detailed error info via [fileStream streamError]\n // errCode already set to INVALID_MODIFICATION_ERR;\n // bytesWritten = 0; // may be set to -1 on error\n }\n }\n } // else fileStream not created return INVALID_MODIFICATION_ERR\n } else {\n // invalid filePath\n errCode = NOT_FOUND_ERR;\n }\n if (!result) {\n // was an error\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:errCode];\n }\n return result;\n}\n\n/**\n * Helper function to check to see if the user attempted to copy an entry into its parent without changing its name,\n * or attempted to copy a directory into a directory that it contains directly or indirectly.\n *\n * IN:\n * NSString* srcDir\n * NSString* destinationDir\n * OUT:\n * YES copy/ move is allows\n * NO move is onto itself\n */\n- (BOOL)canCopyMoveSrc:(NSString*)src ToDestination:(NSString*)dest\n{\n // This weird test is to determine if we are copying or moving a directory into itself.\n // Copy /Documents/myDir to /Documents/myDir-backup is okay but\n // Copy /Documents/myDir to /Documents/myDir/backup not okay\n BOOL copyOK = YES;\n NSRange range = [dest rangeOfString:src];\n\n if (range.location != NSNotFound) {\n NSRange testRange = {range.length - 1, ([dest length] - range.length)};\n NSRange resultRange = [dest rangeOfString:@\"/\" options:0 range:testRange];\n if (resultRange.location != NSNotFound) {\n copyOK = NO;\n }\n }\n return copyOK;\n}\n\n- (void)copyFileToURL:(CDVFilesystemURL *)destURL withName:(NSString *)newName fromFileSystem:(NSObject *)srcFs atURL:(CDVFilesystemURL *)srcURL copy:(BOOL)bCopy callback:(void (^)(CDVPluginResult *))callback\n{\n NSFileManager *fileMgr = [[NSFileManager alloc] init];\n NSString *destRootPath = [self filesystemPathForURL:destURL];\n BOOL bDestIsDir = NO;\n BOOL bDestExists = [fileMgr fileExistsAtPath:destRootPath isDirectory:&bDestIsDir];\n\n NSString *newFileSystemPath = [destRootPath stringByAppendingPathComponent:newName];\n NSString *newFullPath = [self fullPathForFileSystemPath:newFileSystemPath];\n\n BOOL bNewIsDir = NO;\n BOOL bNewExists = [fileMgr fileExistsAtPath:newFileSystemPath isDirectory:&bNewIsDir];\n\n CDVPluginResult *result = nil;\n int errCode = 0;\n\n if (!bDestExists) {\n // the destination root does not exist\n errCode = NOT_FOUND_ERR;\n }\n\n else if ([srcFs isKindOfClass:[CDVLocalFilesystem class]]) {\n /* Same FS, we can shortcut with NSFileManager operations */\n NSString *srcFullPath = [srcFs filesystemPathForURL:srcURL];\n\n BOOL bSrcIsDir = NO;\n BOOL bSrcExists = [fileMgr fileExistsAtPath:srcFullPath isDirectory:&bSrcIsDir];\n\n if (!bSrcExists) {\n // the source does not exist\n errCode = NOT_FOUND_ERR;\n } else if ([newFileSystemPath isEqualToString:srcFullPath]) {\n // source and destination can not be the same\n errCode = INVALID_MODIFICATION_ERR;\n } else if (bSrcIsDir && (bNewExists && !bNewIsDir)) {\n // can't copy/move dir to file\n errCode = INVALID_MODIFICATION_ERR;\n } else { // no errors yet\n NSError* __autoreleasing error = nil;\n BOOL bSuccess = NO;\n if (bCopy) {\n if (bSrcIsDir && ![self canCopyMoveSrc:srcFullPath ToDestination:newFileSystemPath]) {\n // can't copy dir into self\n errCode = INVALID_MODIFICATION_ERR;\n } else if (bNewExists) {\n // the full destination should NOT already exist if a copy\n errCode = PATH_EXISTS_ERR;\n } else {\n bSuccess = [fileMgr copyItemAtPath:srcFullPath toPath:newFileSystemPath error:&error];\n }\n } else { // move\n // iOS requires that destination must not exist before calling moveTo\n // is W3C INVALID_MODIFICATION_ERR error if destination dir exists and has contents\n //\n if (!bSrcIsDir && (bNewExists && bNewIsDir)) {\n // can't move a file to directory\n errCode = INVALID_MODIFICATION_ERR;\n } else if (bSrcIsDir && ![self canCopyMoveSrc:srcFullPath ToDestination:newFileSystemPath]) {\n // can't move a dir into itself\n errCode = INVALID_MODIFICATION_ERR;\n } else if (bNewExists) {\n if (bNewIsDir && ([[fileMgr contentsOfDirectoryAtPath:newFileSystemPath error:NULL] count] != 0)) {\n // can't move dir to a dir that is not empty\n errCode = INVALID_MODIFICATION_ERR;\n newFileSystemPath = nil; // so we won't try to move\n } else {\n // remove destination so can perform the moveItemAtPath\n bSuccess = [fileMgr removeItemAtPath:newFileSystemPath error:NULL];\n if (!bSuccess) {\n errCode = INVALID_MODIFICATION_ERR; // is this the correct error?\n newFileSystemPath = nil;\n }\n }\n } else if (bNewIsDir && [newFileSystemPath hasPrefix:srcFullPath]) {\n // can't move a directory inside itself or to any child at any depth;\n errCode = INVALID_MODIFICATION_ERR;\n newFileSystemPath = nil;\n }\n\n if (newFileSystemPath != nil) {\n bSuccess = [fileMgr moveItemAtPath:srcFullPath toPath:newFileSystemPath error:&error];\n }\n }\n if (bSuccess) {\n // should verify it is there and of the correct type???\n NSDictionary* newEntry = [self makeEntryForPath:newFullPath isDirectory:bSrcIsDir];\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:newEntry];\n } else {\n if (error) {\n if (([error code] == NSFileReadUnknownError) || ([error code] == NSFileReadTooLargeError)) {\n errCode = NOT_READABLE_ERR;\n } else if ([error code] == NSFileWriteOutOfSpaceError) {\n errCode = QUOTA_EXCEEDED_ERR;\n } else if ([error code] == NSFileWriteNoPermissionError) {\n errCode = NO_MODIFICATION_ALLOWED_ERR;\n }\n }\n }\n }\n } else {\n // Need to copy the hard way\n [srcFs readFileAtURL:srcURL start:0 end:-1 callback:^(NSData* data, NSString* mimeType, CDVFileError errorCode) {\n CDVPluginResult* result = nil;\n if (data != nil) {\n BOOL bSuccess = [data writeToFile:newFileSystemPath atomically:YES];\n if (bSuccess) {\n // should verify it is there and of the correct type???\n NSDictionary* newEntry = [self makeEntryForPath:newFullPath isDirectory:NO];\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:newEntry];\n } else {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:ABORT_ERR];\n }\n } else {\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:errorCode];\n }\n callback(result);\n }];\n return; // Async IO; return without callback.\n }\n if (result == nil) {\n if (!errCode) {\n errCode = INVALID_MODIFICATION_ERR; // Catch-all default\n }\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_IO_EXCEPTION messageAsInt:errCode];\n }\n callback(result);\n}\n\n/* helper function to get the mimeType from the file extension\n * IN:\n *\tNSString* fullPath - filename (may include path)\n * OUT:\n *\tNSString* the mime type as type/subtype. nil if not able to determine\n */\n+ (NSString*)getMimeTypeFromPath:(NSString*)fullPath\n{\n NSString* mimeType = nil;\n\n if (fullPath) {\n CFStringRef typeId = UTTypeCreatePreferredIdentifierForTag(kUTTagClassFilenameExtension, (__bridge CFStringRef)[fullPath pathExtension], NULL);\n if (typeId) {\n mimeType = (__bridge_transfer NSString*)UTTypeCopyPreferredTagWithClass(typeId, kUTTagClassMIMEType);\n if (!mimeType) {\n // special case for m4a\n if ([(__bridge NSString*)typeId rangeOfString : @\"m4a-audio\"].location != NSNotFound) {\n mimeType = @\"audio/mp4\";\n } else if ([[fullPath pathExtension] rangeOfString:@\"wav\"].location != NSNotFound) {\n mimeType = @\"audio/wav\";\n } else if ([[fullPath pathExtension] rangeOfString:@\"css\"].location != NSNotFound) {\n mimeType = @\"text/css\";\n }\n }\n CFRelease(typeId);\n }\n }\n return mimeType;\n}\n\n- (void)readFileAtURL:(CDVFilesystemURL *)localURL start:(NSInteger)start end:(NSInteger)end callback:(void (^)(NSData*, NSString* mimeType, CDVFileError))callback\n{\n NSString *path = [self filesystemPathForURL:localURL];\n\n NSString* mimeType = [CDVLocalFilesystem getMimeTypeFromPath:path];\n if (mimeType == nil) {\n mimeType = @\"*/*\";\n }\n NSFileHandle* file = [NSFileHandle fileHandleForReadingAtPath:path];\n if (start > 0) {\n [file seekToFileOffset:start];\n }\n\n NSData* readData;\n if (end < 0) {\n readData = [file readDataToEndOfFile];\n } else {\n readData = [file readDataOfLength:(end - start)];\n }\n [file closeFile];\n\n callback(readData, mimeType, readData != nil ? NO_ERROR : NOT_FOUND_ERR);\n}\n\n- (void)getFileMetadataForURL:(CDVFilesystemURL *)localURL callback:(void (^)(CDVPluginResult *))callback\n{\n NSString *path = [self filesystemPathForURL:localURL];\n CDVPluginResult *result;\n NSFileManager* fileMgr = [[NSFileManager alloc] init];\n\n NSError* __autoreleasing error = nil;\n NSDictionary* fileAttrs = [fileMgr attributesOfItemAtPath:path error:&error];\n\n if (fileAttrs) {\n\n // create dictionary of file info\n NSMutableDictionary* fileInfo = [NSMutableDictionary dictionaryWithCapacity:5];\n\n [fileInfo setObject:localURL.fullPath forKey:@\"fullPath\"];\n [fileInfo setObject:@\"\" forKey:@\"type\"]; // can't easily get the mimetype unless create URL, send request and read response so skipping\n [fileInfo setObject:[path lastPathComponent] forKey:@\"name\"];\n\n // Ensure that directories (and other non-regular files) report size of 0\n unsigned long long size = ([fileAttrs fileType] == NSFileTypeRegular ? [fileAttrs fileSize] : 0);\n [fileInfo setObject:[NSNumber numberWithUnsignedLongLong:size] forKey:@\"size\"];\n\n NSDate* modDate = [fileAttrs fileModificationDate];\n if (modDate) {\n [fileInfo setObject:[NSNumber numberWithDouble:[modDate timeIntervalSince1970] * 1000] forKey:@\"lastModifiedDate\"];\n }\n\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:fileInfo];\n\n } else {\n // didn't get fileAttribs\n CDVFileError errorCode = ABORT_ERR;\n NSLog(@\"error getting metadata: %@\", [error localizedDescription]);\n if ([error code] == NSFileNoSuchFileError || [error code] == NSFileReadNoSuchFileError) {\n errorCode = NOT_FOUND_ERR;\n }\n // log [NSNumber numberWithDouble: theMessage] objCtype to see what it returns\n result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:errorCode];\n }\n\n callback(result);\n}\n\n@end\n"
},
{
"path": "plugins/cordova-plugin-file/src/ubuntu/file.cpp",
"content": "/*\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n#include \"file.h\"\n\n#include \n\nnamespace {\n class FileError {\n public:\n static const QString kEncodingErr;\n static const QString kTypeMismatchErr;\n static const QString kNotFoundErr;\n static const QString kSecurityErr;\n static const QString kAbortErr;\n static const QString kNotReadableErr;\n static const QString kNoModificationAllowedErr;\n static const QString kInvalidStateErr;\n static const QString kSyntaxErr;\n static const QString kInvalidModificationErr;\n static const QString kQuotaExceededErr;\n static const QString kPathExistsErr;\n };\n\n bool checkFileName(const QString &name) {\n if (name.contains(\":\")){\n return false;\n }\n return true;\n }\n};\n\nconst QString FileError::kEncodingErr(\"FileError.ENCODING_ERR\");\nconst QString FileError::kTypeMismatchErr(\"FileError.TYPE_MISMATCH_ERR\");\nconst QString FileError::kNotFoundErr(\"FileError.NOT_FOUND_ERR\");\nconst QString FileError::kSecurityErr(\"FileError.SECURITY_ERR\");\nconst QString FileError::kAbortErr(\"FileError.ABORT_ERR\");\nconst QString FileError::kNotReadableErr(\"FileError.NOT_READABLE_ERR\");\nconst QString FileError::kNoModificationAllowedErr(\"FileError.NO_MODIFICATION_ALLOWED_ERR\");\nconst QString FileError::kInvalidStateErr(\"FileError.INVALID_STATE_ERR\");\nconst QString FileError::kSyntaxErr(\"FileError.SYNTAX_ERR\");\nconst QString FileError::kInvalidModificationErr(\"FileError.INVALID_MODIFICATION_ERR\");\nconst QString FileError::kQuotaExceededErr(\"FileError.QUOTA_EXCEEDED_ERR\");\nconst QString FileError::kPathExistsErr(\"FileError.PATH_EXISTS_ERR\");\n\nFile::File(Cordova *cordova) :\n CPlugin(cordova),\n _persistentDir(QString(\"%1/.local/share/%2/persistent\").arg(QDir::homePath()).arg(QCoreApplication::applicationName())) {\n QDir::root().mkpath(_persistentDir.absolutePath());\n}\n\nQVariantMap File::file2map(const QFileInfo &fileInfo) {\n QVariantMap res;\n\n res.insert(\"name\", fileInfo.fileName());\n QPair r = GetRelativePath(fileInfo);\n res.insert(\"fullPath\", QString(\"/\") + r.second);\n res.insert(\"filesystemName\", r.first);\n\n res.insert(\"nativeURL\", QString(\"file://localhost\") + fileInfo.absoluteFilePath());\n res.insert(\"isDirectory\", (int)fileInfo.isDir());\n res.insert(\"isFile\", (int)fileInfo.isFile());\n\n return res;\n}\n\nQVariantMap File::dir2map(const QDir &dir) {\n return file2map(QFileInfo(dir.absolutePath()));\n}\n\nQPair File::GetRelativePath(const QFileInfo &fileInfo) {\n QString fullPath = fileInfo.isDir() ? QDir::cleanPath(fileInfo.absoluteFilePath()) : fileInfo.absoluteFilePath();\n\n QString relativePath1 = _persistentDir.relativeFilePath(fullPath);\n QString relativePath2 = QDir::temp().relativeFilePath(fullPath);\n\n if (!(relativePath1[0] != '.' || relativePath2[0] != '.')) {\n if (relativePath1.size() > relativePath2.size()) {\n return QPair(\"temporary\", relativePath2);\n } else {\n return QPair(\"persistent\", relativePath1);\n }\n }\n\n if (relativePath1[0] != '.')\n return QPair(\"persistent\", relativePath1);\n return QPair(\"temporary\", relativePath2);\n}\n\nvoid File::requestFileSystem(int scId, int ecId, unsigned short type, unsigned long long size) {\n QDir dir;\n\n if (size >= 1000485760){\n this->callback(ecId, FileError::kQuotaExceededErr);\n return;\n }\n\n if (type == 0)\n dir = QDir::temp();\n else\n dir = _persistentDir;\n\n if (type > 1) {\n this->callback(ecId, FileError::kSyntaxErr);\n return;\n } else {\n QVariantMap res;\n res.insert(\"root\", dir2map(dir));\n if (type == 0)\n res.insert(\"name\", \"temporary\");\n else\n res.insert(\"name\", \"persistent\");\n\n this->cb(scId, res);\n }\n}\n\nQPair File::resolveURI(int ecId, const QString &uri) {\n QPair
![](\"cdvfile://localhost/persistent/img/logo.png\"){kind=logo}
\n```\n\n__Note__: This method requires following Content Security rules updates:\n* Add `cdvfile:` scheme to `Content-Security-Policy` meta tag of the index page, e.g.:\n - ``\n* Add `