jQuery and app framework - please fix

[Adri_v_]

Hi,

I've been using the XDK for a few weeks now and I like it, so great and thanks for all your effort.

I'm used to jQuery so I try to follow this advice given in the generated index.html :

"You may substitute jQuery for the App Framework selector library.
            See http://app-framework-software.intel.com/documentation.php#afui/afui_jquery"

but it's a total mess: 

The 1st link on this page http://app-framework-software.intel.com/documentation.php#afui/afui_jquery
doesn't work

Until recently the 2nd link went straight to the appframework page on github, 
but now at least goes to it's own dedicated plugin page http://plugins.jquery.com/appframework/

However all the links from that page go again to the main appframework page on github : https://github.com/01org/appframework

On that page there's no mention of the plugin and it is not present in the files.

I searched the web and found (old ?) versions of the plugin (jq.appframework.min.js)  but cannot get them to work reliably with the app designer

(I check the solution from user Hamilton on https://software.intel.com/en-us/forums/topic/555056, but it doesn't work)

So is the jquery plugin supported - yes or no ? 
If yes, can someone from Intel please confirm this and fix the links to the download location ?

Or can I switch the XDK to 3.0 - (but will it work in app designer):

"The 3.0 version of App Framework removes the following

1. Query selector library - instead use jQuery* or Zepto*"

[Amrita_C_Intel]

Hello,

You may substitute jQuery for the App Framework selector library.
            See http://app-framework-software.intel.com/documentation.php#afui/afui_jquery"

but it's a total mess: 

The 1st link on this page http://app-framework-software.intel.com/documentation.php#afui/afui_jquery
doesn't work.

I checked this link is working.Both the links are same.

If you are looking for github link- https://github.com/krisrak/jquery-cordova-oauth2

[PaulF_IntelCorp]

A future release of the XDK will include direct support for App Framework 3. AF3 is the version that is currently supported by the author, we'll be phasing out the AF2 support in App Designer as we are able to support AF3 in App Designer. Trying to shoehorn AF3 into an existing App Designer project will likely fail.

You are not required to use App Designer to build your UI. If you are familiar with layout and know how to build the UI layout you need by hand, then you can build your app's UI by hand. App Designer is an optional feature that is best utilized by those who are unfamiliar with or uncomfortable with HTML and CSS.

BTW - AF3 no longer includes a custom version of jQuery, like AF2 did. It relies strictly on standard jQuery (preference is for jQuery 2).

[Adri_v_]

Thanks for your feedback, unfortunately this doesn't answer my questions

Amrita said : 

I checked this link is working.Both the links are same.

If you are looking for github link- https://github.com/krisrak/jquery-cordova-oauth2

Again, the links are not the same and the 1st link is not working - I just get 'not found'  (https://raw.github.com/01org/appframework/master/jq.appframework.js)

 jquery-cordova-oauth2 is not related to appframework or to my question

Paul F said :

You are not required to use App Designer to build your UI.

No, but I like it and it's one of the reasons why I'm using the XDK. 

So all this still leaves open my questions :
can I use jQuery with App Designer ? (your documentation says it's possible)  or do I need to wait until 3.0 
where can I get the appframework jQuery plugin (and can you fix the links on http://app-framework-software.intel.com/documentation.php#afui/afui_jquery) ?

[PaulF_IntelCorp]

Yes, you can use jQuery with AF2.

The AF GitHub repo reflects AF3, so you have to dig into old commits to find AF2 stuff inside of it. The old documentation for AF2 is gone, unfortunately, other than what is inside the old GitHub commits. There are some hints on the old XDK forum, but they are also hard to search. This Internet search query "site:forums.html5dev-software.intel.com app framework jquery" brought up this helpful post.

It's been a while since I did this, but I think, in essence, something like the following is what you need to do (derived from the post above):

<script src="lib/jquery-2.1.0.js" ></script>
<script src="lib/jq.appframework-2.2.js" ></script>
<script src="lib/appframework.ui-2.2.js"></script>

Ian (the maintainer and owner of the App Framework open source project) is on leave, and unavailable to confirm, but I believe the 2.2 branch that is maintained in the App Framework repo is where you want to look for details and documentation regarding AF2. In particular, the jq.appframework.js file you need (for the example above), to make jQuery work with App Framework, is located there: https://github.com/01org/appframework/tree/2.2

If you are using 2.1, which I believe is the version that App Designer uses, you might want to get the sources here: https://github.com/01org/appframework/releases/tag/2.1.1 also from the App Framework GitHub repo, and extract teh jq.appframework.js file.

[SithLord]

I use jQuery with AF2 UI

I recall the designer had issues when the file name contained the jquery version number so if you encounter designer problems you should rename the jquery file and remove the version number.

	<script type="application/javascript" src="lib/jquery.min.js"></script>
	<script type="application/javascript" src="app_framework/2.2/af.ui.jquery.min.js"></script>

[Adri_v_]

Thanks again for the trouble.

When I use the combination below the designer seems to work OK (using other combinations - it didn't render any controls).
But when selecting an element, the designer and mouse cursor stay in 'move' mode - which is unworkable.

<script type="application/javascript" src="lib/jquery.min.js"></script>

2	<script type="application/javascript" src="app_framework/2.2/af.ui.jquery.min.js">

So I'll give up and just wait for a new XDK release where the designer and jQuery work out of the box.

Until then I use the workaround to comment/uncomment files I need for the different situations (build/design)

Which still leaves dead links and incorrect documentation...

[PaulF_IntelCorp]

The new version that uses AF3 still has to go through a review cycle, so it won't show up in the next update, but probably the update after that.

[Vojin_T_]

Hi,

AF3 is included in new developer versions but documentation still do not work. Now how to include jquery libraries and where to get it? 

I included "jquery.min.js" at the end of js include files and now ajax works as in jquery, not as in app framework.
Is "af.ui.jquery.min.js"  needed and then where to find it for AF3 ?

In this framework most of actions are on try and hope it will work principal.
Documentation is minimalistic  and most explanations are in comments which is not enough for professional level.

[PaulF_IntelCorp]

App Framework 3 UI is designed to be used with jQuery (preferably jQ2), it no longer includes a replacement library for jQuery. You should just have to include jquery.js in your index.html before the call to AF3.