- How can I get started with Intel XDK?
- Can I use an external editor for development in Intel® XDK?
- How do I get code refactoring capability in Brackets* (the Intel XDK code editor)?
- Why doesn’t my app show up in Google* play for tablets?
- What is the global-settings.xdk file and how do I locate it?
- When do I use the intelxdk.js, xhr.js and cordova.js libraries?
- How do I get my Android (and Crosswalk) keystore file?
- How do I rename my project that is a duplicate of an existing project?
- How do I recover when the Intel XDK hangs or won't start?
- Is Intel XDK an open source project? How can I contribute to the Intel XDK community?
- How do I configure Intel XDK to use 9 patch png for Android* apps splash screen?
- How do I stop AVG from popping up the "General Behavioral Detection" window when Intel XDK is launched?
- What do I specify for "App ID" in Intel XDK under Build Settings?
- Is it possible to modify the Android Manifest with the Intel XDK?
- How can I share my Intel XDK app build?
- Why does my iOS build fail when I am able to test it successfully on a device and the emulator?
- How do I add multiple domains in Domain Access?
- How do I build more than one app using the same Apple developer account?
- How do I include search and spotlight icons as part of my app?
- Does Intel XDK support Modbus TCP communication?
- How do I sign an Android* app using an existing keystore?
- How do I build separately for different Android* versions?
- How do I display the 'Build App Now' button if my display language is not English?
- How do I update my Intel XDK version?
- How do I import my existing HTML5 app into the Intel XDK?
- I am unable to login to App Preview with my Intel XDK password.
- How do I completely uninstall the Intel XDK from my system?
- Is there a tool that can help me highlight syntax issues in Intel XDK?
- How do I delete built apps and test apps from the Intel XDK build servers?
- I need help with the App Security API plugin; where do I find it?
- When I install my app onto my test device Avast antivirus flags it as a possible virus, why?
- How do I add a Brackets extension to the editor that is part of the Intel XDK?
- Why does my app or game require so many permissions on Android when built with the Intel XDK?
- How do I make a copy of an existing Intel XDK project?
- My project does not include a www folder. How do I fix it so it includes a www or source directory?
- Can I install more than one copy of the Intel XDK onto my development system?
- On Apple OS X* and Linux* systems, does the Intel XDK need the OpenSSL* library installed?
- I have a web application that I would like to distribute in app stores without major modifications. Is this possible using the Intel XDK?
- What is the best training approach to using the Intel XDK for a newbie?
- What is the best platform to start building an app with the Intel XDK? And what are the important differences between the Android, iOS and other mobile platforms?
- Is my password encrypted and why is it limited to fifteen characters?
- Why does the Intel XDK take a long time to start on Linux or Mac?
- How do I generate a P12 file on a Windows machine?
How can I get started with Intel XDK?
There are plenty of videos and articles that you can go through here to get started. You could also start with some of our demo apps. It may also help to read Five Useful Tips on Getting Started Building Cordova Mobile Apps with the Intel XDK, which will help you understand some of the differences between developing for a traditional server-based environment and developing for the Intel XDK hybrid Cordova app environment.
Having prior understanding of how to program using HTML, CSS and JavaScript* is crucial to using the Intel XDK. The Intel XDK is primarily a tool for visualizing, debugging and building an app package for distribution.
You can do the following to access our demo apps:
- Select Project tab
- Select "Start a New Project"
- Select "Samples and Demos"
- Create a new project from a demo
If you have specific questions following that, please post it to our forums.
Can I use an external editor for development in Intel® XDK?
Yes, you can open your files and edit them in your favorite editor. However, note that you must use Brackets* to use the "Live Layout Editing" feature. Also, if you are using App Designer (the UI layout tool in Intel XDK) it will make many automatic changes to your index.html file, so it is best not to edit that file externally at the same time you have App Designer open.
Some popular editors among our users include:
- Sublime Text* (Refer to this article for information on the Intel XDK plugin for Sublime Text*)
- Notepad++* for a lighweight editor
- Jetbrains* editors (Webstorm*)
- Vim* the editor
How do I get code refactoring capability in Brackets* (the Intel XDK code editor)?
...to be written...
Why doesn’t my app show up in Google* play for tablets?
...to be written...
What is the global-settings.xdk file and how do I locate it?
global-settings.xdk
contains information about all your projects in the Intel XDK, along with many of the settings related to panels under each tab (Emulate, Debug etc). For example, you can set the emulator to auto-refresh or no-auto-refresh. Modify this file at your own risk and always keep a backup of the original!
You can locate global-settings.xdk
here:
- Mac OS X*
~/Library/Application Support/XDK/global-settings.xdk
- Microsoft Windows*
%LocalAppData%\XDK
- Linux*
~/.config/XDK/global-settings.xdk
If you are having trouble locating this file, you can search for it on your system using something like the following:
- Windows:
> cd /
> dir /s global-settings.xdk
- Mac and Linux:
$ sudo find / -name global-settings.xdk
When do I use the intelxdk.js, xhr.js and cordova.js libraries?
The intelxdk.js and xhr.js libraries were only required for use with the Intel XDK legacy build tiles (which have been retired). The cordova.js library is needed for all Cordova builds. When building with the Cordova tiles, any references to intelxdk.js and xhr.js libraries in your index.html file are ignored.
How do I get my Android (and Crosswalk) keystore file?
Previously you needed to email us, but now you can download your Android (and Crosswalk) keystore file directly. Goto this page https://appcenter.html5tools-software.intel.com/certificate/export.aspx and login (if asked) using your Intel XDK account credentials. You may have to go back to that location a second time after logging in (do this within the same browser tab that you just logged in with to preserve your login credentials).
If successful, there is a link that, when clicked, will generate a request for an "identification code" for retrieving your keystore. Pushing this link will cause an email to be sent to the email address registered to your account. This email will contain your "identification code" but will call it an "authentication code," different term but same thing. Use this "authentication code" that you received by email to fill in the second form on the web page, above. Filing in that form with the code you received will take you to a new page where you will see:
- a "Download keystore" link
- your "key alias"
- your "keystore password"
- your "key password"
Make sure you copy down ALL the information provided! You will need all of that information in order to make use of the keystore. If you lose the password and alias information it will render the key useless!
If the above fails, please send an email to html5tools@intel.com requesting help. It is important that you send that email from the email address associated with your Intel XDK account.
How do I rename my project that is a duplicate of an existing project?
See this FAQ: How do I make a copy of an existing Intel XDK project?
How do I recover when the Intel XDK hangs or won't start?
- If you are running Intel XDK on Windows* it must be Windows* 7 or higher. It will not run reliably on earlier versions.
- Delete the "project-name.xdk" file from the project directory that Intel XDK is trying to open when it starts (it will try to open the project that was open during your last session), then try starting Intel XDK. You will have to "import" your project into Intel XDK again. Importing merely creates the "project-name.xdk" file in your project directory and adds that project to the "global-settings.xdk" file.
- Rename the project directory Intel XDK is trying to open when it starts. Create a new project based on one of the demo apps. Test Intel XDK using that demo app. If everything works, restart Intel XDK and try it again. If it still works, rename your problem project folder back to its original name and open Intel XDK again (it should now open the sample project you previously opened). You may have to re-select your problem project (Intel XDK should have forgotten that project during the previous session).
- Clear Intel XDK's program cache directories and files.
On a Windows machine this can be done using the following on a standard command prompt (administrator is not required):> cd %AppData%\..\Local\XDK
> del *.* /s/q
To locate the "XDK cache" directory on [OS X*] and [Linux*] systems, do the following:$ sudo find / -name global-settings.xdk
$ cd <dir found above>
$ sudo rm -rf *
You might want to save a copy of the "global-settings.xdk" file before you delete that cache directory and copy it back before you restart Intel XDK. Doing so will save you the effort of rebuilding your list of projects. Please refer to this question for information on how to locate the global-settings.xdk file.
- If you save the "global-settings.xdk" file and restored it in the step above and you're still having hang troubles, try deleting the directories and files above, along with the "global-settings.xdk" file and try it again.
- Do not store your project directories on a network share (Intel XDK currently has issues with network shares that have not yet been resolved). This includes folders shared between a Virtual machine (VM) guest and its host machine (for example, if you are running Windows* in a VM running on a Mac* host). This network share issue is a known issue with a fix request in place.
- There have also been issues with running behind a corporate network proxy or firewall. To check them try running Intel XDK from your home network where, presumably, you have a simple NAT router and no proxy or firewall. If things work correctly there then your corporate firewall or proxy may be the source of the problem.
- Issues with Intel XDK account logins can also cause Intel XDK to hang. To confirm that your login is working correctly, go to the Intel XDK App Center and confirm that you can login with your Intel XDK account. While you are there you might also try deleting the offending project(s) from the App Center.
If you can reliably reproduce the problem, please send us a copy of the "xdk.log" file that is stored in the same directory as the "global-settings.xdk" file to html5tools@intel.com.
Is Intel XDK an open source project? How can I contribute to the Intel XDK community?
No, It is not an open source project. However, it utilizes many open source components that are then assembled into Intel XDK. While you cannot contribute directly to the Intel XDK integration effort, you can contribute to the many open source components that make up Intel XDK.
The following open source components are the major elements that are being used by Intel XDK:
- Node-Webkit
- Chromium
- Ripple* emulator
- Brackets* editor
- Weinre* remote debugger
- Crosswalk*
- Cordova*
- App Framework*
How do I configure Intel XDK to use 9 patch png for Android* apps splash screen?
Intel XDK does support the use of 9 patch png for Android* apps splash screen. You can read up more at https://software.intel.com/en-us/xdk/articles/android-splash-screens-using-nine-patch-png on how to create a 9 patch png image and link to an Intel XDK sample using 9 patch png images.
How do I stop AVG from popping up the "General Behavioral Detection" window when Intel XDK is launched?
You can try adding nw.exe as the app that needs an exception in AVG.
What do I specify for "App ID" in Intel XDK under Build Settings?
Your app ID uniquely identifies your app. For example, it can be used to identify your app within Apple’s application services allowing you to use things like in-app purchasing and push notifications.
Here are some useful articles on how to create an App ID:
Is it possible to modify the Android Manifest with the Intel XDK?
You cannot modify the AndroidManifest.xml file directly with our build system, as it only exists in the cloud. However, you may do so by creating a dummy plugin that only contains a plugin.xml file containing directives that can be used to add lines to the AndroidManifest.xml file during the build process. In essence, you add lines to the AndroidManifest.xml file via a local plugin.xml file. Here is an example of a plugin that does just that:
<?xml version="1.0" encoding="UTF-8"?><plugin xmlns="http://apache.org/cordova/ns/plugins/1.0" id="my-custom-intents-plugin" version="1.0.0"><name>My Custom Intents Plugin</name><description>Add Intents to the AndroidManifest.xml</description><license>MIT</license><engines><engine name="cordova" version=">=3.0.0" /></engines><!-- android --><platform name="android"><config-file target="AndroidManifest.xml" parent="/manifest/application"><activity android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale" android:label="@string/app_name" android:launchMode="singleTop" android:name="testa" android:theme="@android:style/Theme.Black.NoTitleBar"><intent-filter><action android:name="android.intent.action.SEND" /><category android:name="android.intent.category.DEFAULT" /><data android:mimeType="*/*" /></intent-filter></activity></config-file></platform></plugin>
You can inspect the AndroidManifest.xml created in an APK, using apktool with the following command line:
$ apktool d my-app.apk $ cd my-app $ more AndroidManifest.xml
This technique exploits the config-file element that is described in the Cordova Plugin Specification docs and can also be used to add lines to iOS plist files. See the Cordova plugin documentation link for additional details.
How can I share my Intel XDK app build?
You can send a link to your project via an email invite from your project settings page. However, a login to your account is required to access the file behind the link. Alternatively, you can download the build from the build page, onto your workstation, and push that built image to some location from which you can send a link to that image.
Why does my iOS build fail when I am able to test it successfully on a device and the emulator?
Common reasons include:
- Your App ID specified in the project settings do not match the one you specified in Apple's developer portal.
- The provisioning profile does not match the cert you uploaded. Double check with Apple's developer site that you are using the correct and current distribution cert and that the provisioning profile is still active. Download the provisioning profile again and add it to your project to confirm.
- In Project Build Settings, your App Name is invalid. It should be modified to include only alpha, space and numbers.
How do I add multiple domains in Domain Access?
Here is the primary doc source for that feature.
If you need to insert multiple domain references, then you will need to add the extra references in the intelxdk.config.additions.xml file. This StackOverflow entry provides a basic idea and you can see the intelxdk.config.*.xml files that are automatically generated with each build for the <access origin="xxx" /> line that is generated based on what you provide in the "Domain Access" field of the "Build Settings" panel on the Project Tab.
How do I build more than one app using the same Apple developer account?
On Apple developer, create a distribution certificate using the "iOS* Certificate Signing Request" key downloaded from Intel XDK Build tab only for the first app. For subsequent apps, reuse the same certificate and import this certificate into the Build tab like you usually would.
How do I include search and spotlight icons as part of my app?
Please refer to this article in the Intel XDK documentation. Create anintelxdk.config.additions.xml
file in your top level directory (same location as the otherintelxdk.*.config.xml
files) and add the following lines for supporting icons in Settings and other areas in iOS*.
<!-- Spotlight Icon --><icon platform="ios" src="res/ios/icon-40.png" width="40" height="40" /><icon platform="ios" src="res/ios/icon-40@2x.png" width="80" height="80" /><icon platform="ios" src="res/ios/icon-40@3x.png" width="120" height="120" /><!-- iPhone Spotlight and Settings Icon --><icon platform="ios" src="res/ios/icon-small.png" width="29" height="29" /><icon platform="ios" src="res/ios/icon-small@2x.png" width="58" height="58" /><icon platform="ios" src="res/ios/icon-small@3x.png" width="87" height="87" /><!-- iPad Spotlight and Settings Icon --><icon platform="ios" src="res/ios/icon-50.png" width="50" height="50" /><icon platform="ios" src="res/ios/icon-50@2x.png" width="100" height="100" />
For more information related to these configurations, visit http://cordova.apache.org/docs/en/3.5.0/config_ref_images.md.html#Icons%20and%20Splash%20Screens.
For accurate information related to iOS icon sizes, visit https://developer.apple.com/library/ios/documentation/UserExperience/Conceptual/MobileHIG/IconMatrix.html
NOTE: The iPhone 6 icons will only be available if iOS* 7 or 8 is the target.
Cordova iOS* 8 support JIRA tracker: https://issues.apache.org/jira/browse/CB-7043
Does Intel XDK support Modbus TCP communication?
No, since Modbus is a specialized protocol, you need to write either some JavaScript* or native code (in the form of a plugin) to handle the Modbus transactions and protocol.
How do I sign an Android* app using an existing keystore?
Uploading an existing keystore in Intel XDK is not currently supported but you can send an email to html5tools@intel.com with this request. We can assist you there.
How do I build separately for different Android* versions?
Under the Projects Panel, you can select the Target Android* version under the Build Settings collapsible panel. You can change this value and build your application multiple times to create numerous versions of your application that are targeted for multiple versions of Android*.
How do I display the 'Build App Now' button if my display language is not English?
If your display language is not English and the 'Build App Now' button is proving to be troublesome, you may change your display language to English which can be downloaded by a Windows* update. Once you have installed the English language, proceed to Control Panel > Clock, Language and Region > Region and Language > Change Display Language.
How do I update my Intel XDK version?
When an Intel XDK update is available, an Update Version dialog box lets you download the update. After the download completes, a similar dialog lets you install it. If you did not download or install an update when prompted (or on older versions), click the package icon next to the orange (?) icon in the upper-right to download or install the update. The installation removes the previous Intel XDK version.
How do I import my existing HTML5 app into the Intel XDK?
If your project contains an Intel XDK project file (<project-name>.xdk
) you should use the "Open an Intel XDK Project" option located at the bottom of the Projects List on the Projects tab (lower left of the screen, round green "eject" icon, on the Projects tab). This would be the case if you copied an existing Intel XDK project from another system or used a tool that exported a complete Intel XDK project.
If your project does not contain an Intel XDK project file (<project-name>.xdk
) you must "import" your code into a new Intel XDK project. To import your project, use the "Start a New Project" option located at the bottom of the Projects List on the Projects tab (lower left of the screen, round blue "plus" icon, on theProjects tab). This will open the "Samples, Demos and Templates" page, which includes an option to "Import Your HTML5 Code Base." Point to the root directory of your project. The Intel XDK will attempt to locate a file named index.html
in your project and will set the "Source Directory" on the Projects tab to point to the directory that contains this file.
If your imported project did not contain an index.html
file, your project may be unstable. In that case, it is best to delete the imported project from the Intel XDK Projects tab ("x" icon in the upper right corner of the screen), rename your "root" or "main" html file to index.html
and import the project again. Several components in the Intel XDK depend on this assumption that the main HTML file in your project is named index.hmtl
. See Introducing Intel® XDK Development Tools for more details.
It is highly recommended that your "source directory" be located as a sub-directory inside your "project directory." This insures that non-source files are not included as part of your build package when building your application. If the "source directory" and "project directory" are the same it results in longer upload times to the build server and unnecessarily large application executable files returned by the build system. See the following images for the recommended project file layout.
I am unable to login to App Preview with my Intel XDK password.
On some devices you may have trouble entering your Intel XDK login password directly on the device in the App Preview login screen. In particular, sometimes you may have trouble with the first one or two letters getting lost when entering your password.
Try the following if you are having such difficulties:
Reset your password, using the Intel XDK, to something short and simple.
Confirm that this new short and simple password works with the XDK (logout and login to the Intel XDK).
Confirm that this new password works with the Intel Developer Zone login.
Make sure you have the most recent version of Intel App Preview installed on your devices. Go to the store on each device to confirm you have the most recent copy of App Preview installed.
Try logging into Intel App Preview on each device with this short and simple password. Check the "show password" box so you can see your password as you type it.
If the above works, it confirms that you can log into your Intel XDK account from App Preview (because App Preview and the Intel XDK go to the same place to authenticate your login). When the above works, you can go back to the Intel XDK and reset your password to something else, if you do not like the short and simple password you used for the test.
How do I completely uninstall the Intel XDK from my system?
Take the following steps to completely uninstall the XDK from your Windows system:
From the Windows Control Panel, remove the Intel XDK, using the Windows uninstall tool.
Then:
> cd %LocalAppData%\Intel\XDK
> del *.* /s/q
Then:
> cd %LocalAppData%\XDK
> copy global-settings.xdk %UserProfile%
> del *.* /s/q
> copy %UserProfile%\global-settings.xdk .
- Then:
-- Goto xdk.intel.com and select the download link.
-- Download and install the new XDK.
To do the same on a Linux or Mac system:
- On a Linux machine, run the uninstall script, typically
/opt/intel/XDK/uninstall.sh
.
- Remove the directory into which the Intel XDK was installed.
-- Typically/opt/intel
or your home (~) directory on a Linux machine.
-- Typically in the/Applications/Intel XDK.app
directory on a Mac.
- Then:
$ find ~ -name global-settings.xdk
$ cd <result-from-above> (for example ~/Library/Application Support/XDK/ on a Mac)
$ cp global-settings.xdk ~
$ rm -Rf *
$ mv ~/global-settings.xdk .
- Then:
-- Goto xdk.intel.com and select the download link.
-- Download and install the new XDK.
Is there a tool that can help me highlight syntax issues in Intel XDK?
Yes, you can use the various linting tools that can be added to the Brackets editor to review any syntax issues in your HTML, CSS and JS files. Go to the "File > Extension Manager..." menu item and add the following extensions: JSHint, CSSLint, HTMLHint, XLint for Intel XDK. Then, review your source files by monitoring the small yellow triangle at the bottom of the edit window (a green check mark indicates no issues).
How do I delete built apps and test apps from the Intel XDK build servers?
You can manage them by logging into: https://appcenter.html5tools-software.intel.com/csd/controlpanel.aspx. This functionality will eventually be available within Intel XDK after which access to app center will be removed.
I need help with the App Security API plugin; where do I find it?
Visit the primary documentation book for the App Security API and see this forum post for some additional details.
When I install my app onto my test device Avast antivirus flags it as a possible virus, why?
If you are receiving a "Suspicious file detected - APK:CloudRep [Susp]" message it is likely due to the fact that you are side-loading the app onto your device (using a download link or by using adb) or you have downloaded your app from an "untrusted" store. See the following official explanation from Avast:
Your application was flagged by our cloud reputation system. "Cloud rep" is a new feature of Avast Mobile Security, which flags apks when the following conditions are met:
- The file is not prevalent enough; meaning not enough users of Avast Mobile Security have installed your APK.
- The source is not an established market (Google Play is an example of an established market).
If you distribute your app using Google Play (or any other trusted market) your users should not see any warning from Avast.
How do I add a Brackets extension to the editor that is part of the Intel XDK?
The number of Brackets extensions that are provided in the built-in edition of the Brackets editor are limited to insure stability of the Intel XDK product. Not all extensions are compatible with the edition of Brackets that is embedded within the Intel XDK. Adding incompatible extensions can cause the Intel XDK to quit working.
Despite this warning, there are useful extensions that have not been included in the editor and which can be added to the Intel XDK. Adding them is temporary, each time you update the Intel XDK (or if you reinstall the Intel XDK) you will have to "re-add" your Brackets extension. To add a Brackets extension, use the following procedure:
- exit the Intel XDK
- download a ZIP file of the extension you wish to add
- on Windows, unzip the extension here:
%LocalAppData%\Intel\XDK\xdk\brackets\b\extensions\dev
- on Mac OS X, unzip the extension here:
/Applications/Intel\ XDK.app/Contents/Resources/app.nw/brackets/b/extensions/dev
- start the Intel XDK
Note that the locations given above are subject to change with new releases of the Intel XDK.
Why does my app or game require so many permissions on Android when built with the Intel XDK?
When you build your HTML5 app using the Intel XDK for Android or Android-Crosswalk you are creating a Cordova app. It may seem like you're not building a Cordova app, but you are. In order to package your app so it can be distributed via an Android store and installed on an Android device, it needs to be built as a hybrid app. The Intel XDK uses Cordova to create that hybrid app.
A pure Cordova app requires the NETWORK permission, it's needed to "jump" between your HTML5 environment and the native Android environment. Additional permissions will be added by any Cordova plugins you include with your application; which permissions are includes are a function of what that plugin does and requires.
Crosswalk for Android builds also require the NETWORK permission, because the Crosswalk image built by the Intel XDK includes support for Cordova. In addition, current versions of Crosswalk (12 and 14 at the time this FAQ was written)also require NETWORK STATE and WIFI STATE. There is an extra permission in some versions of Crosswalk (WRITE EXTERNAL STORAGE) that is only needed by the shared model library of Crosswalk, we have asked the Crosswalk project to remove this permission in a future Crosswalk version.
If you are seeing more than the following five permissions in your XDK-built Crosswalk app:
- android.permission.INTERNET
- android.permission.ACCESS_NETWORK_STATE
- android.permission.ACCESS_WIFI_STATE
- android.permission.INTERNET
- android.permission.WRITE_EXTERNAL_STORAGE
then you are seeing permissions that have been added by some plugins. Each plugin is different, so there is no hard rule of thumb. The two "default" core Cordova plugins that are added by the Intel XDK blank templates (device and splash screen) do not require any Android permissions.
BTW: the permission list above comes from a Crosswalk 14 build. Crosswalk 12 builds do not included the last permission; it was added when the Crosswalk project introduced the shared model library option, which started with Crosswalk 13 (the Intel XDK does not support 13 builds).
How do I make a copy of an existing Intel XDK project?
If you just need to make a backup copy of an existing project, and do not plan to open that backup copy as a project in the Intel XDK, do the following:
- Exit the Intel XDK.
- Copy the entire project directory:
- on Windows, use File Explorer to "right-click" and "copy" your project directory, then "right-click" and "paste"
- on Mac use Finder to "right-click" and then "duplicate" your project directory
- on Linux, open a terminal window, "cd" to the folder that contains your project, and type "cp -a old-project/ new-project/" at the terminal prompt (where "old-project/" is the folder name of your existing project that you want to copy and "new-project/" is the name of the new folder that will contain a copy of your existing project)
If you want to use an existing project as the starting point of a new project in the Intel XDK. The process described below will insure that the build system does not confuse the ID in your old project with that stored in your new project. If you do not follow the procedure below you will have multiple projects using the same project ID (a special GUID that is stored inside the Intel XDK <project-name>.xdk
file in the root directory of your project). Each project in your account must have a unique project ID.
- Exit the Intel XDK.
- Make a copy of your existing project using the process described above.
- Inside the new project that you made (that is, your new copy of your old project), make copies of the
<project-name>.xdk
file and<project-name>.xdke
files and rename those copies to something likeproject-new.xdk
andproject-new.xdke
(anything you like, just something different than the original project name, preferably the same name as the new project folder in which you are making this new project). - Using a TEXT EDITOR (only) (such as Notepad or Sublime or Brackets or some other TEXT editor), open your new "
project-new.xdk
" file (whatever you named it) and find theprojectGuid
line, it will look something like this:"projectGuid": "a863c382-ca05-4aa4-8601-375f9f209b67",
- Change the "GUID" to all zeroes, like this:
"00000000-0000-0000-000000000000"
- Save the modified "
project-new.xdk
" file. - Open the Intel XDK.
- Goto the Projects tab.
- Select "Open an Intel XDK Project" (the green button at the bottom left of the Projects tab).
- To open this new project, locate the new "
project-new.xdk
" file inside the new project folder you copied above. - Don't forget to change the App ID in your new project. This is necessary to avoid conflicts with the project you copied from, in the store and when side-loading onto a device.
My project does not include a www folder. How do I fix it so it includes a www or source directory?
The Intel XDK HTML5 and Cordova project file structures are meant to mimic a standard Cordova project. In a Cordova (or PhoneGap) project there is a subdirectory (or folder) named www that contains all of the HTML5 source code and asset files that make up your application. For best results, it is advised that you follow this convention, of putting your source inside a "source directory" inside of your project folder.
This most commonly happens as the result of exporting a project from an external tool, such as Construct2, or as the result of importing an existing HTML5 web app that you are converting into a hybrid mobile application (eg., an Intel XDK Corodova app). If you would like to convert an existing Intel XDK project into this format, follow the steps below:
- Exit the Intel XDK.
- Copy the entire project directory:
- on Windows, use File Explorer to "right-click" and "copy" your project directory, then "right-click" and "paste"
- on Mac use Finder to "right-click" and then "duplicate" your project directory
- on Linux, open a terminal window, "cd" to the folder that contains your project, and type "cp -a old-project/ new-project/" at the terminal prompt (where "old-project/" is the folder name of your existing project that you want to copy and "new-project/" is the name of the new folder that will contain a copy of your existing project)
- Create a "www" directory inside the new duplicate project you just created above.
- Move your
index.html
and other source and asset files to the "www" directory you just created -- this is now your "source" directory, located inside your "project" directory (do not move the<project-name>.xdk
and xdke files and anyintelxdk.config.*.xml
files, those must stay in the root of the project directory) - Inside the new project that you made above (by making a copy of the old project), rename the
<project-name>.xdk
file and<project-name>.xdke
files to something likeproject-copy.xdk
andproject-copy.xdke
(anything you like, just something different than the original project, preferably the same name as the new project folder in which you are making this new project). - Using a TEXT EDITOR (only) (such as Notepad or Sublime or Brackets or some other TEXT editor), open the new "
project-copy.xdk
" file (whatever you named it) and find the line namedprojectGuid
, it will look something like this:"projectGuid": "a863c382-ca05-4aa4-8601-375f9f209b67",
- Change the "GUID" to all zeroes, like this:
"00000000-0000-0000-000000000000"
- A few lines down find:
"sourceDirectory": "",
- Change it to this:
"sourceDirectory": "www",
- Save the modified "
project-copy.xdk
" file. - Open the Intel XDK.
- Goto the Projects tab.
- Select "Open an Intel XDK Project" (the green button at the bottom left of the Projects tab).
- To open this new project, locate the new "
project-copy.xdk
" file inside the new project folder you copied above.
Can I install more than one copy of the Intel XDK onto my development system?
Yes, you can install more than one version onto your development system. However, you cannot run multiple instances of the Intel XDK at the same time. Be aware that new releases sometimes change the project file format, so it is a good idea, in these cases, to make a copy of your project if you need to experiment with a different version of the Intel XDK. See the instructions in a FAQ entry above regarding how to make a copy of your Intel XDK project.
Follow the instructions in this forum post to install more than one copy of the Intel XDK onto your development system.
On Apple OS X* and Linux* systems, does the Intel XDK need the OpenSSL* library installed?
Yes. Several features of the Intel XDK require the OpenSSL library, which typically comes pre-installed on Linux and OS X systems. If the Intel XDK reports that it could not find libssl, go to https://www.openssl.org to download and install it.
I have a web application that I would like to distribute in app stores without major modifications. Is this possible using the Intel XDK?
Yes, if you have a true web app or “client app” that only uses HTML, CSS and JavaScript, it is usually not too difficult to convert it to a Cordova hybrid application (this is what the Intel XDK builds when you create an HTML5 app). If you rely heavily on PHP or other server scripting languages embedded in your pages you will have more work to do. Because your Cordova app is not associated with a server, you cannot rely on server-based programming techniques; instead, you must rewrite any such code to user RESTful APIs that your app interacts with using, for example, AJAX calls.
What is the best training approach to using the Intel XDK for a newbie?
First, become well-versed in the art of client web apps, apps that rely only on HTML, CSS and JavaScript and utilize RESTful APIs to talk to network services. With that you will have mastered 80% of the problem. After that, it is simply a matter of understanding how Cordova plugins are able to extend the JavaScript API for access to features of the platform. For HTML5 training there are many sites providing tutorials. It may also help to read Five Useful Tips on Getting Started Building Cordova Mobile Apps with the Intel XDK, which will help you understand some of the differences between developing for a traditional server-based environment and developing for the Intel XDK hybrid Cordova app environment.
What is the best platform to start building an app with the Intel XDK? And what are the important differences between the Android, iOS and other mobile platforms?
There is no one most important difference between the Android, iOS and other platforms. It is important to understand that the HTML5 runtime engine that executes your app on each platform will vary as a function of the platform. Just as there are differences between Chrome and Firefox and Safari and Internet Explorer, there are differences between iOS 9 and iOS 8 and Android 4 and Android 5, etc. Android has the most significant differences between vendors and versions of Android. This is one of the reasons the Intel XDK offers the Crosswalk for Android build option, to normalize and update the Android issues.
In general, if you can get your app working well on Android (or Crosswalk for Android) first you will generally have fewer issues to deal with when you start to work on the iOS and Windows platforms. In addition, the Android platform has the most flexible and useful debug options available, so it is the easiest platform to use for debugging and testing your app.
Is my password encrypted and why is it limited to fifteen characters?
Yes, your password is stored encrypted and is managed by https://signin.intel.com. Your Intel XDK userid and password can also be used to log into the Intel XDK forum as well as the Intel Developer Zone. the Intel XDK does not store nor does it manage your userid and password.
The rules regarding allowed userids and passwords are answered on this Sign In FAQ page, where you can also find help on recovering and changing your password.
Why does the Intel XDK take a long time to start on Linux or Mac?
...and why am I getting this error message? "Attempt to contact authentication server is taking a long time. You can wait, or check your network connection and try again."
At startup, the Intel XDK attempts to automatically determine the proxy settings for your machine. Unfortunately, on some system configurations it is unable to reliably detect your system proxy settings. As an example, you might see something like this image when starting the Intel XDK.
On some systems you can get around this problem by setting some proxy environment variables and then starting the Intel XDK from a command-line that includes those configured environment variables. To set those environment variables, similar to the following:
$ export no_proxy="localhost,127.0.0.1/8,::1" $ export NO_PROXY="localhost,127.0.0.1/8,::1" $ export http_proxy=http://proxy.mydomain.com:123/ $ export HTTP_PROXY=http://proxy.mydomain.com:123/ $ export https_proxy=http://proxy.mydomain.com:123/ $ export HTTPS_PROXY=http://proxy.mydomain.com:123/
IMPORTANT! The name of your proxy server and the port (or ports) that your proxy server requires will be different than those shown in the example above. Please consult with your IT department to find out what values are appropriate for your site. Intel has no way of knowing what configuration is appropriate for your network.
If you use the Intel XDK in multiple locations (at work and at home), you may have to change the proxy settings before starting the Intel XDK after switching to a new network location. For example, many work networks use a proxy server, but most home networks do not require such a configuration. In that case, you need to be sure to "unset" the proxy environment variables before starting the Intel XDK on a non-proxy network.
After you have successfully configured your proxy environment variables, you can start the Intel XDK manually, from the command-line.
On a Mac, where the Intel XDK is installed in the default location, type the following (from a terminal window that has the above environment variables set):
$ open /Applications/Intel\ XDK.app/
On a Linux machine, assuming the Intel XDK has been installed in the ~/intel/XDK directory, type the following (from a terminal window that has the above environment variables set):
$ ~/intel/XDK/xdk.sh &
In the Linux case, you will need to adjust the directory name that points to the xdk.sh file in order to start. The example above assumes a local install into the ~/intel/XDK directory. Since Linux installations have more options regarding the installation directory, you will need to adjust the above to suit your particular system and install directory.
How do I generate a P12 file on a Windows machine?
See these articles: