diff --git a/docs/html/sdk/ndk/1.5-r1/index.jd b/docs/html/sdk/ndk/1.5_r1/index.jd similarity index 82% rename from docs/html/sdk/ndk/1.5-r1/index.jd rename to docs/html/sdk/ndk/1.5_r1/index.jd index 3d3137c51dfdc..48794c06e3732 100644 --- a/docs/html/sdk/ndk/1.5-r1/index.jd +++ b/docs/html/sdk/ndk/1.5_r1/index.jd @@ -1,32 +1,35 @@ ndk=true ndk.version=1.5 ndk.rel.id=1 -ndk.date=May 2009 +ndk.date=June 2009 ndk.win_download=android-ndk-1.5_r1-windows.zip -ndk.win_bytes=22450814 -ndk.win_checksum=7b7836f705ec7e66225794edda34000f +ndk.win_bytes=22500667 +ndk.win_checksum=e5c53915903d8b81f3e2ea422e2e2717 ndk.mac_download=android-ndk-1.5_r1-darwin-x86.zip -ndk.mac_bytes=17165450 -ndk.mac_checksum=214ccfd704c0307609fbabeb7bf86acc +ndk.mac_bytes=17215303 +ndk.mac_checksum=1931f0e182798a4c98924fd87380b5b8 ndk.linux_download=android-ndk-1.5_r1-linux-x86.zip -ndk.linux_bytes=15976032 -ndk.linux_checksum=808fd4d6a7e45f76d546ba04ab9ef060 - -ndk.linux_64_download=android-ndk-1.5_r1-linux-x86_64.zip -ndk.linux_64_bytes=18112300 -ndk.linux_64_checksum=f8664c187b3ae077bcfe2b44294d0758 +ndk.linux_bytes=16025885 +ndk.linux_checksum=80a4e14704ca84c21bf1824cb25fbd8b page.title=Android 1.5 NDK, Release 1 @jd:body -

What is the NDK?

+

What is the Android NDK?

-

The Android 1.5 NDK provides tools that allow Android application developers -to embed and deploy native code within their Android applications. It -provides:

+

The Android NDK provides tools that allow Android application developers +to embed components that make use of native code in their Android applications. +

+ +

Android applications run in the Dalvik virtual machine. The NDK allows +developers to implement parts of their applications using native-code languages +such as C and C++. This can provide benefits to certain classes of applications, +in the form of reuse of existing code and in some cases increased speed.

+ +

The NDK provides:

-

This release of the NDK release supports the ARMv5TE machine instruction set -and provides stable headers for libc (the C library), libm (the Math library) -and the JNI interface.

+

This release of the NDK supports the ARMv5TE machine instruction set +and provides stable headers for libc (the C library), libm (the Math library), +the JNI interface, and other libraries.

-

Using the NDK may not be relevant for all Android applications. As a -developer, you will need to balance its benefits (faster execution) and its -drawbacks (no portability, JNI overhead, no access to system libraries, and -difficult debugging). Typical good candidates for the NDK are CPU-intensive -operations that don't allocate too much memory, such as signal processing, -physics simulation, custom bytecode/instruction interpreters, and so on.

+

The NDK will not benefit most applications. As a developer, you will need +to balance its benefits against its drawbacks; notably, using native code does +not result in an automatic performance increase, but does always increase +application complexity. Typical good candidates for the NDK are self-contained, +CPU-intensive operations that don't allocate much memory, such as signal processing, +physics simulation, and so on. Simply re-coding a method to run in C usually does +not result in a large performance increase. The NDK can, however, can be +an effective way to reuse a large corpus of existing C/C++ code.

Please note that the NDK does not enable you to develop native-only applications. Android's primary runtime remains the Dalvik virtual machine.

@@ -64,8 +70,11 @@ guaranteed to be supported in all later releases of the platform:

The NDK also provides a build system that lets you work efficiently with your @@ -97,6 +106,22 @@ usage defines the native sources you want to compile

  • APPLICATION-MK.TXT — describes the use of the Application.mk file, which describes the native sources required by your Android application
    • +
  • HOWTO.TXT — information about common tasks associated with NDK +development.
    • +
  • SYSTEM-ISSUES.TXT — known issues in the Android system images +that you should be aware of, if you are developing using the NDK.
    • +
  • STABLE-APIS.TXT — a complete list of the stable APIs exposed +by headers in the NDK.
    • + + +

    Additionally, the package includes detailed information about the "bionic" +C library provided with the Android platform that you should be aware of, if you +are developing using the NDK. You can find the documentation in the +<ndk>/docs/system/libc/ directory:

    + +

    Sample applications

    @@ -148,7 +173,7 @@ href="http://www.cygwin.com">Cygwin is required.

    Android platform compatibility

    +
  • +

    Native Development Tools

    + +

  • Previous SDK Releases