Merge "Docs: Removing "TODO"s, and adding a couple of links to reference...

{@link android.app.NativeActivity} class in the

{@link android.app.NativeActivity} class in the

<a href="{@docRoot}guide/topics/manifest/manifest-intro.html">manifest</a>.

<a href="{@docRoot}guide/topics/manifest/manifest-intro.html">manifest</a>.

<a href="#naa">Native Activities and Applications</a> provides more detail on how to do this, under

<a href="#naa">Native Activities and Applications</a> provides more detail on how to do this, under

“Using the {@code native-activity.h} interface.”

“Using the {@code native_activity.h} interface.”

</li>

</li>

</ul>

</ul>

<p>The Android NDK provides you with two choices to implement your native activity:</p>

<p>The Android NDK provides you with two choices to implement your native activity:</p>

<ul>

<ul>

<li>The {@code native_activity.h} header defines the native version of the

<li>The <a href="{@docRoot}ndk/reference/native__activity_8h.html">{@code native_activity.h}</a>

header defines the native version of the

{@link android.app.NativeActivity} class. It contains the callback interface and data structures

{@link android.app.NativeActivity} class. It contains the callback interface and data structures

that you need to create your native activity. Because the main thread of your application handles

that you need to create your native activity. Because the main thread of your application handles

the callbacks, your callback implementations must not be blocking. If they block, you might receive

the callbacks, your callback implementations must not be blocking. If they block, you might receive

ANR (Application Not Responding) errors because your main thread is unresponsive until the callback

ANR (Application Not Responding) errors because your main thread is unresponsive until the callback

returns.</li>

returns.</li>

<li>The android_native_app_glue.h file defines a static helper library built on top of the

<li>The {@code android_native_app_glue.h} file defines a static helper library built on top of the

{@code native_activity.h} interface. It spawns another thread, which handles things such as

<a href="{@docRoot}ndk/reference/native__activity_8h.html">{@code native_activity.h}</a> interface.

It spawns another thread, which handles things such as

callbacks or input events in an event loop. Moving these events to a separate thread prevents any

callbacks or input events in an event loop. Moving these events to a separate thread prevents any

callbacks from blocking your main thread.</li>

callbacks from blocking your main thread.</li>

</ul>

</ul>

<p>For more information on how to use this static library, examine the native-activity sample

<p>For more information on how to use this static library, examine the native-activity sample

application and its documentation. Further reading is also available in the comments in the {@code &lt;ndk_root&gt;/sources/android/native_app_glue/android_native_app_glue.h} file.</p>

application and its documentation. Further reading is also available in the comments in the {@code &lt;ndk_root&gt;/sources/android/native_app_glue/android_native_app_glue.h} file.</p>

<h3 id="na">Using the native-activity.h interface</h3>

<h3 id="na">Using the native_activity.h interface</h3>

<p>To implement a native activity with the {@code native-activity.h} interface:</p>

<p>To implement a native activity with the

<a href="{@docRoot}ndk/reference/native__activity_8h.html">{@code native_activity.h}</a>

interface:</p>

<ol type="1">

<ol type="1">

<li>Create a {@code jni/} directory in your project's root directory. This directory stores all of

<li>Create a {@code jni/} directory in your project's root directory. This directory stores all of

      </manifest>

      </manifest>

</pre>

</pre>

<li>Create a file for your native activity, and implement the {@code ANativeActivity_onCreate()}

<li>Create a file for your native activity, and implement the function named in the

function, which the app calls when the native activity starts. This function, analogous

<a href="{@docRoot}ndk/reference/group___native_activity.html#ga02791d0d490839055169f39fdc905c5e">

to {@code main} in C/C++, receives a pointer to an {@code ANativeActivity} structure,

{@code ANativeActivity_onCreate}</a> variable.

which contains function pointers to the various callback implementations that you need to write.

The app calls this function when the native activity starts. This function, analogous

to {@code main} in C/C++, receives a pointer to an

<a href="{@docRoot}ndk/reference/struct_a_native_activity.html">{@code ANativeActivity}</a>

structure, which contains function pointers to the various callback implementations that you need

to write.

Set the applicable callback function pointers in {@code ANativeActivity->callbacks} to the

Set the applicable callback function pointers in {@code ANativeActivity->callbacks} to the

implementations of your callbacks.</li>

implementations of your callbacks.</li>

<!--TODO: API Ref links in the above para.-->

<li>Set the {@code ANativeActivity-&gt;instance} field to the address of any instance of specific

<li>Set the {@code ANativeActivity-&gt;instance} field to the address of any instance of specific

data that you want to use.</li>

data that you want to use.</li>

<li>Implement anything else that you want your activity to do upon starting.</li>

<li>Implement anything else that you want your activity to do upon starting.</li>

from it into the APK.</li>

from it into the APK.</li>

</ol>

</ol>

<p>You can find further information on using {@code native-activity.h} here.</p>

<!-- (TODO: Link to API ref guide in the above para)-->

</li>

</li>

</ul>

</ul>