Fixed links in formatting in Android intro tutorial

This commit is contained in:
Andrey Kamaev 2012-08-08 16:27:13 +04:00
parent 5c788df83a
commit b29a639608

View File

@ -7,7 +7,7 @@ Introduction into Android Development
This guide was designed to help you in learning Android development basics and quickly seting up your working environment. This guide was designed to help you in learning Android development basics and quickly seting up your working environment.
This guide was written with Windows 7 in mind, though it should work with any other OS supported by Android SDK. This guide was written with Windows 7 in mind, though it works with Linux (Ubuntu), Mac OS X and any other OS supported by Android SDK.
If you encounter any error after thoroughly following these steps, feel free to contact us via `OpenCV4Android <https://groups.google.com/group/android-opencv/>`_ discussion group or OpenCV `Q&A forum <http://answers.opencv.org>`_ . We'll do our best to help you out. If you encounter any error after thoroughly following these steps, feel free to contact us via `OpenCV4Android <https://groups.google.com/group/android-opencv/>`_ discussion group or OpenCV `Q&A forum <http://answers.opencv.org>`_ . We'll do our best to help you out.
@ -34,14 +34,14 @@ Usually source code of an Android application has the following structure:
where: where:
* the :file:`src` folder contains Java code of the application * the :file:`src` folder contains Java code of the application,
* the :file:`res` folder contains resources of the application (images, xml files describing UI layout , etc), * the :file:`res` folder contains resources of the application (images, xml files describing UI layout , etc),
* the :file:`libs` folder will contain native libraries after a successful build, * the :file:`libs` folder will contain native libraries after a successful build,
* and the :file:`jni` folder contains C/C++ application source code and NDK's build scripts :file:`Android.mk` and :file:`Application.mk` * and the :file:`jni` folder contains C/C++ application source code and NDK's build scripts :file:`Android.mk` and :file:`Application.mk`
producing the native libraries. producing the native libraries,
* :file:`AndroidManifest.xml` file presents essential information about application to the Android system * :file:`AndroidManifest.xml` file presents essential information about application to the Android system
(name of the Application, name of main application's package, components of the application, required permissions, etc). (name of the Application, name of main application's package, components of the application, required permissions, etc).
@ -52,7 +52,7 @@ where:
This file is generated by Eclipse or can be created with :command:`android` tool included in Android SDK. This file is generated by Eclipse or can be created with :command:`android` tool included in Android SDK.
.. note:: Both files (:file:`AndroidManifest.xml` and :file:`project.properties`) are required to compile the C++ part of the application, .. note:: Both files (:file:`AndroidManifest.xml` and :file:`project.properties`) are required to compile the C++ part of the application,
since NDK build system relies on them. If any of these files does not exist, compile the Java part of the project before the C++ part. since Android NDK build system relies on them. If any of these files does not exist, compile the Java part of the project before the C++ part.
:file:`Android.mk` and :file:`Application.mk` scripts :file:`Android.mk` and :file:`Application.mk` scripts
================================================================== ==================================================================
@ -85,7 +85,7 @@ Usually the file :file:`Application.mk` is optional, but in case of project usin
Quick environment setup for Android development Quick environment setup for Android development
=============================================== ===============================================
If you are making a clean environment install, then you can try `Tegra Android Development Pack <http://developer.nvidia.com/tegra-android-development-pack>`_ If you are making a clean environment install, then you can try `Tegra Android Development Pack <http://developer.nvidia.com/mobile/tegra-android-development-pack>`_
(**TADP**) released by **NVIDIA**. (**TADP**) released by **NVIDIA**.
When unpacked, TADP will cover all of the environment setup automatically and you can skip the rest of the guide. When unpacked, TADP will cover all of the environment setup automatically and you can skip the rest of the guide.
@ -108,7 +108,7 @@ If you are a beginner in Android development then we also recommend you to start
.. |Nvidia_Tegra_Platform| replace:: *NVIDIA*\ s Tegra platform .. |Nvidia_Tegra_Platform| replace:: *NVIDIA*\ s Tegra platform
.. _Nvidia_Tegra_Platform: http://developer.nvidia.com/node/19071 .. _Nvidia_Tegra_Platform: http://developer.nvidia.com/node/19071
.. |Tegra_Development_Kit| replace:: Tegra Development Kit .. |Tegra_Development_Kit| replace:: Tegra Development Kit
.. _Tegra_Development_Kit: http://developer.nvidia.com/tegra-ventana-development-kit .. _Tegra_Development_Kit: http://developer.nvidia.com/mobile/tegra-hardware-sales-inquiries
.. _Android_Environment_Setup_Lite: .. _Android_Environment_Setup_Lite:
@ -175,7 +175,7 @@ You need the following software to be installed in order to develop for Android
:alt: Android SDK Manager :alt: Android SDK Manager
:align: center :align: center
See `Adding SDK Components <http://developer.android.com/sdk/adding-components.html>`_ for help with installing/updating SDK components. See `Adding Platforms and Packages <http://developer.android.com/sdk/installing/adding-packages.html>`_ for help with installing/updating SDK components.
#. **Eclipse IDE** #. **Eclipse IDE**
@ -186,7 +186,7 @@ You need the following software to be installed in order to develop for Android
#. **ADT plugin for Eclipse** #. **ADT plugin for Eclipse**
These instructions are copied from `Android Developers site <http://developer.android.com/sdk/eclipse-adt.html#downloading>`_, check it out in case of any ADT-related problem. These instructions are copied from `Android Developers site <http://developer.android.com/sdk/installing/installing-adt.html>`_, check it out in case of any ADT-related problem.
Assuming that you have Eclipse IDE installed, as described above, follow these steps to download and install the ADT plugin: Assuming that you have Eclipse IDE installed, as described above, follow these steps to download and install the ADT plugin:
@ -215,11 +215,11 @@ You need the following software to be installed in order to develop for Android
#. **Android NDK** #. **Android NDK**
To compile C++ code for Android platform you need ``Android Native Development Kit`` (*NDK*). To compile C++ code for Android platform you need ``Android Native Development Kit`` (*NDK*).
You can get the latest version of NDK from the `download page <http://developer.android.com/sdk/ndk/index.html>`_. To install Android NDK just extract the archive to some folder on your computer. Here are `installation instructions <http://developer.android.com/sdk/ndk/index.html#installing>`_. You can get the latest version of NDK from the `download page <http://developer.android.com/tools/sdk/ndk/index.html>`_. To install Android NDK just extract the archive to some folder on your computer. Here are `installation instructions <http://developer.android.com/tools/sdk/ndk/index.html#Installing>`_.
.. note:: Before start you can read official Android NDK documentation which is in the Android NDK archive, in the folder :file:`docs/`. .. note:: Before start you can read official Android NDK documentation which is in the Android NDK archive, in the folder :file:`docs/`.
The main article about using Android NDK build system is in the :file:`ANDROID-MK.html` file. The main article about using Android NDK build system is in the :file:`ANDROID-MK.html` file.
@ -227,29 +227,29 @@ You can get the latest version of NDK from the `download page <http://developer.
#. **CDT plugin for Eclipse** #. **CDT plugin for Eclipse**
There are several possible ways to integrate compilation of C++ code by Android NDK into Eclipse compilation process. There are several possible ways to integrate compilation of C++ code by Android NDK into Eclipse compilation process.
We recommend the approach based on Eclipse :abbr:`CDT(C/C++ Development Tooling)` Builder. We recommend the approach based on Eclipse :abbr:`CDT(C/C++ Development Tooling)` Builder.
.. important:: Make sure your Eclipse IDE has the :abbr:`CDT(C/C++ Development Tooling)` plugin installed. Menu :guilabel:`Help -> About Eclipse SDK` and push :guilabel:`Installation Details` button. .. important:: Make sure your Eclipse IDE has the :abbr:`CDT(C/C++ Development Tooling)` plugin installed. Menu :guilabel:`Help -> About Eclipse SDK` and push :guilabel:`Installation Details` button.
.. image:: images/eclipse_inst_details.png .. image:: images/eclipse_inst_details.png
:alt: Configure builders :alt: Configure builders
:align: center :align: center
To install the `CDT plugin <http://eclipse.org/cdt/>`_ use menu :guilabel:`Help -> Install New Software...`, To install the `CDT plugin <http://eclipse.org/cdt/>`_ use menu :guilabel:`Help -> Install New Software...`,
then paste the CDT 8.0 repository URL http://download.eclipse.org/tools/cdt/releases/indigo as shown in the picture below and click :guilabel:`Add...`, name it *CDT* and click :guilabel:`OK`. then paste the CDT 8.0 repository URL http://download.eclipse.org/tools/cdt/releases/indigo as shown in the picture below and click :guilabel:`Add...`, name it *CDT* and click :guilabel:`OK`.
.. image:: images/eclipse_inst_cdt.png .. image:: images/eclipse_inst_cdt.png
:alt: Configure builders :alt: Configure builders
:align: center :align: center
``CDT Main Features`` should be enough: ``CDT Main Features`` should be enough:
.. image:: images/eclipse_inst_cdt_2.png .. image:: images/eclipse_inst_cdt_2.png
:alt: Configure builders :alt: Configure builders
:align: center :align: center
That's it. Compilation of C++ code is fully integrated into Eclipse building process now. That's it. Compilation of C++ code is fully integrated into Eclipse building process now.
Debugging and Testing Debugging and Testing
===================== =====================
@ -308,6 +308,8 @@ If you have an Android device, you can use it to test and debug your application
Consult the official `Android Developers site <http://developer.android.com/tools/device.html>`_ for more information on configuring hardware devices to work with other operating systems. Consult the official `Android Developers site <http://developer.android.com/tools/device.html>`_ for more information on configuring hardware devices to work with other operating systems.
**TODO:** Describe device setup on Linux & OSX.
What's next What's next
=========== ===========