I was asked this morning to take a look at the Photo Album tutorial as AppBuilder has been chosen as our development platform for an upcoming project. I will say that I was quite impressed with the emulation tools, especially considering that anything is web-based.
However, I ran into a bit of a problem on step 3, "Deploy your app using the companion app". I downloaded the AppBuilder onto my Android (Droid Mini, running 4.4.4) and scanned the QR code generated by the build process. After AppBuilder downloads the app, it fails with this error:
"Your project does not target Apache Cordova 3.6.4 and might not run properly."
A quick check of the embedded cordova-android.js file showed the build label as 3.5.1, so the first issue is that step 3 of the tutorial will not work with the current version of the AppBuilder app on Android as provided. I then jumped through a few hoops in order to get my hands on version 3.6.4 of the Cordova Android Javascript file, but then I discovered the second issue: the cordova-android.js file embedded within the sample app appears to be read-only, so not only can I not run it on AppBuilder, I can't fix it =] I just wanted to let somebody know, this seemed like the right place to do it.
4 Answers, 1 is accepted
Rank 1
I got an e-mail back from the Telerik project team that pointed me to the documentation (documentation which I obviously did not read):
http://docs.telerik.com/platform/appbuilder/configuring-your-project/project-properties-general
If you run into this issue as I did, you can simply change the targeted Cordova version at the project level.
Thanks for posting to the Telerik Developer Forums.
Indeed, the default Cordova version for the tutorial is 3.5.0 (3.5.1 for Android). The latest version of the companion app requires a greater Cordova version, as you were prompted, but since the tutorial does not rely on anything specific to Cordova 3.6.4, it should be running as expected in the companion app.
You can change the Cordova version from your AppBuilder client by following the guidelines from here.
Alter the project version of Cordova to 3.7 and build again. The alert should not be displayed.
On a side note, the tutorial templates will be updated to match the latest Cordova version used in AppBuilder.
Let me know if you have further questions.
Regards,
Anton Dobrev
Telerik
See What's Next in App Development. Register for TelerikNEXT.
Rank 1
Indeed, the default Cordova version for the tutorial is 3.5.0 (3.5.1 for Android). The latest version of the companion app requires a greater Cordova version, as you were prompted, but since the tutorial does not rely on anything specific to Cordova 3.6.4, it should be running as expected in the companion app.
Just to clarify on this statement, the warning would have been no big deal, but as far as I can tell, the application does not run at all in this scenario, just giving me a white screen. After I updated to version 3.7.0 everything worked on my device just fine.
Thanks for specifying that. I wasn't aware that the application was not running properly and would like to offer my apologies for the confusion.
Let me know if further questions arise, I will be happy to help.
Regards,
Anton Dobrev
Telerik
See What's Next in App Development. Register for TelerikNEXT.