e164号码

概述

E.164 是国际电信联盟定义的在PSTN和一些数据网使用的国际公共电话码号方案，同时定义了具体的码号的格式。E.164定义了最大15数字，完整号码有国际呼叫前缀。
E.164号码是MSISDN号码，它是主叫用户为呼叫移动通信网中用户所需拨号的号码。
其格式为：CC+NDC+SN，也可以表示为：国家代码+N1N2N3+H0H1H2H3＋ABCD
（CC=国家码，中国为86；NDC=国内目的码；SN=用户号码）
例如给中国广东深圳0755-12345678拨号，处理后的结果是+8675512345678。其中+号表示要进行国际拨号，在拨号到运营商网络时候会自动（gsm会，cdma不一定）转成一个号码（中国就是00，+86在中国打的话其实就是0086），这个号码代表拨号时注册的运营商网络所在国家；86代表目的所在国家代码，中国的是86；755代表国内地区码（中国很大，按地区分，有些小国根本不需要），0755中的0是国内长途接入码，例如国内座机拨打外地手机号要加0，国际拨号的时候不需要；最后是目的地的号码，座机或者手机号码。

android中的使用

e164号码格式在Android framework中很多地方都有出现，格式化的方法见

frameworks/base/telephony/java/android/telephony/PhoneNumberUtils.java

   /**
     * Formats the specified {@code phoneNumber} to the E.164 representation.
     *
     * @param phoneNumber the phone number to format.
     * @param defaultCountryIso the ISO 3166-1 two letters country code.
     * @return the E.164 representation, or null if the given phone number is not valid.
     */
    public static String formatNumberToE164(String phoneNumber, String defaultCountryIso) {
        return formatNumberInternal(phoneNumber, defaultCountryIso, PhoneNumberFormat.E164);
    }

  private static String formatNumberInternal(
            String rawPhoneNumber, String defaultCountryIso, PhoneNumberFormat formatIdentifier) {

        PhoneNumberUtil util = PhoneNumberUtil.getInstance();
        try {
            PhoneNumber phoneNumber = util.parse(rawPhoneNumber, defaultCountryIso);
            if (util.isValidNumber(phoneNumber)) {
                if (formatIdentifier == PhoneNumberFormat.RFC3966) {
                    String postDial = extractPostDialPortion(rawPhoneNumber);
                    if (postDial != null && postDial.length() > 0) {
                        phoneNumber = new PhoneNumber().mergeFrom(phoneNumber)
                                .setExtension(postDial.substring(1));
                    }
                }
                return util.format(phoneNumber, formatIdentifier);
            }
        } catch (NumberParseException ignored) { }

        return null;
    

其中要完成格式化的类参见import：

import com.android.i18n.phonenumbers.NumberParseException;
import com.android.i18n.phonenumbers.PhoneNumberUtil;
import com.android.i18n.phonenumbers.PhoneNumberUtil.PhoneNumberFormat;
import com.android.i18n.phonenumbers.Phonemetadata.PhoneMetadata;
import com.android.i18n.phonenumbers.Phonenumber.PhoneNumber;
import com.android.i18n.phonenumbers.ShortNumberUtil;

这些都在libphonenumber静态包中，代码目录在external/libphonenumber下

external/libphonenumber/libphonenumber/src/com/google/i18n/phonenumbers/PhoneNumberUtil.java

 public String format(PhoneNumber number, PhoneNumberFormat numberFormat) {
    if (number.getNationalNumber() == 0 && number.hasRawInput()) {
      // Unparseable numbers that kept their raw input just use that.
      // This is the only case where a number can be formatted as E164 without a
      // leading '+' symbol (but the original number wasn't parseable anyway).
      // TODO: Consider removing the 'if' above so that unparseable
      // strings without raw input format to the empty string instead of "+00"
      String rawInput = number.getRawInput();
      if (rawInput.length() > 0) {
        return rawInput;
      }
    }
    StringBuilder formattedNumber = new StringBuilder(20);
    format(number, numberFormat, formattedNumber);
    return formattedNumber.toString();
  }

 public void format(PhoneNumber number, PhoneNumberFormat numberFormat,
                     StringBuilder formattedNumber) {
    // Clear the StringBuilder first.
    formattedNumber.setLength(0);
    int countryCallingCode = number.getCountryCode();
    String nationalSignificantNumber = getNationalSignificantNumber(number); //获取国内拨号号码，要处理国内地区码

    if (numberFormat == PhoneNumberFormat.E164) {
      // Early exit for E164 case (even if the country calling code is invalid) since no formatting
      // of the national number needs to be applied. Extensions are not formatted.
      formattedNumber.append(nationalSignificantNumber);
      prefixNumberWithCountryCallingCode(countryCallingCode, PhoneNumberFormat.E164,
                                         formattedNumber);
      return;
    }
    ...
  }

  private void prefixNumberWithCountryCallingCode(int countryCallingCode,
                                                  PhoneNumberFormat numberFormat,
                                                  StringBuilder formattedNumber) {
    switch (numberFormat) {
      case E164:
        formattedNumber.insert(0, countryCallingCode).insert(0, PLUS_SIGN);  //插入加号和国家码
        return;
      ...
    }
  }

格式化e164的调用链条如上，最后生成了一个可以用于国际拨号的号码。

cdma加号替换

由于cdma网络不一定转换加号，所以电信定制机都会加入自动转换加号的功能。mtk贴心的加入了这个功能：

/frameworks/opt/telephony/src/java/com/android/internal/telephony/cdma/CdmaCallTracker.java

    /// @}
    /// M: CC101: CDMA plus code @{
    private ICdmaCallTrackerExt mCdmaCallTrackerExt
            = MPlugin.createInstance(ICdmaCallTrackerExt.class.getName());
    /// @}

中间加入了mCdmaCallTrackerExt专门处理加号转换，ICdmaCallTrackerExt在
vendor/mediatek/proprietary/frameworks/common/src/com/mediatek/common/telephony/cdma/ICdmaCallTrackerExt.java

ICdmaCallTrackerExt是接口类，具体实现类在：
vendor/mediatek/proprietary/frameworks/base/packages/FwkPlugin/src/com/mediatek/op/telephony/cdma/CdmaCallTrackerExt.java

    public String processPlusCodeForDriverCall(String number, boolean isMt, int typeOfAddress) {
        if (isMt && typeOfAddress == PhoneNumberUtils.TOA_International) {
            Rlog.d(TAG, "processPlusCodeForDriverCall, before format number:" + number);
            if (number != null && number.length() > 0 && number.charAt(0) == '+') {
                number = number.substring(1, number.length());
            }
            number = mPlusCodeUtils.removeIddNddAddPlusCode(number);
            Rlog.d(TAG, "processPlusCodeForDriverCall, after format number:" + number);
        }
        number = PhoneNumberUtils.stringFromStringAndTOA(number, typeOfAddress);
        return number;
    }

其中可以看出这个类还是委托给PlusCodeProcessor去处理, 代码文件又回到了framework中，mtk加号处理实现的代码都在

frameworks/base/telephony/java/com/mediatek/internal/telephony/cdma/pluscode文件夹下，加号处理的具体逻辑还是很复杂的，不过对外使用很清晰。