Namespaces

Variants
Actions

Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries over the next few weeks. Thanks for all your past and future contributions.

(Difference between revisions)

Deep Linking to Store on Nokia X

From Wiki
Jump to: navigation, search
Tomi_ (Talk | contribs)
m (Tomi -)
Tomi_ (Talk | contribs)
m (Tomi -)
Line 52: Line 52:
 
</gallery>
 
</gallery>
  
You can also use the market scheme to search for apps in the store:
+
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.
 +
 
 +
The format of search query with the market scheme is the following:
  
 
<code>
 
<code>
 
market://search?q=<search term>
 
market://search?q=<search term>
 
</code>
 
</code>
 
The search will also work with ''market://details?id=<search term>'', if the term does not match a specific package name of an app in the store.
 
  
 
<gallery widths="240px" heights="400px">
 
<gallery widths="240px" heights="400px">

Revision as of 07:41, 15 April 2014

This article explains how deep linking to apps in 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: Tomi_ (15 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 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 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.

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 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:

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

598 page views in the last 30 days.

Was this page helpful?

Your feedback about this content is important. Let us know what you think.

 

Thank you!

We appreciate your feedback.

×