Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit fff19ee8 authored by Scott Main's avatar Scott Main Committed by Android Git Automerger
Browse files

am 66895ad5: Merge "Fix badge generator URLs and images, and update script to... 

am 66895ad5: Merge "Fix badge generator URLs and images, and update script to generate different alt text for the different button styles. Also change homepage announce link for blog post." into ics-mr1

* commit '66895ad5':
  Fix badge generator URLs and images, and update script to generate different alt text for the different button styles. Also change homepage announce link for blog post.
parents 40dbc3db 66895ad5

docs/html/guide/publishing/publishing.jd

+59 −46
Original line number Original line Diff line number Diff line
@@ -320,7 +320,8 @@ URI is:</p> 
<p class="note"><strong>Note:</strong> If you create a link to open Google Play from your web

<p class="note"><strong>Note:</strong> If you create a link to open Google Play from your web

site and the user selects it from an Android-powered device, the device's Google Play application will

site and the user selects it from an Android-powered device, the device's Google Play application will

resolve the link so the user can use the Google Play application on the device instead of opening the web

resolve the link so the user can use the Google Play application on the device instead of opening the web

site. As such, you should always use {@code http://play.google.com/store/...} URIs when creating a link on

site. As such, you should always use {@code http://play.google.com/store/apps/...} URIs when

creating a link on

a web page. When pointing to your apps from within your Android app, use the

a web page. When pointing to your apps from within your Android app, use the

{@code market://} URIs in an intent, so that the Google Play application always opens.</p>

{@code market://} URIs in an intent, so that the Google Play application always opens.</p>
@@ -333,7 +334,7 @@ the application description, screenshots, reviews and more, and choose to instal 




<p>The format for the URI that opens the details page is:</p>

<p>The format for the URI that opens the details page is:</p>





<p style="margin-left:2em"><code>&lt;URI_prefix&gt;<b>details?id=</b>&lt;package_name&gt;</code></p>

<p style="margin-left:2em"><code>&lt;URI_prefix&gt;<b>apps/details?id=</b>&lt;package_name&gt;</code></p>





<p>The <code>&lt;package_name&gt;</code> is a placeholder for the target application's

<p>The <code>&lt;package_name&gt;</code> is a placeholder for the target application's

fully-qualified package name, as declared in the <a

fully-qualified package name, as declared in the <a
@@ -341,6 +342,8 @@ href="{@docRoot}guide/topics/manifest/manifest-element.html#package">{@code 
package}</a> attribute of the <a href="{@docRoot}guide/topics/manifest/manifest-element.html">{@code

package}</a> attribute of the <a href="{@docRoot}guide/topics/manifest/manifest-element.html">{@code

&lt;manifest&gt;}</a> element.</p>

&lt;manifest&gt;}</a> element.</p>





<p>For example: <code>http://play.google.com/store/apps/details?id=com.example.myapp</code></p>







<h4>Opening the app details page from your Android app</h4>

<h4>Opening the app details page from your Android app</h4>
@@ -355,12 +358,12 @@ Google Play:</p> 




<pre>

<pre>

Intent intent = new Intent(Intent.ACTION_VIEW);

Intent intent = new Intent(Intent.ACTION_VIEW);

intent.setData(Uri.parse("market://details?id=com.android.example"));

intent.setData(Uri.parse("market://details?id=com.example.android"));

startActivity(intent);

startActivity(intent);

</pre>

</pre>





<p>This will open the Google Play application on the device to view the {@code

<p>This will open the Google Play application on the device to view the {@code

com.android.example} application.</p>

com.example.android} application.</p>









<h4>Opening the app details page from a web site</h4>

<h4>Opening the app details page from a web site</h4>
@@ -369,17 +372,17 @@ com.android.example} application.</p> 
format:</p>

format:</p>





<p style="margin-left:2em">

<p style="margin-left:2em">

  <code>http://play.google.com/store/details?id=&lt;package_name&gt;</code>

  <code>http://play.google.com/store/apps/details?id=&lt;package_name&gt;</code>

</p>

</p>





<p>For example, here's a link that opens an application's details page on Google Play:</p>

<p>For example, here's a link that opens an application's details page on Google Play:</p>





<pre>

<pre>

&lt;a href="http://play.google.com/store/details?id=com.android.example">App Link&lt;/a>

&lt;a href="http://play.google.com/store/apps/details?id=com.example.android">App Link&lt;/a>

</pre>

</pre>





<p>When clicked from a desktop web browser, this opens the Google Play web site to view the

<p>When clicked from a desktop web browser, this opens the Google Play web site to view the

{@code com.android.example} application. When clicked from an Android-powered device, users are

{@code com.example.android} application. When clicked from an Android-powered device, users are

given the option to use either their web browser or the Google Play application to view the

given the option to use either their web browser or the Google Play application to view the

application.</p>

application.</p>
@@ -456,17 +459,16 @@ web browser or the Google Play application to perform the search.</p> 




<h3 id="BuildaButton">Build a Google Play button</h3>

<h3 id="BuildaButton">Build a Google Play button</h3>





<p>Use the following form to generate a "Get it on Google Play" or "Android App

<p>Use the following form to create a button for your web site that takes users to your application

on Google Play" button that you can use on your web site. Input either your

on Google Play. Input either your application's package name or your publisher name and the button

application's package name or publisher name and the button will take users to

will take users to Google Play to either view your application's information or view a list of your

Google Play to either view your application's information or view a list of your

published apps. If users click the button while on an Android-powered device, the Google Play

published apps. If users click the button while on an Android-powered device,

application will respond to show users your application(s).</p>

the Google Play application will respond to show users your application(s).</p>





<p>This form offers four versions of the official brand badges at

<p>This form offers two styles of the official brand badge each at recommended sizes. You can pick

recommended sizes. <!--If you want to create a different size, you can download an EPS file for

between either "Get it on Google Play" or "Android app on Google Play." You should not modify the

the button images from the <a href="http://www.android.com/branding.html">Android Brand

badge images in any way. For more usage guidelines,

Guidelines</a>.</p>-->

see the <a href="http://www.android.com/branding.html">Android Brand Guidelines</a>.</p>





<style type="text/css">

<style type="text/css">
@@ -510,31 +512,42 @@ div.button-row input { 
var imagePath = "http://www.android.com/images/brand/"

var imagePath = "http://www.android.com/images/brand/"

var linkStart = "<a href=\"http://play.google.com/store/";

var linkStart = "<a href=\"http://play.google.com/store/";

var imageStart = "\">\n"

var imageStart = "\">\n"

        + "  <img src=\"" + imagePath;

        + "  <img alt=\"";

var imageEnd = ".png\"\n"

  // leaves opening for the alt text value

        + "       alt=\"Available on Google Play\" />\n</a>";

var imageSrc = "\"\n       src=\"" + imagePath;

  // leaves opening for the image file name

var imageEnd = ".png\" />\n</a>";





// variables for creating code snippet

// variables for creating code snippet

var linkStartCode = "&lt;a href=\"http://play.google.com/store/";

var linkStartCode = "&lt;a href=\"http://play.google.com/store/";

var imageStartCode = "\"&gt;\n"

var imageStartCode = "\"&gt;\n"

        + "  &lt;img src=\"" + imagePath;

        + "  &lt;img alt=\"";

var imageEndCode = ".png\"\n"

  // leaves opening for the alt text value

        + "       alt=\"Available on Google Play\" />\n&lt;/a>";

var imageSrcCode = "\"\n       src=\"" + imagePath;

  // leaves opening for the image file name

var imageEndCode = ".png\" />\n&lt;/a>";





/** Generate the HTML snippet and demo based on form values */

/** Generate the HTML snippet and demo based on form values */

function buildButton(form) {

function buildButton(form) {

  if (form["package"].value != "com.android.example") {

  var selectedValue = $('form input[type=radio]:checked').val();

  var altText = selectedValue.indexOf("get_it") != -1 ? "Get it on Google Play" : "Android app on Google Play";



  if (form["package"].value != "com.example.android") {

    $("#preview").show();

    $("#preview").show();

    $("#snippet").show().html(linkStartCode + "details?id=" + form["package"].value

    $("#snippet").show().html(linkStartCode + "apps/details?id=" + form["package"].value

            + imageStartCode + $('form input[type=radio]:checked').val() + imageEndCode);

            + imageStartCode + altText + imageSrcCode

    $("#button-preview").html(linkStart + "details?id=" + form["package"].value

            + selectedValue + imageEndCode);

            + imageStart + $('form input[type=radio]:checked').val() + imageEnd);

    $("#button-preview").html(linkStart + "apps/details?id=" + form["package"].value

            + imageStart + altText + imageSrc

            + selectedValue + imageEnd);

  } else if (form["publisher"].value != "Example, Inc.") {

  } else if (form["publisher"].value != "Example, Inc.") {

    $("#preview").show();

    $("#preview").show();

    $("#snippet").show().html(linkStartCode + "search?q=pub:" + form["publisher"].value

    $("#snippet").show().html(linkStartCode + "search?q=pub:" + form["publisher"].value

            + imageStartCode + $('form input[type=radio]:checked').val() + imageEndCode);

            + imageStartCode + altText + imageSrcCode

    $("#button-preview").html(linkStart + "search?q=pub:" + form["publisher"].value + imageStart +

            + selectedValue + imageEndCode);

    $('form input[type=radio]:checked').val() + imageEnd);

    $("#button-preview").html(linkStart + "search?q=pub:" + form["publisher"].value

            + imageStart + altText + imageSrc

            + selectedValue + imageEnd);

  } else {

  } else {

    alert("Please enter your package name or publisher name");

    alert("Please enter your package name or publisher name");

  }

  }
@@ -598,13 +611,13 @@ $(document).ready(function() { 
<form class="button-form">

<form class="button-form">

  <label class="block" for="package">Package name:</label>

  <label class="block" for="package">Package name:</label>

  <input class="text" type="text" id="package" name="package"

  <input class="text" type="text" id="package" name="package"

         value="com.android.example"

         value="com.example.android"

         default="com.android.example"

         default="com.example.android"

         onfocus="onInputFocus(this, 'com.android.example')"

         onfocus="onInputFocus(this, 'com.example.android')"

         onblur="onInputBlur(this, 'com.android.example')"

         onblur="onInputBlur(this, 'com.example.android')"

         onkeyup="return onTextEntered(event, this.parentNode, this)"/>&nbsp;

         onkeyup="return onTextEntered(event, this.parentNode, this)"/>&nbsp;

         <a id="package-clear" style="display:none" href="#"

         <a id="package-clear" style="display:none" href="#"

            onclick="return clearLabel('package','com.android.example');">clear</a>

            onclick="return clearLabel('package','com.example.android');">clear</a>

  <p style="clear:both;margin:0">&nbsp;<em>or</em></p>

  <p style="clear:both;margin:0">&nbsp;<em>or</em></p>

  <label class="block" style="margin-top:5px" for="publisher">Publisher name:</label>

  <label class="block" style="margin-top:5px" for="publisher">Publisher name:</label>

  <input class="text" type="text" id="publisher" name="publisher"

  <input class="text" type="text" id="publisher" name="publisher"
@@ -619,22 +632,22 @@ $(document).ready(function() { 




<div class="button-row">

<div class="button-row">

  <input type="radio" name="buttonStyle" value="get_it_on_play_logo_small" id="ns" checked="checked" />

  <input type="radio" name="buttonStyle" value="get_it_on_play_logo_small" id="ns" checked="checked" />

    <label for="ns"><img src="http://www.android.com/images/brand/get_it_on_play_logo_small"

    <label for="ns"><img src="http://www.android.com/images/brand/get_it_on_play_logo_small.png"

alt="narrow and small logo" /></label>

alt="Get it on Google Play (small)" /></label>

    &nbsp;&nbsp;&nbsp;&nbsp;

    &nbsp;&nbsp;&nbsp;&nbsp;

  <input type="radio" name="buttonStyle" value="get_it_on_play_logo_large.png" id="nm" />

  <input type="radio" name="buttonStyle" value="get_it_on_play_logo_large" id="nm" />

    <label for="nm"><img src="http://www.android.com/images/brand/get_it_on_play_logo_large.png"

    <label for="nm"><img src="http://www.android.com/images/brand/get_it_on_play_logo_large.png"

alt="narrow and large logo" /></label>

alt="Get it on Google Play (large)" /></label>

</div>

</div>





<div class="button-row">

<div class="button-row">

  <input type="radio" name="buttonStyle" value="android_app_on_play_logo_small.png" id="ws" />

  <input type="radio" name="buttonStyle" value="android_app_on_play_logo_small" id="ws" />

    <label for="ws"><img src="http://www.android.com/images/brand/android_app_on_play_logo_small.png"

    <label for="ws"><img src="http://www.android.com/images/brand/android_app_on_play_logo_small.png"

alt="wide and small logo" /></label>

alt="Android app on Google Play (small)" /></label>

    &nbsp;&nbsp;&nbsp;&nbsp;

    &nbsp;&nbsp;&nbsp;&nbsp;

  <input type="radio" name="buttonStyle" value="android_app_on_play_logo_large.png" id="wm" />

  <input type="radio" name="buttonStyle" value="android_app_on_play_logo_large" id="wm" />

    <label for="wm"><img src="http://www.android.com/images/brand/android_app_on_play_logo_large.png"

    <label for="wm"><img src="http://www.android.com/images/brand/android_app_on_play_logo_large.png"

alt="wide and large logo" /></label>

alt="Android app on Google Play (large)" /></label>

</div>

</div>





  <input type="button" onclick="return buildButton(this.parentNode)" value="Build my button"

  <input type="button" onclick="return buildButton(this.parentNode)" value="Build my button"
@@ -644,7 +657,7 @@ style="padding:5px" /> 




<div id="preview" style="display:none">

<div id="preview" style="display:none">

  <p>Copy and paste this HTML into your web site:</p>

  <p>Copy and paste this HTML into your web site:</p>

  <textarea id="snippet" cols="80" rows="4" onclick="this.select()"

  <textarea id="snippet" cols="100" rows="5" onclick="this.select()"

style="font-family:monospace;background-color:#efefef;padding:5px;display:none;margin-bottom:1em">

style="font-family:monospace;background-color:#efefef;padding:5px;display:none;margin-bottom:1em">

  </textarea >

  </textarea >
@@ -671,7 +684,7 @@ the web and in the Android application), as discussed in the previous sections.< 




<tr>

<tr>

<td>Display the details screen for a specific application</td>

<td>Display the details screen for a specific application</td>

<td><code>http://play.google.com/store/details?id=&lt;package_name&gt;</code>

<td><code>http://play.google.com/store/apps/details?id=&lt;package_name&gt;</code>

<td><code>market://details?id=&lt;package_name&gt;</code></td>

<td><code>market://details?id=&lt;package_name&gt;</code></td>

</tr>

</tr>

docs/html/index.jd

+1 −1
Original line number Original line Diff line number Diff line
@@ -20,7 +20,7 @@ alt="Google Play" width="120px" style="padding:10px 52px"/> 
    <p>Introducing <strong>Google Play</strong>: An integrated digital content destination where

    <p>Introducing <strong>Google Play</strong>: An integrated digital content destination where

users buy and enjoy all of their favorite content in one place. It's the new destination for

users buy and enjoy all of their favorite content in one place. It's the new destination for

Android apps!</p>

Android apps!</p>

    <p><a href="http://android-developers.blogspot.com/">Read more &raquo;</a></p>

    <p><a href="http://android-developers.blogspot.com/2012/03/introducing-google-play.html">Read more &raquo;</a></p>

                                </div> <!-- end annoucement -->

                                </div> <!-- end annoucement -->

                            </div> <!-- end annoucement-block -->

                            </div> <!-- end annoucement-block -->

                        </div><!-- end topAnnouncement -->

                        </div><!-- end topAnnouncement -->