最近工作比較忙,加班出差,因此更新慢了些。今天剛好有空,寫一篇執行個體詳解吧。
本博前面的文章介紹了Android開發環境的搭建和模擬器的常用操作。本次,將以Android Sample中經典的SoftKeyboard項目為例,詳細解析Android上一個小型項目的開發過程和注意事項。
從SDK 1.5版本以後,Android就開放它的IMF(Input Method Framework),讓我們能夠開發自己的IME。而開發IME最好的參考就是Android內建的Sample-SoftKeyboard,雖然這個例子僅包含英文和數字輸入,但是它本身還算完整和清楚,對我們開始Android開發實戰有很大協助。
一、IMF
簡介
一個IMF結構中包含三個主要的部分:
input method manager:管理各部分的互動。它是一個用戶端API,存在於各個應用程式的context中,用來溝通管理所有進程間互動的全域系統服務。
input method(IME):實現一個允許使用者產生文本的獨立互動模組。系統綁定一個當前的IME。使其建立和產生,決定IME何時隱藏或者顯示它的UI。同一時間只能有一個IME運行。
client application:通過IME管理器控制輸入焦點和IME的狀態。一次只能有一個用戶端使用IME。
1
、InputManager
由UI控制項(View,TextView,EditText等)調用,用來操作IME。比如,開啟,關閉,切換IME等。
它是整個IME架構(IMF)結構的核心API,處理應用程式和當前IME的互動。可以通過Context.getSystemService()來擷取一個InputMethodManager的執行個體。
在開發過程中,最基礎最重要的就是養成閱讀API的習慣。優秀的程式員要養成把自己關在小黑屋裡,斷絕與外界的連網和聯絡,僅僅靠自己電腦中的開發環境和API文檔,以及漂亮女僕送來的每天三頓飯,寫出優秀的程式。這個在武俠小說中叫閉關,在軟體開發中叫Clean Room,哈哈。
Android的API文檔在:%SDK_ROOM%/docs/reference/index.html,
InputManager類的位置:%SDK_ROOM%/docs/reference/android/view/inputmethod/InputMethodManager.html
由於,該類跟本次要講的Sample關係不大,這裡就不詳細分析,請各位自行閱讀API doc吧。
2
、InputMethodService
包括IME內部邏輯,鍵盤配置,選詞等,最終把選出的字元通過commitText提交出來。實現IME的基礎就是名為InputMethodService的類,比如你要實現一個GoogleIME,就是要extends本類。我們接下來要學習的SoftKeyboard Sample也是extends本類。InputMethodService類的位置在:%SDK_ROOM%/docs/reference/android/inputmethodservice/InputMethodService.html
InputMethodService是InputMethod的一個完整實現,你可以再在其基礎上擴充和定製。它的主要方法如下:
- onInitializeInterface() 顧名思義,它在初始化介面的時候被調用,而一般是由於設定檔的更改導致該函數的執行
- onBinndInput() 它在另外的用戶端和該IME串連時調用
- onStartInput() 非常重要的一個回調,它在編輯框中使用者已經開始輸入的時候調用。比如,當點擊一個輸入框,我們需要根據這個輸入框的資訊,設定IME的一些特性,這個在Sample中很有體會。
- onCreateInputView() 返回一個層次性的輸入視圖,而且只是在這個視圖第一次顯示的時候被調用
- onCreateCandidatesView() 同onCreateInputView(),只不過建立的是候選框的視圖。
- onCreateExtractTextView() 比較特殊,是在全螢幕模式下的一個視圖。
- onStartInputView() 在輸入視圖被顯示並且在一個新的輸入框中輸入已經開始的時候調用。
基本上IME的定製,都是圍繞在這個類來實現的,它主要提供的是一個基本的使用者介面架構(包括輸入視圖,候選詞視圖和全螢幕模式),但是這些都是要實現者自己去定製的。這裡的實現是讓所有的元素都放置在了一個單一的由InputMethodService來管理的視窗中。它提供了很多的回調API,需要我們自己去實現。一些預設的設定包括:
- 軟鍵盤輸入視圖,它通常都是被放置在螢幕的下方。
- 候選詞視圖,它通常是放置在輸入視圖的上面。
- 當我們輸入的時候,需要改變應用程式的介面來適應這些視圖的放置規則。比如在Android上面輸入,編輯框會自動變形騰出一個軟鍵盤的位置來。
兩個非常重要的視圖:
1. 軟輸入視圖。是與使用者互動的主要發生地:按鍵,畫圖或者其他的方式。通常的實現就是簡單的用一個視圖來處理所有的工作,並且在調用 onCreateInputView()的時候返回一個新的執行個體。通過調用系統的onEvaluateInputViewShow()來測試是否需要顯示輸入視圖,它是系統根據當前的上下文環境來實現的。當IME狀態改變的時候,需要調用updateInputViewShown()來重新估計一下。
2. 候選詞視圖。當使用者輸入一些字元之後,IME可能需要提供給使用者一些可用的候選詞的列表。這個視圖的管理和輸入視圖不大一樣,因為這個視圖是非常的短暫的,它只是在有候選詞的時候才會被顯示。可以用setCandidatesViewShow()來設定是否需要顯示這個視圖。正是因為這個顯示的頻繁性,所以它一般不會被銷毀,而且不會改變當前應用程式的視圖。
最後,關於文本的產生,這是一個IME的最終目的。它通過InputConnection來連結IME和應用程式的:能夠直接產生想要的按鍵資訊,甚至直接在候選和提交的文本中編輯。當使用者在不同的輸入目標之間切換的時候,IME會不斷的調用onFinishInput() 和 onStartInput()。在這兩個函數中,需要反覆做的就是複位狀態,並且應對新的輸入框的資訊。
以上是一個IME的最基本的介紹,下面將根據Sample中的SoftKeyboard來說明這些問題。
二、建立Eclipse
工程
這裡使用最新版本的Android SDK 2.3.3下的SoftKeyboard Sample來建立工程,其實,從1.5版本,該Sample就已經存在了。同時,由於SoftKeyboard會使人誤解為KeyBoard的子類,這裡特別改名為InputMethodServiceSample,更符合其功能和特性。
點擊Finish,完成項目的建立,可以看到項目工程結構如下:
在Android SDK 2.3.3模擬器上運行本Sample,需要在Setting中選擇使用本Sample,需要在Language&keyboard中選中本Sample的名稱。
當嘗試選中Sample Soft Keyboard時,Android會出現安全提示。IME的確要選擇自己信任的,因為它可以收集和記錄所有你的輸入,這個特性如果被有心人利用會很恐怖。
選中Sample Soft Keyboard作為我們的IME之後,進入需要IME的地方,這裡以簡訊介面作為範例,在輸入框中長按,會出現“編輯文本”選單,點擊“IME”即可進入當前輸入介面的IME選擇框。就可以使用IME切換到本IME看到它的keyboard。
之後就可以看到Soft keyboard鍵盤如下:
三、配置和資源檔解析
除去原始碼將在後文統一分析之外,這裡介紹下配置和資源檔。
1. AndroidMainifest.xml
每個Android應用都會有的配置描述檔案。在這裡,Sample把自己聲明成了服務,而且綁定在了IME之上。它的intent-filter是直接用的InputMethod介面,這也是所有的IME的介面。
2. res
目錄
放置resource,即資源檔,裡面蠻多東西的,具體如下。
(1) drawable目錄,放置的是表徵圖檔案。
(2) values目錄,包含strings.xml以及一些自訂的類型和值的xml檔案。
strings.xml
― ime_name 定義了該IME的名字
― word_separators 詞的分隔字元,即輸入過程中可能用來表示一個詞輸入完成的符號,比如空格,標點等等)
― label_xx_key 為軟鍵盤定義確認鍵的標籤。在後面代碼解析中可以看到,程式會根據輸入框的資訊來設定EnterKey的表徵圖或者標籤。如:在一個網址上面輸入,就會顯示一個搜尋的表徵圖,而在編輯簡訊時,如果在收信人寫,那麼EnterKey就是Next標籤,用來直接跳到簡訊本文部分。
dimens.xml,定義軟鍵盤的尺寸資訊,包括鍵高(key_height),候選詞字型的高度(candidate_font_height),候選詞垂直間隙(candidate_vertical_padding)。
color.xml,定義候選詞的背景顏色,比如正常(candidate_normal),推薦(candidate_recommended),背景(candidate_background)和其它(candidate_other)等顏色。
(3) layout目錄,儲存布局設定檔。這裡只有一個設定檔:input.xml,它定義的是輸入視圖的資訊,包括id(android:id="@+id/keyboard"),放置在螢幕下方(android:layout_alignParentBottom="true"),水平最大填充(android:layout_width="match_parent"),垂直包含子內容(android:layout_height="wrap_content")。
(4) xml目錄,檔案如下:
method.xml,為搜尋管理提供配置資訊。
qwerty.xml,英文字元的全鍵盤配置檔案。定義很直觀,很容易就可以看懂。
symbols_shift.xml和symbols.xml,是標點字元的全鍵盤配置檔案。
四、原始碼解析
(一)概述
從InputMethodServiceSample項目可以看出實現一個IME至少需要CandidateView, LatinKeyboard, LatinKeyboardView,SoftKeyboard這四個檔案:
- CandidateView負責顯示軟鍵盤上面的那個候選地區。
- LatinKeyboard負責解析並儲存鍵盤配置,並提供選詞演算法,供程式運行當中使用。其中鍵盤配置是以XML檔案存放在資源當中的。比如我們在漢字IME下,按下b、a兩個字母。LatinKeyboard就負責把這兩個字母變成爸、把、巴等顯示在CandidateView上。
- LatinKeyboardView負責顯示,就是我們看到的按鍵。它與CandidateView合起來,組成了InputView,就是我們看到的軟鍵盤。
- SoftKeyboard繼承了InputMethodService,啟動一個IME,其實就是啟動一個InputMethodService,當SoftKeyboardIME被使用時,啟動就會啟動SoftKeyboard這個Service。
(二)LatinKeyboard.java
軟鍵盤類,直接繼承了Keyboard類,並定義一個xml格式的Keyboard的布局,來實現一個輸入拉丁文的鍵盤。這裡只是建立一個鍵盤對象,並不對具體的布局給出手段。
為了更好的理解LatinKeyboard類,這裡簡單介紹一下Keyboard類。Keyboard可以載入一個用來顯示鍵盤配置的xml來初始化自己,並且可以儲存這些鍵盤的鍵的屬性。他有三個建構函式:
- Keyboard(Context context, int xmlLayoutResId),用語境和xml資源id索引xml檔案來建立。
- Keyboard(Context context, int xmlLayoutResId, int modeId),這個和上面差不多,只不過多了一個modeld。
- Keyboard(Context context, int layoutTemplateResId, CharSequence characters, int columns, int horizontalPadding),這個比較複雜,用一個空xml布局模板建立一個鍵盤,然後用指定的characters按照從左往右,從上往下的方式填滿這個模板。
本檔案源碼前面完全繼承keyboard,直接用了父類建構函式進行初始化。
這裡因為重寫了Keyboard類的createKeyFromXml(Resources res, Row parent, int x, int y, XmlResourceParser parser),為了要返回一個Key對象,乾脆直接建立LatinKey對象好了。從這裡我們能看出物件導向和使用架構的要求。
接著,本檔案重載了一個createKeyFromXml的函數,這是一個回呼函數,它在鍵盤描繪鍵的時候調用,從一個xml資源檔中載入一個鍵,並且放置在(x,y)座標處。它還判斷了該鍵是否是斷行符號鍵,並儲存起來。在這裡,為了要返回一個Key對象,於是直接建立內部類的LatinKey對象。從這裡我們能看出物件導向和使用架構的要求。
此外,還有一個函數是:setImeOptions,它是根據編輯框的當前資訊,來為這個鍵盤的斷行符號鍵設定適當的標籤。輸入框的不同,會產生不同的斷行符號鍵的label或者icon。在這個函數中,有一個技巧是用了一些imeOption的位資訊,比如IME_MASK_ACTION等等。主要是查看的EditorInfo的Action資訊,這裡有:
- IME_ACTION_GO: go操作,將使用者帶入到一個該輸入框的目標的動作。確認鍵將不會有icon,只有label: GO
- IME_ACTION_NEXT: next操作,將使用者帶入到該文字框的寫一個輸入框中。如: 編輯短訊息的時候,內容就是收件者手機號碼框的next文字域。它也只是一個NEXT label就行了。
- IME_ACTION_SEARCH: search操作,預設動作就是搜尋。如: 在URL框中輸入的時候,預設的就是search操作,它提供了一個像放大鏡一樣的icon。
- IME-ACTION_SEND: send操作,預設動作就是發送當前的內容。如: 短訊息的內容框裡面輸入的時候,後面通常就是一個發送操作。它也是只提供一個Label:SEND
- DEFAULT: 預設情況下表示文字框並沒有什麼特殊的要求,所以只需要設定return的icon即可。
最後,它還定義了一個內部類——LatinKey,它直接繼承了Key,來定義一個單獨的鍵,它唯一重載的函數是isInside(int x , int y ),用來判斷一個座標是否在該鍵內。它重載為判斷該鍵是否是CANCEL鍵,如果是則把Y座標減少10px,按照他的解釋是用來還原這個可以關掉鍵盤的鍵的目的地區域。
(三)LatinKeyboardView.java
這裡就是個View,自然也繼承自View,因為前面建立的鍵盤只是一個概念,並不能執行個體出來一個UI,所以需要藉助於一個VIEW類來進行繪製。這個類簡單的繼承了KeyboardView類,然後重載了一個動作方法,就是onLongPress。
它在有長時間按鍵事件的時候會調用,首先判斷這個按鍵是否是CANCEL鍵,如果是的話就通過調用 KeyboardView被安置好的OnKeyboardActionListener對象,給鍵盤發送一個OPTIONS鍵被按下的事件。它是用來屏蔽CANCEL鍵,然後發送了一個未知的代碼的鍵。
(四)CandidateView.java
CandidateView是一個候選字顯示view,它提供一個候選字選擇的視圖,直接繼承於View類即可。在我們輸入字元時,它應該能根據字元顯示一定的提示,比如拼音同音字啊,聯想的字啊之類的。
1.
先看它定義了那些重要變數:
- mService: candidateView的宿主類,即該view是為什麼IME服務的。
- mSuggestions: 建議。比如說當我們輸入一些字母之後IME希望根據輸入來進行聯想建議。
- mSelectedIndex: 使用者選擇的詞的索引。
- mSelectionHighlight: 描繪選擇地區高亮的類。
- mTypedWordValid: 鍵入的word是否合法正確。
- mBgPadding: 背景填充地區。
- mWordWidth: 每個候選詞的寬度。
- mWordX:每個候選詞的X座標。有了這兩個變數,就能夠在螢幕上準確的繪製出該候選索引鍵。
- mColor*:定義了各種顏色。
- mPaint: 一個繪圖類,後面會用到
- mVerticalPadding: 垂直填充地區。
- mTargetScrollX: 目標滾動的橫座標,即要將目標滾動到何處。
- mTotalWidth: 總的寬度
- mGestureDetector: 聲明一個手勢監測器
GestureDetector對象似乎很少見,讓我們瞭解一下android.view.GestureDetector。這是一個與動作事件相關的類,可以用來檢測各種動作事件,這裡稱之為:手勢監測器。它的回呼函數是GestureDetector.OnGestureListener,在動作發生時執行,而且只能在觸摸時發出,用滾動球無效。要使用這個通常要先建立一個對象,如同代碼裡體現的,然後設定GestureDetector.OnGestureListener 同時在 onTouchEvent(MotionEvent)中寫入動作發生要執行的代碼。
2.
建構函式,主要是對一些變數的初始化工作。
首先初始化了mSelectionHighlight,這是一個drawable對象,並利用drawable的setState方法設定這個drawable的初始狀態。同時在res目錄下加入一個color.xml檔案來定義用到的所有顏色資源,然後用R索引,這些資源可以被加入到自己的R.java的內容裡,可以直接引用。 剩下的內容就是初始化背景,選中,未選中時的view的背景顏色,這裡都是在前面color.xml內定義的了。用這樣的方式獲得:
Resources r = context.getResources();
獲得當前資來源物件的方法。
setBackgroundColor(r.getColor(R.color.candidate_background));
然後初始化了一個手勢檢測器(gesturedetector),它的Listener重載了一個方法,就是onScroll,這個類是手勢檢測器發現有scroll動作的時候觸發。在這個函數裡,主要是進行滑動的判斷。
這裡用到了很多view下的方法:getScrollX();getWidth();scrollTo(sx, getScrollY());invalidate();我們分別解釋如下:
- getScrollX():獲得滾動後view的橫座標
- scrollTo():滾動到目標座標
- getScrollY():獲得滾動後view的縱座標
- invalidate():使view重畫
在這裡,distanceX是上次調用onscroll後滾動的X軸距離。假設這個view之前沒有被滾動過,第一次滾動且座標在顯示地區內,sx=getScrollX()+distanceX,則view就scrollTo這個位置。如果sx超過了最大顯示寬度,則scrollTo就滾想原先sx處,也就是不動。也就是說:系統滾動產生一個慣性的感覺,當你把view實際到了X座標點,系統再給你加一個distanceX,這個distanceX不是兩個動作之間的距離,應該是上一個滾動動作的停止點和本次滾動動作的停止點之間的距離,這個距離系統自己算,我們不用管,只要到了最大邊界,view就不再滾動,或者說是原地滾動。
接下來:
- setHorizontalFadingEdgeEnabled(true);// 設定view在水平滾動時,水平邊是否淡出。
- setWillNotDraw(false);// view不自己繪製自己
- setHorizontalScrollBarEnabled(false);// 不設定水平捲軸
- setVerticalScrollBarEnabled(false);// 不設定垂直捲軸
3. setService
是設定宿主IME。
4. computeHorizontalScrollRange
,表示這個view的水平捲動區域,返回的是候選視圖的總體寬度。
5. onMeasure
,重載自view類,在布局階段被父視圖所調用。比如當父視圖需要根據其子視圖的大小來進行布局時,就需要回調這個函數來看該view的大小。當調用這個函數時必須在內部調用setMeasureDimension來對寬和高進行儲存,否則將會有異常出現。這裡重載它是為了系統檢測要繪製的字元區的大小,因為字型可能有大小,應根據字型來。它首先計算自己的期望的寬度,調用resolveSize來看是否能夠得到50px的寬度;然後是計算想要的高度,根據字型和顯示提示區的padding來確定。
6. onDraw
,view的主要函數,每個view都必須重寫這個函數來繪製自己。它提供了一塊畫布,如果為空白,則直接調用父類來畫。
在這裡的內部邏輯大概如下:
判斷是否有候選詞,沒有的話就不用繪製。
初始化背景的填充地區,直接view的背景中得到即可。
對於每一個候選詞,得到其文本,然後計算其寬度,然後再加上兩邊的空隙。
判斷是否選擇了當前詞:觸摸的位置+滾動了的位置。如果是在當前詞的左邊到右邊之間,則將高亮地區繪製在畫布上面,高亮地區設定的大小即為當前詞的大小,並且儲存被選詞的索引。
將文本繪製在這個候選詞的畫布上面,它進行了一個判斷,判斷哪個才是推薦詞。預設情況下是候選詞的第一個詞,但是它判斷第一個詞是否是合法的,如果是,則第一個詞是候選詞,否者第二個詞才是候選粗,然後進行繪製。
繪製一條線,來分割各個候選詞。上面提到的總共的寬度在所有的詞都繪製出來之後,就能夠得到了。
判斷目標滾動是否是當前的,不是就需要滾動過去。
7. scrollToTarget
,滾到到目的地區域。得到當前值,然後加上一個滾動距離,看是否超過並進行相應調整,之後滾動到相應座標。
8. setSuggestions
,設定候選詞,之後進行繪製。
9. onTouchEvent
,觸摸事件產生時調用。首先判斷是否為gesturedetector監聽的動作,如果不是就進行下面處理。初始化動作,把發生的動作記錄下來,點觸的座標也記錄下來。然後,根據動作類型分類反應:
- 向下:沒動作;
- 移動:如果是向左移動就要手動的選擇候選詞;
- 向上:需要手動選擇候選詞。
10. takeSuggestionAt
,選擇在座標x處的詞,這個處理的是使用者輕輕點擊鍵盤,也就是選擇候選詞。
11. removeHighlight
,去除高亮顯示。
(五)SoftKeyboard.java
整個IME的總體的架構,包括什麼時候建立,什麼時候顯示IME,和怎樣和文字框進行通訊等等。上面的檔案,都是為了這個類服務的。總體來說,一個IME需要的是一個輸入視圖,一個候選詞視圖,還有一個就是和應用程式的連結。
基本時序圖如下:
IME在Android中的本質就是一個Service,假設使用者剛剛啟動Android,使用者移動焦點首次進入文本編輯框時,Android便會通知Service開始進行初始化工作。於是便有了中的一系列動作。
追根溯源,onCreate方法繼承至Service類,其意義和其他Service的是一樣的。Sample在這裡,做了一些非UI方面的初始化,即字串變數詞彙分隔字元的初始化。
接下來執行onInitializeInterface,這裡是進行UI初始化的地方,建立以後和配置修改以後,都會調用這個方法。Sample在這裡對Keyboard進行了初始化,從XML檔案中讀取軟鍵盤資訊,封裝進Keyboard對象。
第三個執行的就是onStartInput方法,在這裡,我們被綁定到了用戶端,接收所有關於編輯對象的詳細資料。
第四個執行的方法是onCreateInputView,在使用者輸入的地區要顯示時,這個方法由架構調用,IME首次顯示時,或者配置資訊改變時,該方法就會被執行。在該方法中,對inputview進行初始化:讀取布局檔案資訊,設定onKeyboardActionListener,並初始設定 keyboard。
第五個方法是onCreateCandidatesView,在要顯示候選詞彙的視圖時,由架構調用。和onCreateInputView類似。在這個方式中,對candidateview 進行初始化。
第六個方法,也是最後一個方法,即onStartInputView,正是在這個方法中,將inputview和當前keyboard重新關聯起來。
在上面的六個方法中,onCreateInputView和onCreateCandidatesView兩個方法只有在初始化時才會執行一次,除非有配置資訊發生改變。那麼究竟什麼是配置資訊發生改變呢?在看InputMethodService的API文檔時,可以看到有一個方法onConfigurationChanged,根據文檔解釋,這個方法主要負責配置更改的情況。在樣本中,其沒有override這個方法,但是在android源碼包中的PinyinIME中,有使用這個方法,有興趣的朋友可以在看完SoftKeyboard Sample之後,看看PinyinIME的源碼。
關於本類中其它的一些方法,由於比較直觀,就不進行講解了,感興趣的朋友可以參考《android sdk中 softkeyboard的自己解析(4)
》。
五、IME調試
通過使用偵錯模式加斷點的方式,有助於我們更好的理解IME的時序和每個類及其方法的功能和調用持續。
這裡使用Eclipse的DDMS透視圖進行調試,具體介紹參考《用Eclipse開發和調試Android應用程式
》
首先切換到DDMS模式,在這個模式下面,DDMS將連結到正在啟動並執行手機或模擬器,並且能夠提取手機上面的各種資訊,比如線程,還有各個正在後台啟動並執行服務等等。點擊工具條上的“Debug selected Process”,就能夠將調試器植入到這個服務上面。
之後切換到debug模式,就會發現調試器已經連結到了這個模擬器,然後就可以像調試普通的程式一樣調試這個IME了。
通過debug模式,我們可以發現,IME首先執行的onCreateInputView-> onCreateCandidatesView,而在這個時候,這個IME的介面一點兒都還沒有顯現出來。當我們在一個輸入框中點擊滑鼠時,系統會產生一個事件,最開始就被IME捕獲,然後再將控制權交給這個IME。另外,切換對象的時候,IME總是認為是一次輸入的結束,然後進行一系列的reset工作。所有的鍵盤等事件,都會首先傳遞給IME,所以,如果一個按鍵事件不是我們所能夠處理的問題,我們需要將這個事件繼續傳遞下去,而不要丟棄了,因為這可能是別的控制項的事情。
在發送訊息的介面,在輸入完TO某人之後,點擊content輸入框,首先調用的是onFinishInput,也就是結束上一次的輸入,準備這次的輸入。之後調用的是onStartInputView,讓介面顯示出來。接著調用onStartInput,表示開始正式的輸入。在這過程中,要完成根據不同的輸入框,選擇不同的鍵盤,當你輸入一個鍵,首先觸發的是onKey回調,在這裡要判斷是輸入的一般字元,還是控制性的字元,比如刪除,返回等等。比如這裡輸入一個 'g',然後會調用處理一般字元的函數handleCharacter。這裡的策略就是,輸入一個一般字元,就將Composing增加,並且更新這個候選詞的列表。這裡有一個很微妙的開關,就是mPrediction,它就是判斷是否是需要儲存這個Composing。在比如說URL框中輸入的時候,就會置這個開關為關,直接將鍵入的輸入到文字框中去。
為了測試所有的函數,你必須想出一種輸入方式,讓每個函數你都能執行到,那你就能夠看清楚IME的本來面目。
請各位朋友自己試試,對閱讀和理解原始碼的流程、時序和生命週期很有好處。也可以方便的找到自己的代碼的bug。
六、IME的調用
希望從一個View上調用IME和接收IME傳過來的字串,可以通過調用EditText這個widget。但是,如果要做出很炫很個性的IME,就必須自己去和EditText一樣串連IME,介紹如下:
首先,定義一個繼承自BaseInputConnection的類。前文提到過,IME是通過commitText來提交選中字元。
public class MyBaseInputConnection extends BaseInputConnection{
public MyBaseInputConnection(View targetView, boolean fullEditor) {
super(targetView, fullEditor);
}
public static String tx="";
//IME程式就是通過調用這個方法把最終結果輸出來的
@Override
public boolean commitText(CharSequence text, int newCursorPosition) {
tx = text.toString();
return true;
}
}
BaseInputConnection相當於一個InputMethodService和View之間的一個通道。每當InputMethodService產生一個結果時,都會調用BaseInputConnection的commitText方法,把結果傳遞出來。
之後,採用如下方式,呼出IME,並且把自訂的BaseInputConnection通道傳遞給InputMethodService。
public class MyView extends XXView ...{
//得到InputMethodManager
InputMethodManager input = (InputMethodManager) context.getSystemService(Context.INPUT_METHOD_SERVICE);
//定義事件處理器
ResultReceiver receiver = new ResultReceiver(new Handler() {
public void handleMessage(Message msg) {
}
});
...
//在你想呼出IME的時候,調用這一句
input.showSoftInput(this, 0, mRR);
...
@Override
//這個方法繼承自View。把自訂的BaseInputConnection通道傳遞給InputMethodService
public InputConnection onCreateInputConnection(EditorInfo outAttrs) {
return new MyBaseInputConnection(this, false);
}
}
低級介面上面,自己調用IME並接收IME的輸出結果,就是這樣的。
更多相關文章,請訪問:
http://blog.sina.com.cn/deaboway
http://blog.csdn.net/deaboway
以上兩個blog同步更新。