1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
|
/*
* Copyright (C) 2015 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.android.contacts.common.compat;
import android.telephony.PhoneNumberUtils;
import android.text.Spannable;
import android.text.TextUtils;
import android.text.style.TtsSpan;
import com.android.dialer.compat.CompatUtils;
import com.google.i18n.phonenumbers.NumberParseException;
import com.google.i18n.phonenumbers.PhoneNumberUtil;
import com.google.i18n.phonenumbers.Phonenumber.PhoneNumber;
/**
* This class contains static utility methods extracted from PhoneNumberUtils, and the methods were
* added in API level 23. In this way, we could enable the corresponding functionality for pre-M
* devices. We need maintain this class and keep it synced with PhoneNumberUtils. Another thing to
* keep in mind is that we use com.google.i18n rather than com.android.i18n in here, so we need make
* sure the application behavior is preserved.
*/
public class PhoneNumberUtilsCompat {
/** Not instantiable. */
private PhoneNumberUtilsCompat() {}
public static String normalizeNumber(String phoneNumber) {
if (CompatUtils.isLollipopCompatible()) {
return PhoneNumberUtils.normalizeNumber(phoneNumber);
} else {
return normalizeNumberInternal(phoneNumber);
}
}
/** Implementation copied from {@link PhoneNumberUtils#normalizeNumber} */
private static String normalizeNumberInternal(String phoneNumber) {
if (TextUtils.isEmpty(phoneNumber)) {
return "";
}
StringBuilder sb = new StringBuilder();
int len = phoneNumber.length();
for (int i = 0; i < len; i++) {
char c = phoneNumber.charAt(i);
// Character.digit() supports ASCII and Unicode digits (fullwidth, Arabic-Indic, etc.)
int digit = Character.digit(c, 10);
if (digit != -1) {
sb.append(digit);
} else if (sb.length() == 0 && c == '+') {
sb.append(c);
} else if ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z')) {
return normalizeNumber(PhoneNumberUtils.convertKeypadLettersToDigits(phoneNumber));
}
}
return sb.toString();
}
public static String formatNumber(
String phoneNumber, String phoneNumberE164, String defaultCountryIso) {
if (CompatUtils.isLollipopCompatible()) {
return PhoneNumberUtils.formatNumber(phoneNumber, phoneNumberE164, defaultCountryIso);
} else {
// This method was deprecated in API level 21, so it's only used on pre-L SDKs.
return PhoneNumberUtils.formatNumber(phoneNumber);
}
}
public static CharSequence createTtsSpannable(CharSequence phoneNumber) {
if (CompatUtils.isMarshmallowCompatible()) {
return PhoneNumberUtils.createTtsSpannable(phoneNumber);
} else {
return createTtsSpannableInternal(phoneNumber);
}
}
public static TtsSpan createTtsSpan(String phoneNumber) {
if (CompatUtils.isMarshmallowCompatible()) {
return PhoneNumberUtils.createTtsSpan(phoneNumber);
} else if (CompatUtils.isLollipopCompatible()) {
return createTtsSpanLollipop(phoneNumber);
} else {
return null;
}
}
/** Copied from {@link PhoneNumberUtils#createTtsSpannable} */
private static CharSequence createTtsSpannableInternal(CharSequence phoneNumber) {
if (phoneNumber == null) {
return null;
}
Spannable spannable = Spannable.Factory.getInstance().newSpannable(phoneNumber);
addTtsSpanInternal(spannable, 0, spannable.length());
return spannable;
}
/** Compat method for addTtsSpan, see {@link PhoneNumberUtils#addTtsSpan} */
public static void addTtsSpan(Spannable s, int start, int endExclusive) {
if (CompatUtils.isMarshmallowCompatible()) {
PhoneNumberUtils.addTtsSpan(s, start, endExclusive);
} else {
addTtsSpanInternal(s, start, endExclusive);
}
}
/** Copied from {@link PhoneNumberUtils#addTtsSpan} */
private static void addTtsSpanInternal(Spannable s, int start, int endExclusive) {
s.setSpan(
createTtsSpan(s.subSequence(start, endExclusive).toString()),
start,
endExclusive,
Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
}
/** Copied from {@link PhoneNumberUtils#createTtsSpan} */
private static TtsSpan createTtsSpanLollipop(String phoneNumberString) {
if (phoneNumberString == null) {
return null;
}
// Parse the phone number
final PhoneNumberUtil phoneNumberUtil = PhoneNumberUtil.getInstance();
PhoneNumber phoneNumber = null;
try {
// Don't supply a defaultRegion so this fails for non-international numbers because
// we don't want to TalkBalk to read a country code (e.g. +1) if it is not already
// present
phoneNumber = phoneNumberUtil.parse(phoneNumberString, /* defaultRegion */ null);
} catch (NumberParseException ignored) {
}
// Build a telephone tts span
final TtsSpan.TelephoneBuilder builder = new TtsSpan.TelephoneBuilder();
if (phoneNumber == null) {
// Strip separators otherwise TalkBack will be silent
// (this behavior was observed with TalkBalk 4.0.2 from their alpha channel)
builder.setNumberParts(splitAtNonNumerics(phoneNumberString));
} else {
if (phoneNumber.hasCountryCode()) {
builder.setCountryCode(Integer.toString(phoneNumber.getCountryCode()));
}
builder.setNumberParts(Long.toString(phoneNumber.getNationalNumber()));
}
return builder.build();
}
/**
* Split a phone number using spaces, ignoring anything that is not a digit
*
* @param number A {@code CharSequence} before splitting, e.g., "+20(123)-456#"
* @return A {@code String} after splitting, e.g., "20 123 456".
*/
private static String splitAtNonNumerics(CharSequence number) {
StringBuilder sb = new StringBuilder(number.length());
for (int i = 0; i < number.length(); i++) {
sb.append(PhoneNumberUtils.isISODigit(number.charAt(i)) ? number.charAt(i) : " ");
}
// It is very important to remove extra spaces. At time of writing, any leading or trailing
// spaces, or any sequence of more than one space, will confuse TalkBack and cause the TTS
// span to be non-functional!
return sb.toString().replaceAll(" +", " ").trim();
}
}
|
