summaryrefslogtreecommitdiff
path: root/core/java/android
diff options
context:
space:
mode:
authorYohei Yukawa <yukawa@google.com>2019-01-22 13:26:45 -0800
committerYohei Yukawa <yukawa@google.com>2019-01-22 13:26:45 -0800
commit92c15b1baf1ed2d40a93422d4db5d18d83e9b69f (patch)
tree94b324b4e0038b1160a54169b7cac1515a9b32ce /core/java/android
parent065aac1a1ef717d269d053be0ae9d805091773a9 (diff)
Deprecate InputMethodManager#setAdditionalInputMethodSubtypes()
This CL marks InputMethodManager#setAdditionalInputMethodSubtypes() deprecated. There is no actual implementation change at this moment, but developers should be informed that this API may stop working in a future version of Android. IME developers should start migration right now. Since this feature was implemented in Android 4.0 ICS [1], there have been many tricky bugs and documented/undocumented pitfalls. For IMEs that have already implemented features like customizable/downloadable keyboard layouts/languages, most likely re-implementing IMEs' own language switching mechanism then exposing only one unified IME subtype to the system would be a better long term choice. [1]: Ic7869cfaa5361531e08d58d7dfa5ba0feab0613e ee5e77cafec2eae70890abdcc1646ed39b06eddd Fix: 121220151 Test: make -j checkbuild Change-Id: I781abde2d6d97b8420b29b80e14b9cce97482754
Diffstat (limited to 'core/java/android')
-rw-r--r--core/java/android/view/inputmethod/InputMethodManager.java6
1 files changed, 6 insertions, 0 deletions
diff --git a/core/java/android/view/inputmethod/InputMethodManager.java b/core/java/android/view/inputmethod/InputMethodManager.java
index 86c5f188ffab..71b41ca76eec 100644
--- a/core/java/android/view/inputmethod/InputMethodManager.java
+++ b/core/java/android/view/inputmethod/InputMethodManager.java
@@ -2642,7 +2642,13 @@ public final class InputMethodManager {
*
* @param imiId Id of InputMethodInfo which additional input method subtypes will be added to.
* @param subtypes subtypes will be added as additional subtypes of the current input method.
+ * @deprecated For IMEs that have already implemented features like customizable/downloadable
+ * keyboard layouts/languages, please start migration to other approaches. One idea
+ * would be exposing only one unified {@link InputMethodSubtype} then implement
+ * IME's own language switching mechanism within that unified subtype. The support
+ * of "Additional Subtype" may be completely dropped in a future version of Android.
*/
+ @Deprecated
public void setAdditionalInputMethodSubtypes(String imiId, InputMethodSubtype[] subtypes) {
try {
mService.setAdditionalInputMethodSubtypes(imiId, subtypes);