×
Namespaces

Variants
Actions
(Difference between revisions)

Deep Linking to Store on Nokia X

From Nokia Developer Wiki
Jump to: navigation, search
Tomi_ (Talk | contribs)
m (Tomi -)
BuildNokia (Talk | contribs)
(BuildNokia - minor edits for clarity)
Line 1: Line 1:
 
[[Category:Nokia X]][[Category:Nokia X 1.0]][[Category:Code Examples]][[Category:Nokia Store]][[Category:Deep%20linking]]
 
[[Category:Nokia X]][[Category:Nokia X 1.0]][[Category:Code Examples]][[Category:Nokia Store]][[Category:Deep%20linking]]
{{Abstract|This article explains how deep linking to apps in Store works on Nokia X.}}
+
{{Abstract|This article explains how deep linking to apps in the Nokia Store works on Nokia X.}}
  
 
{{Note|This is an entry in the [[Nokia X Wiki Challenge 2014Q1]]}}
 
{{Note|This is an entry in the [[Nokia X Wiki Challenge 2014Q1]]}}
Line 36: Line 36:
 
</code>
 
</code>
  
This format is of course cross-platform: '''When your package name is the same in both Nokia Store and, e.g. Google Play Store, the same Intent implementation with the same market scheme URI will work.''' The code snippet below will launch the Nokia Store client app and show Nokia MixRadio app:
+
This format is of course cross-platform: '''When your package name is the same in both Nokia Store and, e.g. Google Play Store, the same Intent implementation with the same market scheme URI will work.''' The code snippet below will launch the Nokia Store client app and show the Nokia MixRadio app:
  
 
<code java>
 
<code java>
Line 52: Line 52:
 
</gallery>
 
</gallery>
  
If an app with the given package name is not found, Nokia Store fallbacks to search mode. However, this fallback is Nokia Store specific and you should not rely on it. Instead, always make sure that the package name you use is correct. If you want to search for apps, use the search query explained below.
+
If an app with the given package name is not found, Nokia Store falls back to search mode. However, this fallback is Nokia Store specific and you should not rely on it. Instead, always make sure that the package name you use is correct. If you want to search for apps, use the search query explained below.
  
 
The format of search query with the market scheme is the following:
 
The format of search query with the market scheme is the following:
Line 73: Line 73:
 
</code>
 
</code>
  
You can find the content ID of your app in the publishing tool (it is the number in the URL). Unfortunately, the app details are shown only when browsing with Nokia X. On other devices and desktop the user will be shown an error message saying "Nokia Store is currently not available for your device".
+
You can find the content ID of your app in the publishing tool. It is the number in the URL. Unfortunately, the app details are shown only when browsing with Nokia X. On other devices and on the desktop the user will be shown an error message saying "Nokia Store is currently not available for your device".
  
The Intent to launch the browser to show a webpage is identical to launching the store client app expect for the URI. The code snippet below will show Nokia MixRadio app page in the web browser:
+
The Intent to launch the browser to show a webpage is identical to launching the store client app except for the URI. The code snippet below will show the Nokia MixRadio app page in the web browser:
  
 
<code java>
 
<code java>

Revision as of 01:53, 17 April 2014

This article explains how deep linking to apps in the Nokia Store works on Nokia X.

Note.pngNote: This is an entry in the Nokia X Wiki Challenge 2014Q1

Article Metadata
Code Example
Installation file: DeepLinkSample.apk
Tested with
SDK: Android SDK for API level 16
Devices(s): Nokia X, Nokia X+ and Nokia XL
Article
Created: Tomi_ (12 Apr 2014)
Last edited: BuildNokia (17 Apr 2014)

Contents

Introduction

Store deep linking means guiding the user to the page of a specific application in the store. The page can be either displayed in the store client app (the most common case) or, for instance, in the store web frontend. Like in many other use cases, here the behavior of Nokia X is similar to Android phones - with or without Google services. There is no difference development-wise either when the market scheme is used. The store web frontend is naturally different since it is Nokia Store specific. Both of the aforementioned approaches are described in this short article and demonstrated by the corresponding sample app available in GitHub.

Market scheme

The market scheme format to link to the app details in the Nokia Store client is the following:

market://details?id=<package name>

This format is of course cross-platform: When your package name is the same in both Nokia Store and, e.g. Google Play Store, the same Intent implementation with the same market scheme URI will work. The code snippet below will launch the Nokia Store client app and show the Nokia MixRadio app:

Intent intent = new Intent(Intent.ACTION_VIEW);
intent.setData(Uri.parse("market://details?id=com.nokia.app.mixradio.client"));
startActivity(intent);

The user interface (UI) flow is demonstrated below:

If an app with the given package name is not found, Nokia Store falls back to search mode. However, this fallback is Nokia Store specific and you should not rely on it. Instead, always make sure that the package name you use is correct. If you want to search for apps, use the search query explained below.

The format of search query with the market scheme is the following:

market://search?q=<search term>

Store web URLs

The Nokia Store website provides app details too. The URL format is as follows:

http://store.ovi.mobi/content/<content ID>

You can find the content ID of your app in the publishing tool. It is the number in the URL. Unfortunately, the app details are shown only when browsing with Nokia X. On other devices and on the desktop the user will be shown an error message saying "Nokia Store is currently not available for your device".

The Intent to launch the browser to show a webpage is identical to launching the store client app except for the URI. The code snippet below will show the Nokia MixRadio app page in the web browser:

Intent intent = new Intent(Intent.ACTION_VIEW);
intent.setData(Uri.parse("http://store.ovi.mobi/content/488076"));
startActivity(intent);

The UI flow is demonstrated below:

Summary

The store deep linking with Nokia X works just like in any Android device, e.g. a device with Google Play Services and Google Play Store, when utilising the market scheme. The Nokia Store web interface is limited to Nokia X devices at the time of writing this article.

Version Hint

Windows Phone: [[Category:Windows Phone]]
[[Category:Windows Phone 7.5]]
[[Category:Windows Phone 8]]

Nokia Asha: [[Category:Nokia Asha]]
[[Category:Nokia Asha Platform 1.0]]

Series 40: [[Category:Series 40]]
[[Category:Series 40 1st Edition]] [[Category:Series 40 2nd Edition]]
[[Category:Series 40 3rd Edition (initial release)]] [[Category:Series 40 3rd Edition FP1]] [[Category:Series 40 3rd Edition FP2]]
[[Category:Series 40 5th Edition (initial release)]] [[Category:Series 40 5th Edition FP1]]
[[Category:Series 40 6th Edition (initial release)]] [[Category:Series 40 6th Edition FP1]] [[Category:Series 40 Developer Platform 1.0]] [[Category:Series 40 Developer Platform 1.1]] [[Category:Series 40 Developer Platform 2.0]]

Symbian: [[Category:Symbian]]
[[Category:S60 1st Edition]] [[Category:S60 2nd Edition (initial release)]] [[Category:S60 2nd Edition FP1]] [[Category:S60 2nd Edition FP2]] [[Category:S60 2nd Edition FP3]]
[[Category:S60 3rd Edition (initial release)]] [[Category:S60 3rd Edition FP1]] [[Category:S60 3rd Edition FP2]]
[[Category:S60 5th Edition]]
[[Category:Symbian^3]] [[Category:Symbian Anna]] [[Category:Nokia Belle]]

811 page views in the last 30 days.
×