Android Studio中自定义键盘无法显示的问题排查及指定功能实现咨询

阿华AIGC实验室

2026-4-2

我目前正在学习开发Android应用，现在做一个基础自定义键盘项目——基于Android Studio Narwhal-3的Empty Views Activity，用Java和XML开发，需求明确如下：

无大写切换功能（不设置Shift键）
不支持字母/符号键盘切换，仅显示「顶部数字行+下方字母行」，完全排除$、%、^、@这类特殊符号
整个键盘及按键背景设为绿色，按键带白色边框（主要用来验证自定义颜色的实现方法）

下面是我目前写出的各核心文件代码，以及相关说明：

MainActivity 代码

package com.example.myapplication;

import android.os.Bundle;
import androidx.activity.EdgeToEdge;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.graphics.Insets;
import androidx.core.view.ViewCompat;
import androidx.core.view.WindowInsetsCompat;

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        EdgeToEdge.enable(this);
        setContentView(R.layout.activity_main);
        ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main), (v, insets) -> {
            Insets systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars());
            v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom);
            return insets;
        });
    }
}

MyKeyboardService 代码

这是自定义输入法的核心服务类，负责键盘的初始化和按键事件处理：

package com.example.myapplication;

import android.inputmethodservice.InputMethodService;
import android.inputmethodservice.Keyboard;
import android.inputmethodservice.KeyboardView;
import android.view.View;
import android.view.inputmethod.InputConnection;

public class MyKeyboardService extends InputMethodService implements KeyboardView.OnKeyboardActionListener {
    private KeyboardView kv;
    private Keyboard keyboard;

    @Override
    public View onCreateInputView() {
        View v = getLayoutInflater().inflate(R.layout.keyboard_view, null);
        kv = v.findViewById(R.id.keyboard);
        keyboard = new Keyboard(this, R.xml.simple_keyboard);
        kv.setKeyboard(keyboard);
        kv.setOnKeyboardActionListener(this);
        // 禁用按键上方的预览弹窗
        kv.setPreviewEnabled(false);
        return v;
    }

    @Override
    public void onKey(int primaryCode, int[] keyCodes) {
        InputConnection ic = getCurrentInputConnection();
        if (ic == null) return;

        // 处理删除、回车、空格这类特殊按键
        if (primaryCode == Keyboard.KEYCODE_DELETE) {
            ic.deleteSurroundingText(1, 0);
            return;
        } else if (primaryCode == 10) { // 回车键/换行
            ic.commitText("\n", 1);
            return;
        } else if (primaryCode == 32) { // 空格键
            ic.commitText(" ", 1);
            return;
        }

        // 强制输入字母为小写，符合需求
        char c = (char) primaryCode;
        if (Character.isLetter(c)) {
            ic.commitText(String.valueOf(Character.toLowerCase(c)), 1);
        } else if (Character.isDigit(c)) {
            ic.commitText(String.valueOf(c), 1);
        }
    }

    @Override
    public void onPress(int primaryCode) {}
    @Override
    public void onRelease(int primaryCode) {}
    @Override
    public void onText(CharSequence text) {}
    @Override
    public void swipeLeft() {}
    @Override
    public void swipeRight() {}
    @Override
    public void swipeDown() {}
    @Override
    public void swipeUp() {}
}

AndroidManifest.xml 配置

已注册输入法服务，添加了必要的权限和声明：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="com.example.myapplication">

    <application
        android:allowBackup="true"
        android:dataExtractionRules="@xml/data_extraction_rules"
        android:fullBackupContent="@xml/backup_rules"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.MyApplication">
        <activity
            android:name=".MainActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <service
            android:name=".MyKeyboardService"
            android:label="@string/app_name"
            android:permission="android.permission.BIND_INPUT_METHOD"
            android:exported="true">
            <intent-filter>
                <action android:name="android.view.InputMethod" />
            </intent-filter>
            <meta-data
                android:name="android.view.im"
                android:resource="@xml/method" />
        </service>
    </application>
</manifest>

按键背景Drawable：key_background.xml（未完成）

目前仅写出文件开头，还需要补充shape属性来实现绿色背景+白色边框：

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"

其他说明

res\drawable\ic_launcher_background.xml 和 res\drawable\ic_launcher_foreground.xml 是Android Studio自动生成的资源文件，未做修改
还涉及R.layout.keyboard_view（键盘布局容器）、R.xml.simple_keyboard（按键布局定义）、R.xml/method（输入法配置）这几个文件，暂时未提供代码