Developers: How to include AppToDate support (basic)

Send us News! | Rules

Please Log In or Register - it's FREE!

You Are Here » MoDaCo » MoDaCo » AppToDate

Developers: How to include AppToDate support (basic)

Options

Paul (MVP)

Apr 3 2008, 17:29

Post #1

The Main Man
Group Icon

Group: Admin Team
Posts: 21,034
Joined: 6th November 2002
From: Norwich, UK
Member No.: 1

Device(s): HTC Advantage

Including AppToDate support with your application is REALLY easy!

You simply need to install an XML file (and optionally an icon) with your application, and then host the same XML file online with your CAB file.

First things first, what does the XML look like?

Here's my 'CamerAware' XML:

CODE

<application>
<name>CamerAware</name>
<version>3.08.03.29</version>
<description>CamerAware Safety Camera Alerting from MoDaCo</description>
<versionurl>http://www.cameraware.net/apptodate/cameraware.xml</versionurl>
<caburl>http://www.cameraware.net/apptodate/cameraware.cab</caburl>
</application>

Simple eh? I think it's all quite self explanatory!

You see, you install this with your app (details of location below), and then host it online. When your version changes, the online XML shows a newer version number. AppToDate compares the two, and if the online one is newer, downloads and installs the CAB linked in the 'caburl' node. Beautiful simplicity!

So where do you put the file?

You install the file (e.g. cameraware.xml) to '\Application Data\AppToDate'. Optionally, you also install an icon file containing 16x16 and 32x32 icons named the same (e.g. cameraware.ico) to the same place, as that'll be used in future apptodate versions.

What about non free upgrades or other instances where a downloadable CAB isn't appropriate?

I appreciate that sometimes major upgrades for your applications won't be free and you need to provide for that, so you have the option of a 'Notification'. This is a text message that you show instead of making a download available. For ROM developers, you would make use of apptodate this way too. To create a notification, you just omit the <caburl> element, put something really helpful to the end user in your description and AppToDate knows what to do. E.g.:

CODE

<application>
<name>My ROM</name>
<version>2.0</version>
<description>Version 2 of My ROM is now available, and has lots of new features you are gonna love! Visit http://www.me.com/myrom to download! </description>
<versionurl>http://www.me.com/myrom/myromversion1.xml</versionurl>
</application>

or, if you have a major version upgrade on your application perhaps...

CODE

<application>
<name>My Application</name>
<version>2.0</version>
<description>Version 2 of My Application is now available, however you are running version 1.0, and the upgrade isn't free! We do have special upgrade deals though, so come and check them out at http://www.me.com/myapp!</description>
<versionurl>http://www.me.com/myapp/myappversion1.xml</versionurl>
</application>

Easy! You can see what it looks like in the application in the screenshots in this post.

Feedback welcomed!

P

--------------------

Paul O'Brien - Microsoft MVP, Mobile Devices, MoDaCo.network Founder. Check out my Blog!

£10 off a £20 spend at eXpansys - click for details

tsutton

Apr 4 2008, 09:54

Post #2

|_-_-_-_-_-_-_|
Group Icon

Group: Moderator Team
Posts: 1,807
Joined: 31st December 2004
From: Near Norwich, UK
Member No.: 104,092

Device(s): T-Mobile MDA Vario III

A few of the 'freebies' software are usually hosted on a freebie website - what happens if the website has maxed out the bandwidth and doesn't serve files anymore - how will AppToDate react to it? Will it throw an error message? Will it time out? Will it blow up?

Great product by the way!

This post has been edited by tsutton: Apr 4 2008, 09:54

--------------------

- Tony Sutton
- My Ford Focus ST170 car
- Using MDA Vario III with 6GB MicroSD card
- Got Phone, GPS and WiFi together? Sign up & Make Money with Navizon!

Paul (MVP)

Apr 4 2008, 09:59

Post #3

The Main Man
Group Icon

Group: Admin Team
Posts: 21,034
Joined: 6th November 2002
From: Norwich, UK
Member No.: 1

Device(s): HTC Advantage

AppToDate will inform you that update has failed, and then download the others.

P

--------------------

Paul O'Brien - Microsoft MVP, Mobile Devices, MoDaCo.network Founder. Check out my Blog!

£10 off a £20 spend at eXpansys - click for details

Paul (MVP)

Apr 5 2008, 06:47

Post #4

The Main Man
Group Icon

Group: Admin Team
Posts: 21,034
Joined: 6th November 2002
From: Norwich, UK
Member No.: 1

Device(s): HTC Advantage

Just a reminder to developers to open your XML in a browser to check that it is correctly formed! Certain characters break the XML, and this has caught a few people out.

You can also get round this by using CDATA sections, e.g. the XML node below (that breaks due to the ampersand)...

CODE

becomes...

CODE

--------------------

Paul O'Brien - Microsoft MVP, Mobile Devices, MoDaCo.network Founder. Check out my Blog!

£10 off a £20 spend at eXpansys - click for details

johncody

Apr 5 2008, 13:35

Post #5

Regular

Group: Posters
Posts: 105
Joined: 12th May 2003
From: New York, NY USA
Member No.: 6,041

Device(s): HTC Dash

Paul,

I think something happened with the forum database - It looks like 15+ posts from yesterday seem to be missing

UPDATE: I just discovered you created a new suggestion section and there they are

This post has been edited by johncody: Apr 5 2008, 19:06

--------------------

-John Cody

Chainfire

Apr 5 2008, 17:02

Post #6

Newbie

Group: Posters
Posts: 22
Joined: 1st October 2007
Member No.: 306,145

QUOTE(Paul (MVP) @ Apr 5 2008, 08:47)

CODE

becomes...

CODE

& and such should work as well, btw (I for one always forget exactly what the CDATA syntax was, but I never forget & ;))

--------------------

Author of KaiserTweak and WMWifiRouter

Paul (MVP)

Apr 14 2008, 14:20

Post #7

The Main Man
Group Icon

Group: Admin Team
Posts: 21,034
Joined: 6th November 2002
From: Norwich, UK
Member No.: 1

Device(s): HTC Advantage

Updated first post with how to do 'notifications'!

P

--------------------

Paul O'Brien - Microsoft MVP, Mobile Devices, MoDaCo.network Founder. Check out my Blog!

£10 off a £20 spend at eXpansys - click for details

Mr_Gee

Apr 23 2008, 12:42

Post #8

Regular

Group: Posters
Posts: 59
Joined: 5th June 2006
Member No.: 193,294

Device(s): MDA Vario 3

Hi Paul,

I'm pretty new with creating cab files and I'm tying to get the cabwiz to install the xml to the "\Application Data\AppToDate" directory,
but for some reason it is not working at all...
Could you post a working inf file maybe the cameraware or apptodate.inf file so I can see how you did it?

Thanks!

-=edit=-
I've used your "advanced" ApptoDate support, adding a reg setting provided a workaround :-)
thanks anyway

This post has been edited by Mr_Gee: Apr 23 2008, 13:15

Paul (MVP)

Apr 23 2008, 13:04

Post #9

The Main Man
Group Icon

Group: Admin Team
Posts: 21,034
Joined: 6th November 2002
From: Norwich, UK
Member No.: 1

Device(s): HTC Advantage

The relevant part in my CamerAware XML is probably this:

CODE

[DestinationDirs]
Files.Common86=0,"Application Data\AppToDate"

Where Common86 is my cameraware.xml...

In the 'Advanced' guide in this forum I talk about how to actually have the XML in your own app directory and point ATD at it via a registry key, but the subtleties of install to main memory vs storage card could make that difficult.

P

--------------------

Paul O'Brien - Microsoft MVP, Mobile Devices, MoDaCo.network Founder. Check out my Blog!

£10 off a £20 spend at eXpansys - click for details

« Next Oldest · AppToDate · Next Newest »

Topic	Replies	Topic Starter	Views	Last Action
TV out cable - How to make it with or without split for car charger or wall charger	7	alinez	2,812	Today, 20:15 Last post by: warezxp
Changing from vga (640x480) to 320x240 ?	4	hotlips69	147	Today, 14:54 Last post by: Neil5459
Insufficient Permissions when trying to reinstall	1	Prof. Yaffle	87	Today, 17:37 Last post by: Paul (MVP)
How can I make my rom to accet all untrusted cabs?	2	taril	76	Today, 16:52 Last post by: ronaldb3
"Solved" How to add a city in Weather Tab	1	myerdacom	125	Today, 13:17 Last post by: athkatla
code to update camera firmware	2	minhgi	0	Today, 19:13 Last post by: minhgi