[
https://issues.apache.org/jira/browse/CB-5068?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13797349#comment-13797349
]
Tom Himanen commented on CB-5068:
---------------------------------
The documentation mentioned is here:
http://cordova.apache.org/docs/en/3.1.0/cordova_device_device.md.html#Device
In fact, after reading this documentation once again I understood that app must
mean ${app_path}/platforms/android/. Unfortunately I have missed the
potentially existing definition of "app" somewhere in the documentation, and it
wasn't intuitive enough for me to understand it right away. One reason to this
misunderstanding is ${app_path}/www/config.xml. Btw, could
${app_path}/www/config.xml be moved somewhere under
${app_path}/platforms/blackberry since the file is platform-specific? This is
maybe a stupid question, but I don't know yet what this file is. It also
confused me in the beginning.
So, if (app === ${app_path}/platforms/android/) the documentation is coherent
and there is nothing to correct in 3.1.0 documentation. However, it would be
more intuitive to start all the paths from the project directory, because in
BlackBerry's instructions the path for file to be edited is www/plugins.xml. In
my opinion, in the documentation all the paths should be relative to
${app_path} and if there are "variables" or "shortcuts" as "app", for example,
the "variable" should be in italic font or something.
I really don't want to complain. I just want to help improving Cordova. You
have done great job with this project, and I really love things I can do using
Cordova.
> File "app/www/cordova.js" is referenced in "app/www/index.html" but doesn't
> exist.
> ----------------------------------------------------------------------------------
>
> Key: CB-5068
> URL: https://issues.apache.org/jira/browse/CB-5068
> Project: Apache Cordova
> Issue Type: Bug
> Components: CordovaJS
> Affects Versions: 3.1.0
> Environment: Ubuntu 12.04.3 +
> npm 1.3.11 +
> nodejs 0.10.20 +
> Reporter: Tom Himanen
> Assignee: Andrew Grieve
> Priority: Critical
> Labels: cordova-cli, cordovajs, script, ubuntu, www
>
> Is far as I know, "cordova create hello com.example.hello HelloWorld" should
> create cordova.js in hello/www. This doesn't happen though.
> hello/www/index.html references to cordova.js relatively
> (hello/www/cordova.js) but no cordova.js can be found. A screenshot of the
> issue described above can be seen here:
> https://twitter.com/TomHimanen/status/388032198760083456
> This issue can be reproduced by running my Cordova CLI installation script
> version 1.6 (and any later) on clean install of Ubuntu 12.04.3. The script
> can be downloaded here:
> http://static.himanen.info/scripts/install_cordova_cli/install_cordova_cli-1.6.sh
> One weird thing connected with this issue is that a few weeks ago I installed
> Cordova CLI with the script version 1.0
> (http://static.himanen.info/scripts/install_cordova_cli/install_cordova_cli-1.0.sh)
> on one of my virtual machines running Ubuntu 12.04.3, and after running the
> script I had a project with cordova.js in project's www folder. This doesn't
> happen anymore. Because having cordova.js in www was rare, I took a snapshot
> of the virtual machine state to be able to develop mobile applications. I
> took a screenshot of that machine to prove that there really is cordova.js in
> www folder: https://twitter.com/TomHimanen/status/389493699454849024/photo/1
--
This message was sent by Atlassian JIRA
(v6.1#6144)