【翻译】(9)CPU Features
-----------------
英文文档见android-ndk-r5b的documentation.html
属于Android Native Development Kit (NDK)的一部分
见http://developer.android.com/sdk/ndk/（需要代理）
翻译仅个人见解
-----------------
?
Android NDK CPU Features detection library:
?
Android NDK CPU特性检测库：
-------------------------------------------
?
This NDK provides a small library named "cpufeatures" that can be used at runtime to detect the target device's CPU family and the optional features it supports.
?
NDK提供一个名为cpufeatures的小型库，它可以用于在运行期检测目标设备的CPU家族和它支持的可选特性。
?
Usage:
?
用法：
------
?
The library is available as an import module. To use it, you must:
?
这个库作为导入模块可用。要使用它，你必须：
?
To use it, you must:
?
要使用它，你必须：
?
??* List 'cpufeatures' in your list of static library dependencies, as in:
?
??* 在你的静态库依赖列表中列出cpufeatures，正如这样：
?
?? ? ? ?LOCAL_STATIC_LIBRARIES := cpufeatures
?
??* At the end of your Android.mk, import the 'android/cpufeatures' module, as in:
?
??* 在你的Android.mk结束处，导入android/cpufeatures模块，正如这样：
?
?? ? ? ?$(call import-module,android/cpufeatures)
?
??* In your source code, include the header named <cpu-features.h>
?
??* 在你的源代码中，包含名为<cpu-features.h>的头文件
?
Here is a simple example:
?
这里是一个简单示例：
?
<project-path>/jni/Android.mk:
?? ?LOCAL_PATH := $(call my-dir)
?
?? ?include $(CLEAR_VARS)
?? ?LOCAL_MODULE := <your-module-name>
?? ?LOCAL_SRC_FILES := <your-source-files>
?? ?LOCAL_STATIC_LIBRARIES := cpufeatures
?? ?include $(BUILD_SHARED_LIBRARY)
?
?? ?$(call import-module,android/cpufeatures)
?
?
Features:
?
特性：
---------
?
Two functions are provided for now:
?
现在提供两个函数：
?
?? AndroidCpuFamily ? android_getCpuFamily();
?
Returns the target device's CPU Family as an enum. For now, the only supported family is ANDROID_CPU_FAMILY_ARM.
?
用一个枚举值返回目标设备的CPU家族。现在，唯一支持的家族是ANDROID_CPU_FAMILY_ARM。
?
?? uint64_t ? android_getCpuFeatures();
?
Returns the set of optional features supported by the device's CPU. The result is a set of bit-flags, each corresponding to one CPU Family-specific optional feature.
?
返回设备CPU支持的可选特性。结构是一个位标志集合，每个位标志对应一项CPU家族特定的可选特性。
?
Currently, only the following flags are defined, for the ARM CPU Family:
?
目前，只为ARM CPU家族定义了如下标志：
?
?? ANDROID_CPU_ARM_FEATURE_ARMv7
?? ? ?Indicates that the device's CPU supports the ARMv7-A instruction set as supported by the "armeabi-v7a" abi (see CPU-ARCH-ABIS.html). This corresponds to Thumb-2 and VFPv3-D16 instructions.
?
?? ANDROID_CPU_ARM_FEATURE_ARMv7
?? ? ?指出设备的CPU支持ARMv7-A指令集，它由armeabi-v7a的ABI（注：应用程序二进制接口，操作系统暴露的接口，使二进制程序不需要重新编译即可在兼容ABI的操作系统上运行）支持（参考CPU-ARCH-ABIS.html）。它对应Thumb-2和VFPv3-D16指令。
?
?
?? ANDROID_CPU_ARM_FEATURE_VFPv3
?? ? ?Indicates that the device's CPU supports the VFPv3 hardware FPU instruction set extension. Due to the definition of 'armeabi-v7a', this will always be the case if ANDROID_CPU_ARM_FEATURE_ARMv7 is returned.
?
?? ANDROID_CPU_ARM_FEATURE_VFPv3
?? ? ?指出设备CPU支持VFPv3硬件FPU（注：FPU是浮点运算单元的缩写）指令集扩展。由于armeabi-v7a的定义，它将总是返回ANDROID_CPU_ARM_FEATURE_ARMv7（注：这里的意思可能是，它总是和ANDROID_CPU_ARM_FEATURE_ARMv7一起返回）。
?
?? ? ?Note that this corresponds to the minimum profile VFPv3-D16 that _only_ provides 16 hardware FP registers.
?
?注意它对应最小型号是VFPv3-D16，它只提供16个硬件浮点寄存器。
?
?? ANDROID_CPU_ARM_FEATURE_NEON
?? ? ?Indicates that the device's CPU supports the ARM Advanced SIMD (a.k.a. NEON) vector instruction set extension. Note that ARM mandates that such CPUs also implement VFPv3-D32, which provides 32 hardware FP registers (shared with the NEON unit).
?
?? ANDROID_CPU_ARM_FEATURE_NEON
?? ? ?指出设备CPU支持ARM高级SIMD（即NEON）（注：NEON技术是ARM SIMD扩展指令，用于多媒体处理的硬件加速）向量指令集扩展。注意ARM授权这种CPU还实现了VFPv3-D32，提供32个硬件浮点寄存器（与NEON单元共享）。
?
?
Important Note:
?
重要注意事项：
---------------
?
The cpufeatures library will be updated to support more CPU families and optional features in the future. It is designed to work as-is on all official Android platform versions.
?
cpufeatures库将被更新以支持未来更多CPU家族和可选特性。它被设计为在所有官方Android平台版本上保持原样地工作。
?
Change History:
?
修改历史：
---------------
?
Please see the comments in $NDK/sources/android/cpufeatures/cpu-features.c for the complete change history for this library.
?
请参考$NDK/sources/android/cpufeatures/cpu-features.c中的注释以获得这个库的完整修改历史。（注：估计写文档的人太懒...）
?
