×
Namespaces

Variants
Actions
(Difference between revisions)

Install the In-Application Purchase API on Qt SDK 1.2

From Nokia Developer Wiki
Jump to: navigation, search
ltomuta (Talk | contribs)
(Ltomuta -)
 
hamishwillee (Talk | contribs)
m (Hamishwillee - Fix categories)
 
(13 intermediate revisions by one user not shown)
Line 1: Line 1:
[[Category:Draft]][[Category:Qt]][[Category:Symbian]]
+
[[Category:Qt]][[Category:Symbian]][[Category:In-App Purchasing]][[Category:SDK]]
''Delete instructional text in italic''
+
{{Abstract|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. }}
  
{{Abstract|This article explains how to ... }} ''Replace the abstract text with a short paragraph (or sentence) describing what the topic covers.''
 
 
''Enter article metadata as described below. Note that this template can be placed anywhere in the article. Do not remove parameters that you do not use''
 
 
{{ArticleMetaData <!-- v1.1 -->
 
{{ArticleMetaData <!-- v1.1 -->
 
|sourcecode= <!-- Link to example source code e.g. [[Media:The Code Example ZIP.zip]] -->
 
|sourcecode= <!-- Link to example source code e.g. [[Media:The Code Example ZIP.zip]] -->
 
|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
 
|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
 
|devices= <!-- Devices tested against - e.g. ''devices=Nokia 6131 NFC, Nokia C7-00'') -->
 
|devices= <!-- Devices tested against - e.g. ''devices=Nokia 6131 NFC, Nokia C7-00'') -->
|sdk= <!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Qt SDK 1.1.4]) -->
+
|sdk= [http://developer.nokia.com/QtSDK Qt SDK 1.2]
 
|platform= <!-- Compatible platforms - e.g. Symbian^1 and later, Qt 4.6 and later -->
 
|platform= <!-- Compatible platforms - e.g. Symbian^1 and later, Qt 4.6 and later -->
 
|devicecompatability= <!-- Compatible devices e.g.: All* (must have internal GPS) -->
 
|devicecompatability= <!-- Compatible devices e.g.: All* (must have internal GPS) -->
Line 15: Line 12:
 
|signing=<!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer -->
 
|signing=<!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer -->
 
|capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. -->
 
|capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. -->
|keywords= <!-- APIs, classes and methods (e.g. QSystemScreenSaver, QList, CBase -->
+
|keywords= monetization, In-Application Purchase, In-App Purchase
 
|id= <!-- Article Id (Knowledge base articles only) -->
 
|id= <!-- Article Id (Knowledge base articles only) -->
 
|language= <!-- Language category code for non-English topics - e.g. Lang-Chinese -->
 
|language= <!-- Language category code for non-English topics - e.g. Lang-Chinese -->
Line 25: Line 22:
 
|update-by= <!-- After significant update: [[User:username]]-->
 
|update-by= <!-- After significant update: [[User:username]]-->
 
|update-timestamp= <!-- After significant update: YYYYMMDD -->
 
|update-timestamp= <!-- After significant update: YYYYMMDD -->
|creationdate= <!-- Format YYYYMMDD -->
+
|creationdate= <!-- Format 20120214 -->
|author= <!-- Display as link [[User:username]] -->
+
|author= [[User:ltomuta]]
 
}}
 
}}
  
 
== Introduction ==
 
== Introduction ==
  
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.
+
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 [http://developer.nokia.com/monetize Distribute] section of the Nokia Developer web site.
  
 
== Summary ==
 
== Summary ==
Line 37: Line 35:
 
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 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, so we're starting with providing it. The IAP repository is hosted at '''http://nds2.fds-forum.nokia.com/extras/inapppurchase/repository''' ( no trailing '''/''' ). To simplify things, and since the installer framework can handle HTTP redirects, you can also use the tiny URL '''http://tinyurl.com/repoiap''' (again, no trailing '''/''').
+
The most important information is  therefore obviously the URL where this repository can be found.
 +
* The IAP repository is hosted at '''<nowiki>http://nds2.fds-forum.nokia.com/extras/inapppurchase/repository</nowiki>''' ( no trailing '''/''' ).
  
That being said, here are the steps:
+
{{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).
 
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 are required).
+
2) Add the new repository URL as illustrated below (note that no username and password is required).
  
[[Image::]]
+
[[Image:Repo_iap_settings.png]]
  
 
3) Close the Settings dialog and with the "Package manager" option selected, move to the "next" step
 
3) Close the Settings dialog and with the "Package manager" option selected, move to the "next" step
 
[[Image::]]
 
  
 
4) In the Components listing view, you can select (or deselect if you want to unstall it) the '''In-Application Purchase API (beta)''' component.
 
4) In the Components listing view, you can select (or deselect if you want to unstall it) the '''In-Application Purchase API (beta)''' component.
  
[[Image::]]
+
[[Image:Repo_iap_components.png]]
  
 
5) Press "next" and you can now see the list of selected components, which should include also the IAP packages listed below
 
5) Press "next" and you can now see the list of selected components, which should include also the IAP packages listed below
  
[[Image::]]
+
[[Image:Repo_iap_selection.png]]
  
 
6) Confirm the selection by pressing next and have the content installed.
 
6) Confirm the selection by pressing next and have the content installed.
  
[[Image::]]
+
[[Image:Repo_iap_installing.png]]
  
 
The installer will copy Examples, Documentation and API package at the correct location so that the new API is ready to use.
 
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.
 
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

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.

Article Metadata
Tested withCompatibility
Platform(s):
Symbian
Article
Keywords: monetization, In-Application Purchase, In-App Purchase
Created: ltomuta (21 Mar 2012)
Last edited: hamishwillee (08 Nov 2012)

[edit] 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.

[edit] 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.pngTip: 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.pngNote: 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).

Repo iap settings.png

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.

Repo iap components.png

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

Repo iap selection.png

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

Repo iap installing.png

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.

[edit] 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

This page was last modified on 8 November 2012, at 07:21.
131 page views in the last 30 days.
×