HyperActive Software

Home What's New Who We Are What We Do Solutions Resources

We make software for humans. Custom Mac, Windows, iOS and Android solutions in HyperCard, MetaCard, and RunRev LiveCode

Troubleshooting...

AirLaunch

AirLaunch used to work fine but now it fails to install my app.

Starting with iOS 7, Apple began requiring a secure (SSL) server for over-the-air distributions. Installation will fail if the folder path to the download folder does not begin with "https". If you are uploading files to your own server, it must have a valid security certificate installed, and the path to your download folder must begin with "https". If you donĀ“t have an https server with a valid certificate, use the Dropbox method instead. All Dropbox URLs are secure and use https links.

How do I name the folder that AirLaunch creates for my files?

As of version 1.03, AirLaunch names its app folder based on the path you enter in the "App Download Folder" field. The folder name will be the last item in that path.

Note: Installations may fail to download if the folder name contains spaces or special characters like accents or other diacriticals, even if they are url-encoded. It's a good idea to always give the folder a one-word name with no special characters.

Early versions of AirLaunch accepted multiple-word folder names if they were url-encoded. This caused some problems, so AirLaunch now replaces spaces with underscores in folder names.

AirLaunch requires a Public folder, but I don't have one!

For security reasons, Dropbox accounts created after October 4, 2012 no longer have a Public folder. However, they do allow you to create one, and you'll need to do that to use AirLaunch. Log into your Dropbox account in a web browser and go to https://www.dropbox.com/enable_public_folder to create a new Public folder.

Due to new Dropbox permission changes, you can't put the AirLaunch files into a subfolder. The three files that AirLaunch creates must be placed loose inside Dropbox/Public/. For this reason, it's easiest to set the "Save folder in" path to the Desktop and then manually move the three files that AirLaunch creates into Dropbox's Public folder.

To get the base URL for the Public folder, as described in the next question "How do I get a valid download path to files in my Dropbox folder?" you can right-click on the default text file that Dropbox created in Public and choose "Copy public link" from the contextual menu. Then paste that link into the "App download folder" field and remove the trailing file name as described below.

How do I get a valid download path to files in my Dropbox folder?

Use Finder to open the Dropbox/Public folder on your hard drive. Right-click on any random file in the Public folder and choose "Copy public link" from the Dropbox menu. You won't be using the file name in AirLaunch, but this gives you the path to the base URL.

In AirLaunch, paste the link into the "App download folder" field, and delete the trailing file name. If you plan to use a subfolder for your app, add the subfolder name after the last slash. If you will be saving the files directly to DropBox, AirLaunch will always create a subfolder, so be sure to add it here. Note: if you have created a Public folder after October, 2012, you cannot use a subfolder. See the previous question for more info.

For example, this is a download folder for AirLaunch files that will be stored loose in the Dropbox public folder:

https://dl.dropbox.com/u/1234567890/
Here is a download folder for files stored in a subfolder of Dropbox/Public :
https://dl.dropbox.com/u/1234567890/My_App/

I am saving the AirLaunch files directly to my Dropbox Public folder, but the HTML link doesn't work.

The paths may be wrong. AirLaunch creates an enclosing folder around its files. When you save directly to Dropbox, there will be a difference between the "Save files in" path and the "App download folder" path.

The "Save files in" path is the place where the new folder will be created:

https://dl.dropbox.com/u/1234567890/
After the folder and files are created, the "App download folder" path will include the new folder:
https://dl.dropbox.com/u/1234567890/My_App/
Be sure the "App download folder" field includes the new folder before you create the files.

When installing an app on my device, the progress bar gets close to the end and then stalls or gives a message that the app can't be downloaded.

When iOS installs an app, it first downloads the file and then checks it for validity. If you see a progress bar when installing, it means AirLaunch worked but the validity check failed.

Some common reasons are:

  • The app was compiled with an invalid or expired provisioning certificate
  • The device ID was not entered in the developer portal on Apple's web site
  • New devices were added in the developer portal but the profile was not refreshed in XCode
  • The provisioning profile changed but the app was not recompiled with the new profile

The download link in the manifest has a nonstandard URL beginning with "itms- services://?action=download-manifest" and nothing happens when I enter the link in a browser.

The URL is a proprietary Apple scheme that only works to install apps on an iOS device. If you click the URL in a browser, nothing will happen or you will get an error.

I created a Dropbox link but it takes me to a web page and the link displays as a text file.

This can happen if you copy a link from the Dropbox web site instead of from the Finder. To get a valid Dropbox URL, follow the instructions above to get a valid path to the Dropbox folder.

My folder name is only one word but it still doesn't work.

Make sure the folder name does not contain any high-ASCII characters like accents, umlauts, or other special characters. Those can fail even though AirLaunch url-encodes the URL, especially in iOS 5.1.

My server does nothing or gives a 404 "File not found" error when I tap on the HTML link.

The server probably doesn't recognize Apple's proprietary URL, so it doesn't know what to do with the link. You'll need to add these extensions and mime types to the server list:
  • .plist - text/xml
  • .ipa - application/octet-stream

Can I use AirLaunch without an Apple developer account?

No. An iOS app requires a valid developer provisioning certificate to run on your device. Apple won't allow a non-provisioned app to install and AirLaunch can't overcome that restriction.

Can I use AirLaunch to update my app in the App Store?

No. Only Apple can release products to the App Store, and all submissions must go through their approval process. No third-party product can bypass that.

Can I use AirLaunch with applications built with other tools?

AirLaunch 1.03 has been updated to work with any iOS app built with any development tool (XCode, Flash, etc.) This is experimental right now, so if you try it, please let us know how it goes.

The exported custom HTML file includes two wildcard entries. Are there any other wildcard options available?

Yes. AirLaunch 1.032 added two new wildcard entries you can use. These will insert the current app bundle ID and version number when the HTML file is built. You will need to add them manually to your custom template if you want to use them:
  • ****bundleID****
  • ****bundleVers***