1page.title=Debugging over Bluetooth
2page.tags=wear
3helpoutsWidget=true
4
5@jd:body
6
7<div id="tb-wrapper">
8  <div id="tb">
9
10    <!-- Required platform, tools, add-ons, devices, knowledge, etc. -->
11    <h2>This lesson teaches you to</h2>
12    <ol>
13      <li><a href="#SetupDevices">Set Up Devices for Debugging</a></li>
14      <li><a href="#SetupSession">Set Up a Debugging Session</a></li>
15      <li><a href="#DebugApp">Debug Your App</a></li>
16    </ol>
17    <h2>You should also read</h2>
18    <ul>
19      <li><a href="{@docRoot}design/wear/index.html">Android Wear Design Principles</a></li>
20    </ul>
21  </div>
22</div>
23
24<p>You can debug your wearable over Bluetooth by routing its debug output to the
25handheld device that's connected to your development machine.</p>
26
27<h2 id="SetupDevices">Setup Devices for Debugging</h2>
28<ol>
29  <li>Enable USB debugging on the handheld:
30    <ul>
31      <li>Open the Settings app and scroll to the bottom.</li>
32      <li>If it doesn't have a Developer Options setting, tap <b>About Phone</b>
33      (or <b>About Tablet</b>), scroll to the bottom, and tap the build number 7 times.</li>
34      <li>Go back and tap <b>Developer Options</b>.</li>
35      <li>Enable <b>USB debugging</b>.</li>
36    </ul>
37  </li>
38  <li>Enable Bluetooth debugging on the wearable:
39    <ol>
40      <li>Tap the home screen twice to bring up the Wear menu. </li>
41      <li>Scroll to the bottom and tap <b>Settings</b>.</li>
42      <li>Scroll to the bottom. If there's no <b>Developer Options</b> item, tap <b>About</b>,
43      and then tap the build number 7 times.</li>
44      <li>Tap the <b>Developer Options</b> item.</li>
45      <li>Enable <b>Debug over Bluetooth</b>.</li>
46    </ol>
47  </li>
48</ol>
49
50<h2 id="SetupSession">Set Up a Debugging Session</h2>
51<ol>
52 <li>On the handheld, open the Android Wear companion app.</li>
53 <li>Tap the menu on the top right and select <b>Settings</b>.</li>
54 <li>Enable <b>Debugging over Bluetooth</b>. You should see a tiny status summary appear under the
55 option:
56 <pre>
57Host: disconnected
58Target: connected
59</pre>
60</li>
61<li>Connect the handheld to your machine over USB and run:
62<pre>
63adb forward tcp:4444 localabstract:/adb-hub
64adb connect localhost:4444
65</pre>
66
67<p class="note"><b>Note</b>: You can use any available port that you have access to.</p>
68</li>
69</ol>
70<p>
71In the Android Wear companion app, you should see the status change to:</p>
72<pre>
73Host: connected
74Target: connected
75</pre>
76
77<h2 id="#debug">Debug Your App</h2>
78
79Your wearable should show up as <code>localhost:4444</code> when running <code>adb devices</code>.
80
81To run any <code>adb</code> command, use this format:
82
83<pre>adb -s localhost:4444 &lt;command&gt; </pre>
84
85<p>If there are no other devices connected over TCP/IP (namely emulators),  you can shorten the command
86to:</p>
87<pre>
88adb -e &lt;command&gt;
89</pre>
90<p>For example:</p>
91<pre>
92adb -e logcat
93adb -e shell
94adb -e bugreport
95</pre>
96