Todos os produtos
Search
Central de documentação

Elastic Desktop Service:Configurar o método de entrada Sogou Pinyin

Última atualização: Nov 03, 2026

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_MODULE e XMODIFIERS, 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.5 e os módulos QML relacionados.Essa divisão de trabalho é o motivo pelo qual cada caminho instala tanto o meta-pacote fcitx quanto um conjunto de pacotes Qt e QML, verifica se a libQt5QuickWidgets.so.5 está 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 ~/.xinputrc e ~/.config/fcitx/. O caminho também instala pacotes do sistema e edita arquivos do sistema em /etc/, que afetam toda a instância.

Requer sudo na instância de destino.

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 /etc/skel que os usuários recém-criados herdam. Os usuários existentes mantêm suas próprias configurações em ~/.config/fcitx/.

Requer root na instância de compilação.

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, root na 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 .deb para 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 .deb copiado 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

  1. Baixe o pacote .deb do 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
  2. 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 fcitx inclui o programa principal, as interfaces GTK e Qt, a ferramenta de configuração, a Classic UI e o im-config.

  3. Acesse o diretório que contém o pacote .deb baixado e instale o Sogou Pinyin:

    sudo apt install -y ./sogoupinyin_4.2.1.145_amd64.deb
  4. 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.

  1. Selecione o Fcitx como o framework:

    im-config -n fcitx
  2. Verifique se a configuração no nível do usuário foi gravada:

    cat ~/.xinputrc

    run_im fcitx
  3. 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 XMODIFIERS do 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
  1. 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 sogou e selecione sogoupinyin nos resultados. sogoupinyin é o identificador de método de entrada do Fcitx para o Sogou Pinyin.

  2. Na página Global Config, defina Share State Among Window como All para que o estado de entrada seja compartilhado entre os aplicativos.

  3. 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.

  1. 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')]"
  2. 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']
  3. Se você modificou o arquivo dconf, regenere o banco de dados dconf do sistema:

    sudo dconf update

Reiniciar e verificar

  1. 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.

  2. 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
  3. 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-remote retorna 2, 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.

  1. 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
  2. Instale o pacote .deb do 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

  1. Defina o Fcitx como o padrão do sistema:

    sudo im-config -n fcitx /etc/X11/xinit/xinputrc.

  2. Verifique:

    grep run_im /etc/X11/xinit/xinputrc

    run_im fcitxOs usuários com ~/.xinputrc herdam 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.

  3. 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.

  1. Inicie a ferramenta de configuração do Fcitx a partir do terminal do usuário de desktop:

    fcitx-config-gtk3
  2. 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.

  3. 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+Space está vinculado à alternância do Fcitx, que muda para o Sogou Pinyin.O /etc/skel se 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.

  1. 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')]"
  2. 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']
  3. 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

  1. Após concluir a instalação de pacotes, a configuração gráfica do Fcitx, a cópia do modelo /etc/skel e 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.

  2. 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
  3. Confirme se todos os seguintes critérios de aceitação são atendidos:/etc/skelfcitx-config-gtk3

    • GTK_IM_MODULE=fcitx.

    • QT_IM_MODULE=fcitx.

    • XMODIFIERS=@im=fcitx.

    • A lista de métodos de entrada do Fcitx contém fcitx-keyboard-us e sogoupinyin.

    • fcitx-remote retorna 2 quando 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/skel se 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-config do Ubuntu — execute man im-config na sua instância para detalhes sobre a semântica de alternância.