static void android_location_GpsLocationProvider_class_init_native(JNIEnv* env, jclass clazz) {

    int err;

    hw_module_t* module;

    //获取JNI回调函数集对应的Java MethodId。如果读者不熟悉JNI，请阅读《深入理解Android：卷1》

   //第2章“深入理解JNI”

    method_reportLocation = env->GetMethodID(clazz, "reportLocation", "(IDDDFFFJ)V");

    .......//JNI回调函数集的其他函数，下文会详细介绍它们

    method_setEngineCapabilities = env->GetMethodID(clazz, "setEngineCapabilities", "(I)V");

    .......

   //加载GPS HAL层模块，GPS_HARDWARE_MODULE_ID的值为“gps”

    err = hw_get_module(GPS_HARDWARE_MODULE_ID, (hw_module_t const**)&module);

    if (err == 0) {

        hw_device_t* device;

        //打开GPS HAL层模块

        err = module->methods->open(module, GPS_HARDWARE_MODULE_ID, &device);

        if (err == 0) {

            gps_device_t* gps_device = (gps_device_t *)device;

             //获取GPS HAL层最主要的交互接口GpsInterface，它是JNI层和HAL层的重要交互

            sGpsInterface = gps_device->get_gps_interface(gps_device);

    //GPS HAL模块对外还提供了几个重要交互接口。

    if (sGpsInterface) {

        sGpsXtraInterface =  //用来和GPS HAL层中xtra模块交互的接口

            (const GpsXtraInterface*)sGpsInterface->get_extension(GPS_XTRA_INTERFACE);

        sAGpsInterface = //用来和GPS HAL层AGPS模块交互的接口

            (const AGpsInterface*)sGpsInterface->get_extension(AGPS_INTERFACE);

        sGpsNiInterface = //用来和GPS HAL层NI（Network Initiated）模块交互的接口

            (const GpsNiInterface*)sGpsInterface->get_extension(GPS_NI_INTERFACE);

        sGpsDebugInterface = //用来调试的接口

            (const GpsDebugInterface*)sGpsInterface->get_extension(GPS_DEBUG_INTERFACE);

        sAGpsRilInterface = //用来和GPS HAL层AGPS及RIL相关的接口

            (const AGpsRilInterface*)sGpsInterface->get_extension(AGPS_RIL_INTERFACE);

static jboolean android_location_GpsLocationProvider_init(JNIEnv* env, jobject obj)

    // this must be set before calling into the HAL library

    if (!mCallbacksObj)

        mCallbacksObj = env->NewGlobalRef(obj);

   //向GPS HAL层设置回调函数接口。当GPS HAL层有情况需要通知JNI层时，这些回调函数

   //将被调用

    if (!sGpsInterface || sGpsInterface->init(&sGpsCallbacks) != 0)

        return false;

   //设置其他接口的回调函数

    if (sGpsXtraInterface && sGpsXtraInterface->init(&sGpsXtraCallbacks) != 0)

        sGpsXtraInterface = NULL;

    if (sAGpsInterface)  sAGpsInterface->init(&sAGpsCallbacks);

    if (sGpsNiInterface) sGpsNiInterface->init(&sGpsNiCallbacks);

    if (sAGpsRilInterface) sAGpsRilInterface->init(&sAGpsRilCallbacks);

    return true;

//初始化JNI层相关的类型

native void class_init_native();

//判断系统是否支持GPS

native boolean native_is_supported();

//初始化GPS HAL层模块

native boolean native_init();

//清理GPS HAL层模块所分配的资源

native void native_cleanup();

  设置GPS模块工作模式，其各个参数取值含义如下：

  mode：GPS工作模式，目前可取值有GPS_POSITION_MODE_STANDALONE（值为0，仅GPS工作），

         GPS_POSITION_MODE_MS_BASED（值为1，AGPS MSB模式），GPS_POSITION_MODE_MS_ASSISTED

         （值为2，AGPS MSA模式）

  recurrence：位置更新模式，目前可取值有GPS_POSITION_RECURRENCE_PERIODIC（值为0，连续

               定位）、GPS_POSITION_RECURRENCE_SINGLE（值为1，单次定位）

  min_interval:最短位置更新时间，单位为毫秒

  preferred_accurary: 期望的位置更新精度，单位为米

  preferred_time：期望的TTFF时间，单位为毫秒

native boolean native_set_position_mode(int mode, int recurrence, int min_interval,

            int preferred_accuracy, int preferred_time);

//下面这个两个函数用于启动和关闭导航

native boolean native_start();

native boolean native_stop();

//删掉AGPS辅助数据，其flags参数的取值请读者阅读GpsLocationProvider.java的deleteAidingData函数

native void native_delete_aiding_data(int flags);

//读取卫星信息，该函数在“reportStatus和reportSvStatus介绍”一节中已介绍过了

native int native_read_sv_status(int[] svs, float[] snrs,

            float[] elevations, float[] azimuths, int[] masks);

//读取NMEA数据

native int native_read_nmea(byte[] buffer, int bufferSize);

//输入位置信息，在GpsLP中，该位置信息由NetworkLP提供

native void native_inject_location(double latitude, double longitude, float accuracy);

输入NTP时间，其中：

time:为NtpTimeTrustedTime从网络中获取到的NTP时间

timeReference：为设备从开机到一次NTP请求处理成功后的所耗费的时间，由SystemClock的elapsedRealtime

uncertainty：准确度。在Android系统中，该值为NTP请求发送和接收往返时间的一般。详情可参考

                       SnetpClient.java文件

native void native_inject_time(long time, long timeReference, int uncertainty);

//GPS模块是否支持XTRA数据

native boolean native_supports_xtra();

//输入XTRA数据，即LTO数据

native void native_inject_xtra_data(byte[] data, int length);

//用于调试，获取GPS模块内部状态

native String native_get_internal_state();

//打开AGPS数据下载通道，参数apn指明了所要使用的APN

native void native_agps_data_conn_open(String apn);

//关闭AGPS数据下载通道

native void native_agps_data_conn_closed();

//GpsLP处理AGPS相关事宜失败时候调用下面这个函数

native void native_agps_data_conn_failed();

//将来自数据短信或WAP推送短信得到的信息传递给GPS模块。

native void native_agps_ni_message(byte [] msg, int length);

//设置AGPS服务端地址，其中type取值有两种：

//AGPS_TYPE_SUPL：值为1，代表SUPL服务器

//AGPS_TYPE_C2K：值为2，代表C2K服务器

native void native_set_agps_server(int type, String hostname, int port);

当GPS模块需要使用APGS时，会调用reportNiNotification函数（详情见下文）以通知用户。

用户处理完后，将通过下面这个函数告知GPS模块处理结果。注意，这部分内容涉及到OMA-SUPL相关知识，请读者

阅读参考资料[28]。

该函数的参数如下：

notificationId：通知id，代表GPS HAL层的某一个处理请求

userResponse有三种取值，分别是GPS_NI_RESPONSE_ACCEPT（值为0，代表用户允许相关操作）、

               GPS_NI_RESPONSE_DENY（值为1，用户拒绝相关操作）、GPS_NI_RESPONSE_NORESP

               （值为2，代表用户无回应）。NI和GpsNetInitiatedHandler有关，读者可自行研究它

native void native_send_ni_response(int notificationId, int userResponse);

   设置AGPS参考位置信息，其各参数解释如下：

   type:取值可为AGPS_REF_LOCATION_TYPE_GSM_CELLID（值为1，代表GMS网络的cell id）、

         AGPS_REF_LOCATION_TYPE_UMTS_CELLID（值为2，代表CDMA网络的cell id）、

         AGPS_REG_LOCATION_TYPE_MAC（值为3，代表MAC地址）

   mcc：Mobile Country Code（移动国家码），由3位数字组成，唯一地识别移动用户所属的国家，中国为460

   mnc：Mobile Network Code（移动网络码），用于识别移动用户所归属的移动网络。中国移动TD系统使用00，

         中国联通GSM系统使用01，中国移动GSM系统使用02，中国电信CDMA系统使用03

   lac：Location Area Code（位置区码）。移动通信中，为了确定终端台的位置，每个移动网络的覆盖区都被划分

        成许多位置区，位置区码(LAC)则用于标识不同的位置区。

   cid：cell id（基站编号）

native void native_agps_set_ref_location_cellid(int type, int mcc, int mnc,

            int lac, int cid);

设置终端与移动网络相关的一些参数信息，其type参数决定了setid参数的取值。type可取值有：

type: AGPS_SETID_TYPE_NONE，值为0，无意义

       AGPS_SETID_TYPE_IMSI，值为1，代表IMSI（international mobiles subscriber identity，

       国际移动用户号码标识）。IMSI信息存储在SIM卡上。

      AGPS_SETID_TYPE_MSISDN，值为2，代表Mobile Subscriber ISDN（用户号码），即手机号码

native void native_agps_set_id(int type, String setid);

  通知GPS HAL层系统当前网络的状态，其各参数解释如下：

  connected：网络是否连接

  type：网络类型，可取值请参考ConnectivityManager中各网络类型的定义情况。常用的有TYPE_MOBILE、

         TYPE_WIFI等

  roaming：是否处于漫游状态

  available：网络是否可用

  extraInfo：附加信息

  defaultAPN：默认APN

native void native_update_network_state(boolean connected, int type,

            boolean roaming, boolean available, String extraInfo, String defaultAPN);

//GPS模块汇报位置信息

void reportLocation(int flags, double latitude, double longitude, double altitude,

            float speed, float bearing, float accuracy, long timestamp)：

//GPS模块通知GPS工作状态

void reportStatus(int status)：

//GPS模块通知卫星状态

void reportSvStatus()：

//GPS模块通知AGPS状态

void reportAGpsStatus(int type, int status, int ipaddr)：

//GPS模块通知NMEA信息

void reportNmea(long timestamp)：

//GPS模块通知GpsLP自己的能力

void setEngineCapabilities(int capabilities)：

//GPS模块要求下载XTRA数据

void xtraDownloadRequest()：

//GPS模块通知Network Initiated通知，其各参数解释如下：

void reportNiNotification(

            int notificationId,//GPS HAL层分配的通知ID

            int niType,//NI类型，可取值请参考gps.h的GpsNiType的定义

            int notifyFlags,//标志信息，可取值请参考gps.h的GpsNiNotifyFlags定义

            int timeout,//等待用户处理的超时时间

            //当超时发生后，系统采用的默认处理结果。其取值和native_send_ni_respons中第二个参数一样

            int defaultResponse,

            String requestorId,//代表请求者的id

            String text, //通知信息

            int requestorIdEncoding,//requestorId的编码格式，参考gps.h GpsNiEncodingType的定义

            int textEncoding,//text的编码格式

            String extras  //附加信息

//要求获取参考位置信息，flags参数目前没有使用

void requestRefLocation(int flags)：

//要求设置移动网络相关信息，flags参数表示要获取什么样的信息，可取值同native_agps_set_id的type参数

void requestSetID(int flags)：

//要求获取UTC时间

void requestUtcTime()：

typedef struct {

     size_t          size;//GpsInterface结构体的长度

   //初始化GPS模块。其参数为GPS模块所需的回调函数

    int   (*init)( GpsCallbacks* callbacks );

   //下面这两个函数用于开启或关闭导航

    int   (*start)( void );

    int   (*stop)( void );

    //清理GPS模块所分配的资源

    void  (*cleanup)( void );

    //输入UTC时间，参数解释同native_inject_time

    int   (*inject_time)(GpsUtcTime time, int64_t timeReference,int uncertainty);

    //输入位置信息，参数解释同native_inject_location

    int  (*inject_location)(double latitude, double longitude, float accuracy);

   //删除赋值信息，其参数解释同native_delete_aiding_data

    void  (*delete_aiding_data)(GpsAidingData flags);

   //设置GPS模块的工作模式，其参数解释同native_set_position_mode

    int   (*set_position_mode)(GpsPositionMode mode, GpsPositionRecurrence recurrence,

            uint32_t min_interval, uint32_t preferred_accuracy, uint32_t preferred_time);

   //获取GPS模块实现的扩展接口，AGPS扩展接口对应的name为“agps”、xtra扩展接口对应的name为“xtra”

   const void* (*get_extension)(const char* name);

} GpsInterface;

typedef struct {

    size_t          size;

    //初始化GPS中的xtra相关模块

    int  (*init)( GpsXtraCallbacks* callbacks );

     //输入xtra数据，其参数解释同native_inject_xtra_data

    int  (*inject_xtra_data)( char* data, int length );

} GpsXtraInterface;

typedef struct {

    size_t          size;

    //初始化AGPS模块

    void  (*init)( AGpsCallbacks* callbacks );

    //打开AGPS数据连接，其参数解释同native_data_conn_open

    int  (*data_conn_open)( const char* apn );

    //关闭AGPS数据连接，其参数解释同native_data_conn_close

    int  (*data_conn_closed)();

    //AGPS数据连接操作失败，同native_data_conn_fail

    int  (*data_conn_failed)();

    //设置AGPS服务器地址等相关信息，参数解释同native_agps_set_server

    int  (*set_server)( AGpsType type, const char* hostname, int port );

} AGpsInterface;

typedef struct

   size_t          size;

   //初始化NI模块

   void (*init) (GpsNiCallbacks *callbacks);

   //发送NI回复，请参数同native_send_ni_response

   void (*respond) (int notif_id, GpsUserResponseType user_response);

} GpsNiInterface;

typedef struct {

   size_t          size;

   //初始化AGPS Ril相关的处理模块

   void  (*init)( AGpsRilCallbacks* callbacks );

   //设置参考位置信息，其第一个参数类型为AGpsRefLocation，该结构体的成员与

   //native_agps_set_ref_location_cellid函数的参数一一对应

   void (*set_ref_location) (const AGpsRefLocation *agps_reflocation, size_t sz_struct);

    //设置AGPS移动网络id信息，其参数解释同native_agps_set_id

    void (*set_set_id) (AGpsSetIDType type, const char* setid);

    //设置NI消息，其参数解释同native_agps_ni_message

    void (*ni_message) (uint8_t *msg, size_t len);

    //注意，下面这两个函数的参数合起来就是native_update_network_state的参数。Java层调用

    //一次native_update_network_state将触发下面这两个函数被调用

    //更新移动网络状态

    void (*update_network_state) (int connected, int type, int roaming, const char* extra_info);

   //设置网络连接状态

    void (*update_network_availability) (int avaiable, const char* apn);

} AGpsRilInterface;

---