libphonenumber:Google的公共电话号码解析库

前言

以前在项目中碰到一个问题，测试提了个需求：接听接话使，皮套界面要能解析号码的来源地，并且要和系统的语言保持一致。这个问题说难不难，但是也不简单，一般情况下，我们可能会想到建立一个数据库，然后写一个ContentPrivoder，然后在项目中使用提供的URI来解析电话号码。

如果你真的这么想，那么你这个任务就是无尽的任务了。因为你需要适配各种语言，需要收集这个国家的地名，这简直是不可能完成的任务！

好了，大家稍安勿躁，我不是来吐槽的，我是来提供解决方法的，大家接着看下去。

---

我认为最好的办法就是用Google的公共电话号码解析库—libphonenumber

这个库Android源码的路径是：

    external/libphonenumber/
    当然了，github上面也有，地址是：
    [libphonenumber](https://github.com/googlei18n/libphonenumber)

---

由于我本人是直接使用Android源码下的库，所以我接下来用它来举例子。

首先用使用这个库，有两个方法：

• 将libphonenumber作为module放到你的工程里
• 将libphonenumber作为jar放到Android工程的libs目录下

---

步骤

在这里我们使用第二种，至于第一种方法不会使用的，可以问度娘，接来我说说使用步骤：

1. 编译libphonenumber
   使用mmm external/libphonenumber/，之后在终端下看到这个：
   

2. 找到对应的jar包

   看图可以知道，out下生成了很多jar包，我们选倒数第二个。为了便于识别我们把classes.jar改名为libphonenumber.jar。

3. 导入到工程里

   我用的是Android Studio，也希望也用这个工具，毕竟谷歌推荐用这款软件。
   首先，复制到libs下：
   

   接着配置app那级的build.gradle，在dependencies里面添加一行：

    compile files('libs/libphonenumber.jar')

如图：

当然了，如果你的dependencies有下面这么一句代码，那就不用在手动添加，它会自动包含libs目录下面所有的jar。

    compile fileTree(dir: 'libs', include: ['*.jar'])

4.在代码里面使用该库的接口

可以仿照源码InCallUI模块下面CallerInfo.java类下面的getGeoDescription方法：

/**
     * @return a geographical description string for the specified number.
     * @see com.android.i18n.phonenumbers.PhoneNumberOfflineGeocoder
     */
    private static String getGeoDescription(Context context, String number) {
        Log.v(TAG, "getGeoDescription('" + number + "')...");

        if (TextUtils.isEmpty(number)) {
            return null;
        }

        PhoneNumberUtil util = PhoneNumberUtil.getInstance();
        PhoneNumberOfflineGeocoder geocoder = PhoneNumberOfflineGeocoder.getInstance();

        Locale locale = context.getResources().getConfiguration().locale;
        String countryIso = TelephonyManagerUtils.getCurrentCountryIso(context, locale);
        PhoneNumber pn = null;
        try {
            Log.v(TAG, "parsing '" + number
                    + "' for countryIso '" + countryIso + "'...");
            pn = util.parse(number, countryIso);
            Log.v(TAG, "- parsed number: " + pn);
        } catch (NumberParseException e) {
            Log.v(TAG, "getGeoDescription: NumberParseException for incoming number '" +
                    number + "'");
        }

        if (pn != null) {
            String description = geocoder.getDescriptionForNumber(pn, locale);
            Log.v(TAG, "- got description: '" + description + "'");
            return description;
        }

        return null;
    }

这是我自己为了调用该接口，创建的一个类：

import android.content.Context;
import android.telephony.TelephonyManager;
import android.text.TextUtils;
import android.util.Log;

import com.google.i18n.phonenumbers.NumberParseException;
import com.google.i18n.phonenumbers.PhoneNumberUtil;
import com.google.i18n.phonenumbers.Phonenumber;
import com.google.i18n.phonenumbers.geocoding.PhoneNumberOfflineGeocoder;

import java.util.Locale;

/**
 * Created by neal on 9/6/16.
 */
public class CallerInfo {

    private static final String TAG = "CallerInfo";

    /**
     * @return a geographical description string for the specified number.
     * @see com.android.i18n.phonenumbers.PhoneNumberOfflineGeocoder
     */
    public static String getGeoDescription(Context context, String number) {
        android.util.Log.d(TAG, "getGeoDescription('" + number + "')...");

        if (TextUtils.isEmpty(number)) {
            return null;
        }

        PhoneNumberUtil util = PhoneNumberUtil.getInstance();
        PhoneNumberOfflineGeocoder geocoder = PhoneNumberOfflineGeocoder.getInstance();

        Locale locale = context.getResources().getConfiguration().locale;

        final TelephonyManager telephonyManager =
                (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);
        String countryIso = telephonyManager.getNetworkCountryIso().toUpperCase();

        if (countryIso == null) {
            countryIso = locale.getCountry();
            Log.w(TAG, "No CountryDetector; falling back to countryIso based on locale: "
                    + countryIso);
        }

        Phonenumber.PhoneNumber pn = null;
        try {
            android.util.Log.d(TAG, "parsing '" + number
                    + "' for countryIso '" + countryIso + "'...");
            pn = util.parse(number, countryIso);
            android.util.Log.d(TAG, "- parsed number: " + pn);
        } catch (NumberParseException e) {
            android.util.Log.d(TAG, "getGeoDescription: NumberParseException for incoming number '" +
                    number + "'");
        }

        if (pn != null) {
            String description = geocoder.getDescriptionForNumber(pn, locale);
            android.util.Log.d(TAG, "- got description: '" + description + "'");
            return description;
        }

        return null;
    }

}

最后你在需要获取地名的地方调用：

String address = CallerInfo.getGeoDescription(mContext,number);