把ndk作为独立编译器

USING THE ANDROID TOOLCHAIN AS A STANDALONE COMPILER

使用 Android 工具链作为一个独立编译器

======================================================

WARNING WARNING WARNING WARNING WARNING WARNING WARNINGWARNING

WARNING WARNING WARNING WARNING WARNING WARNING WARNINGWARNING

SUPPORT FOR THIS FEATURE IS STILL IN BETA

AND ONLY APPLIES TO arm-linux-androideabi-4.4.3

支持这个功能仍旧在 beta 版且仅适用于 arm-linux-androideabi-4.4.3

IF YOU ENCOUNTER A PROBLEM WITH THE METHODS DESCRIBEDHERE, 

PLEASE CONTACT THE SUPPORT FORUM [email protected]

如果你在这里遇到一个用此方法描述的问题，请在支持论坛联系

WARNING WARNING WARNING WARNING WARNING WARNING WARNINGWARNING

WARNING WARNING WARNING WARNING WARNING WARNING WARNINGWARNING

It is now possible to use thetoolchain 

provided with the Android NDK as a standalonecompiler. 

使用 Android NDK 提供的工具链作为一个独立编译器现在是可能的。

This can be useful if you already have your own buildsystem, 

and only need to ability to invoke the cross-compiler to addsupport to Android for it.

如果你早已有你自己的生成系统的话，这可是有用的，

并且仅需要调用交叉编译器的能力来为它添加对 Android 的支持。

注：比如你有自己搭建的其它平台系统交叉编译环境的话。

A typical use case if invoking the 'configure' script of anopen-source library 

that expects a cross-compiler in the CC environmentvariable.

一个典型用例，假如调用一个开源库的 configure 脚本，要求一个交叉编译器在 CC 环境变量里。

This document explains how to do that:

本文档说明如何去做：

1/ Selecting your sysroot:

    选择你的 sysroot ：

--------------------------

注：我们可以在调用 gcc 时，给予 --sysroot=新路径，

　　如此 gcc 就会改以 新路径 为参考目录，去搜寻所需的子例程和库等。

　　ld 必需要在 configure 时，给予 --sysroot=新目录，

　　新目录可以是任意目录，可以不是实际安装位置，主要目的是让 ld 启用 --sysroot 功能。

The first thing you need to know is which Android native APIlevel you want to target.

首先你需要知道你想要挑出哪个 Android 本地 API 级别 。

Each one of them provides a different variousAPIs, 

which are documented underdoc/STABLE-APIS.html, 

and correspond to the sub-directories of $NDK/platforms.

它们的每一个提供一个不同的多方面的 API ，是记录于 doc/STABLE-APIS.html 中，

并且对应于 $NDK/platforms 的子目录。

This allows you to define the path to your'sysroot', 

a GCC term for a directory containing the system headers andlibraries of your target.

这允许你来定义你的 sysroot 目录，一个 GCC 项包含你目标系统头文件和库的一个目录。

Usually, this will be something like:

通常，这将是有点像：

    SYSROOT=$NDK/platforms/android-<level>/arch-<arch>/

Where <level> is the API levelnumber, 

and <arch> is the architecture("arm" being currently supported). 

<level> 是 API级别号，<arch> 是体系结构 (arm 是当前支持的)。

For example, if you're targetting Android 2.1 (a.k.a. Froyo),you would use:

例如，如果你是把 Android 2.1 作为目标(又叫做：Froyo)，你将使用：

    SYSROOT=$NDK/platforms/android-8/arch-arm

2/ Invoking the compiler (the hard way):

    调用编译器(难做的方式)：

----------------------------------------

Invoke the compiler using the --sysroot option to indicatewhere the system

files for the platform you're targetting are located. Forexample, do:

调用编译器使用 --sysroot 选项来指出你作为目标平台的系统文件位置。例如，给予：

    exportCC="$NDK/toolchains/<name>/prebuilt/<system>/bin/<prefix>gcc--sysroot=$SYSROOT"

    $CC -o foo.o -cfoo.c

Where <name> is the toolchain'sname, <system> is the host tag foryour system,

and <prefix> is atoolchain-specific prefix. 

<name>   工具链的名字 

<system> 你系统的主机标签

<prefix> 工具链特定的前缀

For example, if you are on Linux using the NDK r5 toolchain,you would use:

例如，假设你是在 Linux 上使用 NDK r5 工具链，你将使用：

    exportCC="$NDK/toolchains/arm-linux-androideabi-4.4.3/prebuilt/linux-x86/bin/arm-linux-androideabi-gcc--sysroot=$SYSROOT"

As you can see, this is rather verbose, but it works!

正如你所见，这是相当冗长，但它工作！

3/ Invoking the compiler (the easy way):

    调用编译器(容易的方式)

----------------------------------------

The NDK allows you to create a "customized" toolchaininstallation to make life easier. 

NDK 允许你创建一个 定制的 工具链设置使生活更轻松。

For example, consider the following command:

例如，考虑如下命令：

  $NDK/build/tools/make-standalone-toolchain.sh --platform=android-5--install-dir=/tmp/my-android-toolchain

This will create a directory named /tmp/my-android-toolchaincontaining a

copy of the android-5/arch-arm sysroot, and of the toolchainbinaries.

这将创建一个名为 /tmp/my-android-toolchain 的目录，

包含一个 android-5/arch-arm sysroot 和工具链二进制文件的拷贝。

You can later use it directly with something like:

你可以之后直接使用它，有点像这样：

    exportPATH=/tmp/my-android-toolchain/bin:$PATH

    exportCC=arm-linux-androideabi-gcc

Note that without the --install-diroption, 

make-standalone-toolchain.sh will create a/tmp/ndk/<toolchain-name>.tar.bz2 intarball. 

注意不用 --install-dir 选项，make-standalone-toolchain.sh 将用 tarball创建一个/tmp/ndk/<toolchain-name>.tar.bz2。

This allows you to archive and redistribute the binarieseasily.

这允许你容易地压缩和重新发行二进制文件。

Use --help for more options and details.

使用 --help 得到更多选项和细节。

IMPORTANT: 

重点：

The toolchain binaries do not depend or contain host-specificpaths,

in other words, they can be installed in anylocation, 

or even moved if you need to.

工具链二进制文件不依赖或包含宿主专一性的路径，

换句话说，它们可以安装在任意位置，或甚至移到你需要的地方。

NOTE: 

提示：

You can still use the --sysroot option with the newtoolchain, 

but it is now simply optional!

你可以依旧使用 --sysroot 选项用以新工具链，但是它现在只不过可选了！

4/ ABI Compatibility:

    ABI 兼容性：

---------------------

The machine code generated by the toolchain should becompatible with

the official Android 'armeabi' ABI (seedocs/CPU-ARCH-ABIS.html) by default.

默认情况下，通过工具链产生的机器代码将兼容官方的 Android armeabiABI 

(参见 docs/CPU-ARCH-ABIS.html)。

It is recommended to use the -mthumb compiler flag to forcethe generation

of 16-bit Thumb-1 instructions (the default being 32-bit ARMones).

推荐使用 -mthumb 编译标志来强制 16位 Thumb-1 指令的产生 (默认是 32位 ARM)。

If you want to target the 'armeabi-v7a'ABI, 

you will need ensure that the following two flags are beingused:

如果你想要把 armeabi-v7a ABI 作为目标，你将需要确保如下两个标志是已使用：

  CFLAGS='-march=armv7-a-mfloat-abi=softfp'

Note: 

提示：

The first flag enables Thumb-2instructions, 

and the second one enables H/W FPUinstructions 

while ensuring that floating-point parameters are passed incore registers, 

which is critical for ABIcompatibility. 

第一个标志启用 Thumb-2 指令，且第二个标志启用硬件浮点单元指令，

在确保浮点参数用内核寄存器传递时 ABI 兼容性是关键的。

Do *not* use these flags separately!

不要分开使用这些标志！

If you want to use NEON instructions, you will need one morecompiler flag:

如果你想要使用 NEON 指令，你将需要一个编译器标志：

  CFLAGS='-march=armv7-a -mfloat-abi=softfp-mfpu=neon'

Note that this forces the use of VFPv3-D32, as per the ARMspecification.

注意这个标志强制 VFPv3-D32 的使用，依据 ARM 规范。

Also, is *required* to use the following linker flags thatroutes around

a CPU bug in some Cortex-A8 implementations:

同样，需要使用如下链接器标志在某些 Cortex-A8 实现中绕过一个 CPU 问题：

  LDFLAGS='-Wl,--fix-cortex-a8'

If none of the above makes sense toyou, 

it's probably better not to use the standalonetoolchain, 

and stick to the NDK build systeminstead, 

which will handle all the details for you.

如果上述的对你毫无感觉，或许最好不使用独立工具链，固守 NDK 生成系统，它将为你处理全部细节。

5/ Warnings and Limitations:

    警告和限制：

--------------------------

5.1/ Windows support:

      Windows 支持：

- - - - - - - - - - -

The Windows binaries do *not* depend onCygwin. 

Windows 二进制文件不依赖 Cygwin 。

The good news is that they are thusfaster, 

the bad news is that they do not understand the Cygwin

path specification like /cygdrive/c/foo/bar (instead ofC:/foo/bar).

好消息是它们因此更快，坏消息是它们不能理解 Cygwin 路径规范，

像 /cygdrive/c/foo/bar (代替 C:/foo/bar)。

The NDK build system ensures that all paths passed to thecompiler from Cygwin

are automatically translated, 

and deals with other horrors for you. 

NDK 生成系统确保全部路径从 Cygwin 传递到编译器是自动地翻译了，并且为你处理其它令人讨厌的事。

If you have a custom build system, 

you may need to deal with the problem yourself.

如果你有一个自定义生成系统，你可能需要自己去处理问题。

NOTE: 

注意：

There is no plan to support Cygwin / MSys at themoment, 

but contributions are welcome. 

目前没有计划去支持 Cygwin 或 MSys ，但是欢迎贡献。

Contact the android-ndk forum for details.

联系 android-ndk 论坛了解细节。

5.2/ wchar_t support:

      wchar_t 支持：

- - - - - - - - - - -

As documented, 

the Android platform did not really support wchar_t untilAndroid 2.3. 

正如记载的，Android 平台不真正地支持 wchar_t 直到 Android 2.3 。

What this means in practical terms is that:

在实际中这意味着：

  - If your target platform is android-9 orhigher, 

    the size of wchar_t is 4bytes, 

    and most wide-charfunctions are available in the C library

    (with the exception ofmulti-byte encoding/decoding functions and wsprintf/wsscanf).

    如果你的目标平台是 android-9或更高的话，wchar_t 是 4 字节大小，

    那么在 C库中有大部分的宽字符函数是可用的。

  - If you target any prior APIlevel, 

    the size of wchar_t willbe 1 byte and none of the wide-char functions will workanyway.

    如果你把任何之前 API级别作为目标的话，wchar_t 的大小将是 1 字节，

    那么不论以何种方式没有宽字符函数将工作。

We recommend any developer to get rid of any dependencies onthe wchar_t type

and switch to better representations. 

我们推荐任何的开发者从任何的 wchar_t 类型依赖中摆脱，然后转变为更好的表示。

The support provided in Android is only there to help youmigrate existing code.

Android 提供的支持是仅在这里帮助你迁移现存代码。

5.3/ Exceptions, RTTI and STL:

      例外，运行时信息和 STL ：

- - - - - - - - - - - - - - -

The toolchain binaries *do* support C++ exceptions and RTTI bydefault.

在默认情况下工具链二进制文件支持 C++ 例外和运行时信息。

They are enabled by default, 

so use -fno-exceptions and -fno-rtti if you want to disablethem 

when building sources with them (e.g. to generate smallermachine code).

它们默认是启用的，所以如果你想要禁用它们在生成源文件时使用 -fno-exceptions 和 -fno-rtti。

(例如：产生更小机器代码)

NOTE: 

注意：

You will need to explicitely link with libsupc++ if you usethese features. 

如果你使用这些功能的话，你将需要显示链接 libsupc++ 。

To do this, use -lsupc++ when linking binaries, as in:

要这样做，在链接二进制文件时使用 -lsupc++ ，如用：

    arm-linux-androideabi-g++ .... -lsupc++

The toolchain also comes with a working GNU libstdc++implementation, 

which provides a working C++ Standard Template Libraryimplementation. 

工具链同样带来一个有效的 GNU libstdc++ 实现，提供有效的 C++ 标准模板库实现。

You will need to explicitely link against -lstdc++ to useit.

你将需要显示链接 -lstdc++ 来使用它。

Proper toolchain configuration to avoid these explicit linkflags is planned for the future.

对于将来严格意义上的工具链配置避免这些显示链接标志是有计划的。