Merge "docs: Add details to Packaging Wearable apps." into lmp-dev

<p>To properly package a wearable app in Android Studio:</p>

<ol>

  <li>Include all the permissions declared in the manifest file of the wearable app module

  in the manifest file of the handheld app module. For example, if you specify the {@link

  android.Manifest.permission#VIBRATE} permission for the wearable app, you must also add that

  permission to the handheld app.</li>

  <li>Ensure that both the wearable and handheld app modules have the same package name and

  version number.</li>

  <li>Declare a Gradle dependency in the handheld app's <code>build.gradle</code> file

  that points to the wearable app module:

<pre>

  to specify your release keystore and sign your app. Android Studio exports the signed

  handheld app with the wearable app embedded in it automatically into your project's root folder.

  <p>Alternatively, you can create a <code>signingConfig</code> rule in the wearable and handheld

  modules' <code>build.gradle</code> file to sign them with your release key. Both apps must be

  signed to have the automatic pushing of the wearable app work.

  <p>Alternatively, you can sign both apps from the command line using the

  <a href="{@docRoot}sdk/installing/studio-build.html#gradleWrapper">Gradle wrapper</a>. Both apps

  must be signed to have the automatic pushing of the wearable app work.</p>

<pre>

android {

  ...

  signingConfigs {

    release {

      keyAlias 'myAlias'

      keyPassword 'myPw'

      storeFile file('path/to/release.keystore')

      storePassword 'myPw'

    }

  }

  buildTypes {

    release {

      ...

      signingConfig signingConfigs.release

    }

  }

  ...

}

</pre>

  <p>Build the handheld app by clicking the Gradle button on the right vertical toolbar of

  Android Studio and running the <b>assembleRelease</b> task. The task is located under

  <b>Project name > Handheld module name > assembleRelease</b>.

  </p>

  <p>Store your key file location and credentials in environment variables and run the Gradle

  wrapper as follows:</p>

<p class="note"><b>Note:</b>This example embeds the password in your Gradle file, which might be undesirable. See

<a href="{@docRoot}sdk/installing/studio-build.html#configureSigning">Configure signing settings</a>

for information about how to create an environment variable for the passwords instead.

</p>

<pre class="no-pretty-print">

./gradlew assembleRelease \

  -Pandroid.injected.signing.store.file=$KEYFILE \

  -Pandroid.injected.signing.store.password=$STORE_PASSWORD \

  -Pandroid.injected.signing.key.alias=$KEY_ALIAS \

  -Pandroid.injected.signing.key.password=$KEY_PASSWORD

</pre>

 </li>

</ol>

<h3>Signing the wearable and handheld app separately</h3>

</p>

<ol>

  <li>Include all the permissions declared in the manifest file of the wearable app

  in the manifest file of the mobile app. For example, if you specify the {@link

  android.Manifest.permission#VIBRATE} permission for the wearable app, you must also add that

  permission to the mobile app.</li>

  <li>Ensure that both the wearable and mobile APKs have the same package name and version

  number.</li>

  <li>Copy the signed wearable app to your handheld project's <code>res/raw</code> directory. We'll

  refer to the APK as <code>wearable_app.apk</code>.</li>

  <li>Create a <code>res/xml/wearable_app_desc.xml</code> file that contains the version and