Neste tutorial, você instala e configura o método de entrada Sogou Pinyin (Fcitx 4 com Sogou Pinyin Linux 4.2.1.145) em um desktop Ubuntu executado no Elastic Desktop Service. Dois caminhos são abordados: uma configuração para usuário único na sua própria instância e uma configuração de imagem de sistema que administradores ou construtores de imagem usam para pré-instalar o Sogou Pinyin para cada usuário provisionado a partir da imagem.
Como a configuração funciona
A entrada de chinês em um desktop Ubuntu é fornecida por duas camadas que cooperam:
Fcitx 4, o framework de método de entrada. O Fcitx 4 fornece os módulos de método de entrada GTK, Qt e X11, as variáveis de ambiente
GTK_IM_MODULE,QT_IM_MODULEeXMODIFIERS, e o processo de runtime que direciona as teclas pressionadas para os engines de método de entrada.Sogou Pinyin Linux 4.2.1.145, o engine de método de entrada. O Sogou Pinyin se conecta ao Fcitx como engine e depende das bibliotecas Qt Quick, incluindo
libQt5QuickWidgets.so.5e os módulos QML relacionados.Essa divisão de trabalho é o motivo pelo qual cada caminho instala tanto o meta-pacotefcitxquanto um conjunto de pacotes Qt e QML, verifica se alibQt5QuickWidgets.so.5está registrada no sistema e, em seguida, altera o framework de método de entrada para Fcitx para que as variáveis de ambiente sejam carregadas na sessão do desktop.
Escopo e caminhos
Este tutorial se aplica ao seguinte ambiente:
Sistema operacional — Ubuntu 20.04, 22.04 e 24.04 Desktop.
Tipo de sessão — sessão X11. As variáveis de ambiente do Fcitx 4 (
GTK_IM_MODULE,QT_IM_MODULE,XMODIFIERS) são carregadas por uma sessão de desktop X11.Arquitetura — amd64.
Versões de software — Sogou Pinyin Linux 4.2.1.145 no Fcitx 4.Dois caminhos estão disponíveis. Escolha um antes de começar.
|
Caminho |
Público |
Escopo de efeito |
Privilégio |
Reinicializações |
|
Caminho A: Configuração para usuário único |
Um usuário de desktop Ubuntu configurando o Sogou Pinyin para uso pessoal em uma instância do Elastic Desktop Service. |
Configuração no escopo do usuário em |
Requer |
Duas reinicializações completas da instância do Elastic Desktop Service. |
|
Caminho B: Configuração de imagem de sistema |
Um administrador ou construtor de imagem preparando uma imagem para distribuir a vários usuários. |
Framework de método de entrada padrão em todo o sistema, além de um modelo |
Requer |
Duas reinicializações completas da instância de compilação. |
Pré-requisitos
Confirme todos os itens a seguir antes de começar:
Uma instância do Elastic Desktop Service que atenda ao ambiente descrito em Escopo e caminhos. Apenas sessões X11 são suportadas. O Wayland não é abordado neste tutorial.
-
A conta que você usa na instância:
Para o Caminho A, uma conta de usuário regular com privilégios
sudo.Para o Caminho B,
rootna instância de compilação de imagem e um usuário de desktop não root para a etapa de configuração gráfica do Fcitx.
Acesso à rede a partir da instância para a página oficial de download do Sogou Pinyin Linux, ou uma forma de transferir o pacote
.debpara a instância. O pacote necessário ésogoupinyin_4.2.1.145_amd64.deb. Baixe-o na página de download do Sogou Pinyin Linux.Para o Caminho B, o pacote
.debcopiado para um caminho conhecido na instância de compilação. Este tutorial referencia esse caminho como/path/to/sogoupinyin_4.2.1.145_amd64.deb.
Sobre as reinicializações necessárias
Ambos os caminhos dependem do Ubuntu recarregar as variáveis de ambiente do método de entrada e as configurações do dconf e do GNOME relacionadas ao Fcitx nos limites da sessão. Portanto, cada caminho requer duas reinicializações completas da instância do Elastic Desktop Service:
A primeira reinicialização ocorre após definir o Fcitx como o framework de método de entrada.
A segunda reinicialização ocorre após concluir a configuração gráfica do Fcitx e a limpeza de configurações legadas.Reinicialize por um dos seguintes pontos de entrada:
Restart no botão flutuante do Elastic Desktop Service no desktop.
Restart no cartão da instância do Elastic Desktop Service no cliente.Salve seu trabalho antes de cada reinicialização. As etapas exatas de reinicialização são indicadas no Caminho A e no Caminho B.
Caminho A: Configurar o Sogou Pinyin para um único usuário
Siga este caminho para instalar e configurar o Sogou Pinyin na sua própria conta em uma instância do Elastic Desktop Service. Este caminho afeta apenas a configuração do método de entrada Fcitx e X do usuário atual em ~/.xinputrc e ~/.config/fcitx/, mas também instala pacotes do sistema e edita arquivos em /etc/, que se aplicam a toda a instância.
Instalar o Fcitx e o Sogou Pinyin
-
Baixe o pacote
.debdo Sogou Pinyin. Abra a página de download do Sogou Pinyin Linux na sua instância ou em uma máquina local e obtenha o pacote Debian amd64:sogoupinyin_4.2.1.145_amd64.deb -
Instale o Fcitx e as dependências de runtime do Sogou. Execute os seguintes comandos como seu usuário regular:
sudo apt update sudo apt install -y --install-recommends \ fcitx \ libqt5qml5 \ libqt5quick5 \ libqt5quickwidgets5 \ qml-module-qtquick2 \ libgsettings-qt1O meta-pacote
fcitxinclui o programa principal, as interfaces GTK e Qt, a ferramenta de configuração, a Classic UI e oim-config. -
Acesse o diretório que contém o pacote
.debbaixado e instale o Sogou Pinyin:sudo apt install -y ./sogoupinyin_4.2.1.145_amd64.deb -
Verifique se a biblioteca Qt Quick Widgets exigida pelo Sogou Pinyin está registrada no sistema:
ldconfig -p | grep libQt5QuickWidgets.so.5
Definir o Fcitx como o framework de método de entrada
Execute os seguintes comandos como seu usuário regular não root. Não use sudo para o im-config.
-
Selecione o Fcitx como o framework:
im-config -n fcitx -
Verifique se a configuração no nível do usuário foi gravada:
cat ~/.xinputrc
run_im fcitx Salve seu trabalho em quaisquer aplicativos abertos e execute a primeira reinicialização da instância do Elastic Desktop Service por um dos pontos de entrada listados em Sobre as reinicializações necessárias. Apenas uma nova sessão de desktop carrega as variáveis de ambiente GTK, Qt e
XMODIFIERSdo Fcitx.
Adicionar o Sogou Pinyin na ferramenta de configuração do Fcitx
Após a primeira reinicialização trazer você de volta ao desktop, inicie a ferramenta de configuração do Fcitx:
fcitx-config-gtk3
-
Na página Input Method, adicione o Sogou Pinyin.
Se o desktop atual não estiver usando um locale chinês, na caixa de diálogo Add input method desmarque a caixa de seleção Only Show Current Language, pesquise por
sogoue selecione sogoupinyin nos resultados.sogoupinyiné o identificador de método de entrada do Fcitx para o Sogou Pinyin. Na página Global Config, defina Share State Among Window como All para que o estado de entrada seja compartilhado entre os aplicativos.
Feche a ferramenta de configuração do Fcitx.
Limpar configurações legadas do GNOME e do dconf
Conclua esta limpeza antes da segunda reinicialização. Verifique cada um dos seguintes arquivos e exclua a linha especificada somente se ela estiver realmente presente.
-
Verifique o
/etc/profile. Se a seguinte linha existir, exclua a linha inteira:gsettings set org.gnome.desktop.input-sources sources "[('xkb', 'us'), ('ibus', 'libpinyin'), ('ibus', 'mozc-jp')]" -
Verifique o
/etc/dconf/db/local.d/00-gnome-settings. Se a seguinte linha existir, exclua a linha inteira:disabled-extensions=['ubuntu-appindicators@ubuntu.com'] -
Se você modificou o arquivo dconf, regenere o banco de dados dconf do sistema:
sudo dconf update
Reiniciar e verificar
Salve seu trabalho e execute a segunda reinicialização da instância do Elastic Desktop Service por um dos pontos de entrada listados em Sobre as reinicializações necessárias.
-
Após a reinicialização trazer você de volta à sessão do desktop, abra um terminal e verifique as variáveis de ambiente do método de entrada:
env | grep -E '^(GTK_IM_MODULE|QT_IM_MODULE|XMODIFIERS)='
GTK_IM_MODULE=fcitx QT_IM_MODULE=fcitx XMODIFIERS=@im=fcitx -
Verifique os processos do Fcitx e do Sogou Pinyin e o estado do método de entrada:
pgrep -a -f 'fcitx|sogoupinyin' fcitx-remote -o fcitx-remote -s sogoupinyin fcitx-remoteO comando
fcitx-remoteretorna2, que indica que o método de entrada está ativo.O Caminho A está concluído. Você não precisa continuar para o Caminho B.
Caminho B: Preparar uma imagem de sistema com o Sogou Pinyin pré-instalado
Siga este caminho se você é um administrador ou construtor de imagem que precisa pré-instalar o Fcitx e o Sogou Pinyin em uma imagem do Elastic Desktop Service. A imagem define um framework de método de entrada padrão em todo o sistema e usa o /etc/skel para fornecer a cada usuário recém-provisionado a mesma configuração padrão do Fcitx. Os usuários existentes em uma imagem mantêm suas próprias configurações em ~/.config/fcitx/.
Instalar pacotes em todo o sistema
Execute os seguintes comandos como root na instância de compilação.
-
Instale o Fcitx e as dependências de runtime do Sogou de forma não interativa:
apt-get update DEBIAN_FRONTEND=noninteractive apt-get install -y --install-recommends \ fcitx \ libqt5qml5 \ libqt5quick5 \ libqt5quickwidgets5 \ qml-module-qtquick2 \ libgsettings-qt1 -
Instale o pacote
.debdo Sogou Pinyin a partir do caminho onde você o colocou:apt-get install -y /path/to/sogoupinyin_4.2.1.145_amd64.deb
Definir o framework de método de entrada padrão do sistema
-
Defina o Fcitx como o padrão do sistema:
sudo im-config -n fcitx
/etc/X11/xinit/xinputrc. -
Verifique:
grep run_im /etc/X11/xinit/xinputrc
run_im fcitxOs usuários com
~/.xinputrcherdam essa configuração no nível do sistema. Os usuários que já possuem sua própria configuração continuam usando o framework de método de entrada de sua escolha. Execute a primeira reinicialização da instância de compilação por um dos pontos de entrada listados em Sobre as reinicializações necessárias. Quando a sessão de desktop X11 estiver de volta, continue com a configuração gráfica do Fcitx.
Configurar o comportamento padrão do Fcitx e copiá-lo para o modelo de novo usuário
A configuração gráfica deve ser executada como um usuário de desktop regular não root, para que você possa capturar a configuração do Fcitx no nível do usuário resultante e copiá-la para o /etc/skel.
-
Inicie a ferramenta de configuração do Fcitx a partir do terminal do usuário de desktop:
fcitx-config-gtk3 -
Configure o seguinte na interface gráfica:
Na página Input Method, mantenha a entrada de teclado em inglês e adicione o Sogou Pinyin.
Na mesma página, organize a lista para que o teclado em inglês seja o primeiro e o Sogou Pinyin seja o segundo.
Na página Global Config, defina Share State Among Window como All.
-
Feche a ferramenta de configuração do Fcitx e copie a configuração do Fcitx do usuário atual para o modelo de novo usuário:
sudo install -d -m 0755 /etc/skel/.config/fcitx sudo install -m 0644 ~/.config/fcitx/config \ /etc/skel/.config/fcitx/config sudo install -m 0644 ~/.config/fcitx/profile \ /etc/skel/.config/fcitx/profile
O teclado em inglês e o Sogou Pinyin são adicionados à lista de métodos de entrada do Fcitx.
O estado de entrada é compartilhado entre os aplicativos.
Ctrl+Spaceestá vinculado à alternância do Fcitx, que muda para o Sogou Pinyin.O/etc/skelse aplica apenas a usuários recém-criados. Os usuários existentes continuam usando sua própria configuração em~/.config/fcitx/.
Limpar configurações legadas do GNOME e do dconf na imagem
Conclua esta limpeza antes da segunda reinicialização. Verifique cada um dos seguintes arquivos e exclua a linha especificada somente se ela estiver realmente presente.
-
Verifique o
/etc/profile. Se a seguinte linha existir, exclua a linha inteira:gsettings set org.gnome.desktop.input-sources sources "[('xkb', 'us'), ('ibus', 'libpinyin'), ('ibus', 'mozc-jp')]" -
Verifique o
/etc/dconf/db/local.d/00-gnome-settings. Se a seguinte linha existir, exclua a linha inteira:disabled-extensions=['ubuntu-appindicators@ubuntu.com'] -
Se você modificou o arquivo dconf, regenere o banco de dados dconf do sistema:
sudo dconf update
Após a limpeza, a sessão do Ubuntu mantém o comportamento padrão do AppIndicator, e as fontes de entrada são totalmente gerenciadas pelo Fcitx e pela configuração no nível do usuário.
Reiniciar e verificar em uma nova sessão de desktop
Após concluir a instalação de pacotes, a configuração gráfica do Fcitx, a cópia do modelo
/etc/skele a limpeza de configurações legadas, salve seu trabalho e execute a segunda reinicialização da instância de compilação por um dos pontos de entrada listados em Sobre as reinicializações necessárias.-
Quando a sessão de desktop X11 estiver de volta, faça logon como um usuário regular e execute os seguintes comandos de verificação em um terminal:
env | grep -E '^(GTK_IM_MODULE|QT_IM_MODULE|XMODIFIERS)=' pgrep -a -f 'fcitx|sogoupinyin' fcitx-diagnose fcitx-remote -o fcitx-remote -
Confirme se todos os seguintes critérios de aceitação são atendidos:
/etc/skelfcitx-config-gtk3GTK_IM_MODULE=fcitx.QT_IM_MODULE=fcitx.XMODIFIERS=@im=fcitx.A lista de métodos de entrada do Fcitx contém
fcitx-keyboard-usesogoupinyin.fcitx-remoteretorna2quando o método de entrada está ativo.O estado do método de entrada é preservado quando você alterna entre aplicativos.
A imagem está pronta para empacotamento e distribuição pelo fluxo de trabalho de imagem do Elastic Desktop Service. Os usuários provisionados a partir da imagem herdam a configuração padrão do Fcitx do
e podem ajustar suas próprias preferências pelo
após o logon.
Considerações sobre custos e versões
Sem cobranças adicionais da Alibaba Cloud. Esta configuração não introduz cobranças adicionais da Alibaba Cloud. Apenas o custo da instância subjacente do Elastic Desktop Service se aplica. O Sogou Pinyin Linux 4.2.1.145 é um pacote gratuito de terceiros.
Vinculação de versão de terceiros. O Sogou Pinyin 4.2.1.145 é validado com o Fcitx 4. Após atualizar qualquer um dos componentes, revalide este fluxo de configuração em uma instância de teste antes de implantar.
Tempo de reinicialização. Ambos os caminhos requerem as duas reinicializações descritas em Sobre as reinicializações necessárias. Ignorar qualquer uma das reinicializações deixa as variáveis de ambiente do método de entrada ou o estado do dconf em uma condição inconsistente e impede a ativação do Sogou Pinyin.
A configuração de usuários existentes é preservada. No Caminho B, o
/etc/skelse aplica apenas a usuários recém-criados. Os usuários existentes devem reconfigurar seus próprios métodos de entrada se quiserem adotar os novos padrões.
Referências
Página de download do Sogou Pinyin Linux — fonte oficial do pacote
sogoupinyin_4.2.1.145_amd64.deb.Documentação do projeto Fcitx 4 — consulte o projeto upstream para configuração avançada do Fcitx.
Página de manual do
im-configdo Ubuntu — executeman im-configna sua instância para detalhes sobre a semântica de alternância.