Go to Qiita Advent Calendar 2024 Top
LoginSignup
4
9

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 3 years have passed since last update.

@Kyome

Xamarin.AndroidでAndroid向けIMEを作る

Last updated at Posted at 2017-09-27

はじめに

Visual Studio 2017 community(2017/9/27時点)のXamarin.Androidを使ってAndroid向けのIME(カスタムキーボード)を作る方法およびコツをまとめます。

1.新規ソリューションを立ち上げる

メニューバーのファイル->新しいソリューションからソリューション立ち上げのモーダルを開きます。
説明1.png
Android -> アプリ -> 空のAndroidアプリを選択して次へを押します。

説明2.png 今回はアプリ名を**DroidCustomKeyboard**にして進めていきます。 説明3.png 設定をいじらず`作成`を押します。

説明4.png
このようにファイルが構成されていればOKです。

2.ファイルの下準備をする。

編集の前に必要なファイルがいくつかありますので先に準備をしてしまいます。

まずはResourcesフォルダに中にxmlフォルダを作ります。
説明5.png

xmlフォルダができたら、さらにその中にXMLファイルを追加します。
説明6.png

説明7.png `XML` -> `空のXMLファイル`を選択して、ファイル名を`method`にして`新規`を押してファイルを追加してください。

同様にしてtest_keyboardというXMLファイルを追加してください。

続いて、layoutフォルダにレイアウトファイルを追加します。
説明8.png

説明9.png `Android` -> `レイアウト`を選択して、ファイル名を`preview`にして`新規`を押してファイルを追加してください。

また、Main.axmlの名前を変更してkeyboard.axmlにします。
説明10.png

同様に、MainActivity.csの名前も変更してTestKeyboard.csにします。
説明11.png

ここまでで、下のようになっていれば下準備はOKです。
説明12.png

3.コーディング１：Strings.xmlに追記

Resources/values/Strings.xmlに一行追記します。

Strings.xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
	<string name="app_name">DroidCustomKeyboard</string>
	<string name="test_keyboard">TestKeyboard</string> <!--追記-->
</resources>

4.コーディング２：keyboard.axmlの書き換え

Resources/layout/keyboard.axmlを書き換えます。
これがいわゆるキーボード全体のビューになります。

keyboard.axml_書き換え前
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />
keyboard.axml_書き換え後
<?xml version="1.0" encoding="utf-8"?>
<android.inputmethodservice.KeyboardView xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/keyboard"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layout_alignParentBottom="true"
    android:keyPreviewLayout="@layout/preview" />

5.コーディング３：preview.axmlの書き換え

Resources/layout/preview.axmlを書き換えます。
このファイルはキーボードのボタンを押した時にキーの上に表示される小さい矩形のレイアウトを担っているようです。

preview.axml書き換え前
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />
preview.axml書き換え後
<?xml version="1.0" encoding="utf-8"?>
<TextView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center"
    android:background="#CFD8DC"
    android:textStyle="bold"
    android:textSize="45sp" />

6.コーディング４：method.xmlを実装

Resources/xml/method.xmlを実装します。
このmethod.xmlがきちんと実装できていないと、Androidの環境設定のIME一覧にキーボードが表示されません。
@string/test_keyboardはvalues/Strings.xml内で定義したものがそのまま呼び出されます。

method.xml
<?xml version="1.0" encoding="UTF-8" ?>
<input-method xmlns:android="http://schemas.android.com/apk/res/android">
    <subtype
        android:label="@string/test_keyboard"
        android:imeSubtypeLocale="en_US"
        android:imeSubtypeMode="keyboard" >
	</subtype>
</input-method>

7.コーディング５：test_keyboard.xmlを実装

Resources/xml/test_keyboard.xml を実装します。
このファイルはキーボードの中身のレイアウトを担います。キーを二段にしたい場合はRowタグを増やせばOKです。
android:codesはAndroidのKeyEventを参考にしてください。

test_keyboard.xml
<?xml version="1.0" encoding="UTF-8" ?>
<Keyboard xmlns:android="http://schemas.android.com/apk/res/android"
    android:keyWidth="25%p"
    android:horizontalGap="0px"
    android:verticalGap="0px"
    android:keyHeight="50sp" >

    <Row>
        <Key android:codes="29" android:keyLabel="A" android:keyEdgeFlags="left" />
        <Key android:codes="30" android:keyLabel="B" />
        <Key android:codes="31" android:keyLabel="C" />
		<Key android:codes="67" android:keyLabel="Del" android:keyEdgeFlags="right" android:isRepeatable="true"/>
    </Row>
	
</Keyboard>

8.コーディング６：TestKeyboard.csの実装(書き換え)

このcsファイルがキーボードの入力システム本体になります。
IMEのサービスとするためにInputMethodServiceを継承したクラスを実装します。

TestKeyboard.cs
using Android.App;
using Android.Content;
using Android.Views;
using Android.Views.InputMethods;
using Android.InputMethodServices;
using Java.Lang;

namespace DroidCustomKeyboard
{

	//チェックポイント１
	[Service(Permission = "android.permission.BIND_INPUT_METHOD")]
	[IntentFilter(new[] { "android.view.InputMethod" })]
	[MetaData("android.view.im", Resource = "@xml/method")]
	public class TestKeyboard : InputMethodService, KeyboardView.IOnKeyboardActionListener
	{
		public KeyboardView kv;
        public Keyboard k;

	    //チェックポイント２
		public override View OnCreateInputView()
		{
            kv = (KeyboardView)this.LayoutInflater.Inflate(Resource.Layout.keyboard, null);
			k = new Keyboard(this, Resource.Xml.test_keyboard);
			kv.Keyboard = k;
			kv.OnKeyboardActionListener = this;
			return kv;
		}

	    //チェックポイント３
		public void OnKey(Android.Views.Keycode primaryCode, Android.Views.Keycode[] keyCodes)
		{
			IInputConnection ic = CurrentInputConnection;

			switch (primaryCode)
			{
                case Android.Views.Keycode.Del:
					ic.DeleteSurroundingText(1, 0);
					break;
				default:
                    if (Android.Views.Keycode.A <= primaryCode && primaryCode <= Android.Views.Keycode.Z)
                    {
                        char code = (char)(primaryCode - Android.Views.Keycode.A + 65);
                        ic.CommitText(new Java.Lang.String(code.ToString()), 1);
                    }
                    else if (Android.Views.Keycode.Num0 <= primaryCode && primaryCode <= Android.Views.Keycode.Num9)
                    {
                        char code = (char)(primaryCode - Android.Views.Keycode.Num0 + 48);
                        ic.CommitText(new Java.Lang.String(code.ToString()), 1);
                    }
					break;
			}
		}

	    //チェックポイント４
		public void OnPress(Android.Views.Keycode primaryCode)
		{ }

		public void OnRelease(Android.Views.Keycode primaryCode)
		{ }

		public void OnText(ICharSequence text)
		{ }

		public void SwipeLeft()
		{ }

		public void SwipeRight()
		{ }

		public void SwipeDown()
		{ }

		public void SwipeUp()
		{ }
	}
}

コードの説明

チェックポイント１

このクラスをIMEのサービスとして認識させるために必要なコードです。これが非常に重要なようで、ブレイクスルーするのが大変でした。Android StudioでIMEを作成する場合はManifestにxml形式で記述するようですが、Xamarin.Androidの場合はこのように直接csファイルに設定を行います。

チェックポイント２

OnCreateInputViewにてキーボードが呼び出された時のキーボードのビューを生成しています。Resource.Layout.keyboardやResource.Xml.test_keyboardで警告が出ないようにするには、一度プロジェクトをビルドする必要があります。（ビルドをするとResource.designer.csファイルに呼び出し用の設定が加わります。）

チェックポイント３

OnKeyにてキーが押された時の反応を記述します。
キーコードが手に入るので、それで動作を分岐させます。普通の文字とDeleteやReturnなどのキーを区別するようにします。注意しなくてはならないのは、AndroidやXamarin.Androidで指定されているKeyCodeはASCIIコードとは異なるので、そのまま文字に変換できないという点です。ASCIIやUnicodeにするためのコードが余計に必要です。

チェックポイント４

InputMethodServiceおよびKeyboardView.IOnKeyboardActionListenerを実装する上で必要な最低限のメソッドたちです。とりわけ何か動作をさせたい場合は実装してあげてください。

6.実行（IMEのインストール）

まずは、プロジェクトの設定を変更します。
メニューバー -> プロジェクト -> DroidCustomKeyboard オプションを押します。
説明13.png

実行 -> 構成 -> Default の中のエントリポイントをサービスにし、明示的インテントのサービスをDroidCustomKeyboard.TestKeyboardにします。
説明14.png

ここで一旦ビルドします。
説明15.png

ビルドが成功したら実行します。

設定アプリ -> 言語と入力 -> 現在のキーボード -> キーボードの選択 -> DroidCustomKeyboard をON
droid1.png

どこか文字入力ができるところでIMEを起動します。
IMEを切り替えたら自作のキーボードが使えます。
droid2.png

7.終わりに

Android Studioと同様の方法でIMEの実装を試みたところ、IMEのインストールに躓きteratailにお世話になりました。
Xamarin.Androidを使ったAndroidアプリ開発はAndroid Studioでの開発に非常に似ているようですが、実行やビルド設定など細かいところで差があったり、使用できるクラスやメソッドに差があったりして意外と厄介でした。
参考文献も異様に少ないので今後ノウハウが蓄積されると良いですね。

4
9
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
4
9

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?