Latest revision as of 07:21, 8 November 2012

With the Qt SDK 1.2 it is now easier to install and take into use the In-Application Purchase API available for the Symbian^3 and later devices. This article will illustrate the installation steps.

Introduction

Prerequisites: none. The instructions below are valid if you install a new SDK using the online installer of, if you already have an SDK installed, you can add the In-Application API using the SDK Maintenance tool. For more information about the In-Application Purchase API visit the Distribute section of the Nokia Developer web site.

Summary

The installation of the In-Application Purchase (IAP) API relies on Qt SDK's new feature called multiple repository support. While the API is not part of SDK's initial content, and is traditionally delivered as a zip file to be unpacked into the new SDK, the new solution allows its deployment using the familiar SDK install process by simply pointing the SDK to an additional repository, hosted by Nokia Developer.

The most important information is therefore obviously the URL where this repository can be found.

• The IAP repository is hosted at http://nds2.fds-forum.nokia.com/extras/inapppurchase/repository ( no trailing / ).

Tip: Do not attempt to a access the URL above via your PC's browser, it leads to a "404 Not found." page and that is intended behaviour

Note: Earlier this page contained a tinyurl.com based short version of the URL above, which is still visible in the screenshots. While the installer can handle such short URLs a recent change on how the tinyurl.com service handles the "404 Not found." errors may render the short link useless. If you are using it, please update your maintenance tool so that it uses the full URL.

That being said, here are the installation steps:

1) If you are installing a new instance of the SDK using the online installer, open installer's "Settings" which are available in the first screen of the install wizard. If you already have the SDK installed but want to add this new API, start SDK's maintenance tool and select the Package manager (you may want to apply whatever SDK updates are available first).

2) Add the new repository URL as illustrated below (note that no username and password is required).

3) Close the Settings dialog and with the "Package manager" option selected, move to the "next" step

4) In the Components listing view, you can select (or deselect if you want to unstall it) the In-Application Purchase API (beta) component.

5) Press "next" and you can now see the list of selected components, which should include also the IAP packages listed below

6) Confirm the selection by pressing next and have the content installed.

The installer will copy Examples, Documentation and API package at the correct location so that the new API is ready to use.

Note: as full support for the Symbian tool chain is only available in the Qt SDK release for Windows, the setup has not be tested on Linux and MacOS.

Support

You can report any issues regarding the In-Application Purchase API (including its installation procedures) at http://www.developer.nokia.com/Community/Discussion/forumdisplay.php?291-Monetization-APIs