Onde estou: UOL Messenger » Desenvolvendo plugins para o UOL Messenger

Navegação

Desenvolvendo plugins para o UOL Messenger

Nesta página, encontram-se os detalhes da instalação dos plugins no programa UOL Messenger que servirão de exemplo para o desenvolvimento de novos plugins. Outras informações relevantes poderão ser nos encontradas nos comentários dos códigos fonte.

Para desenvolver plugins como esses, é necessário preparar o ambiente. Veja o passo-a-passo de como prepará-lo.

Tutorial de instalação dos plugins de exemplo no UOL Messenger

1. Instalando o código fonte para desenvolvimento dos plugins
  • Baixando os Arquivos Fonte do UOL Messenger:
    • Baixe o arquivo hello-plugins-src.zip.
    • Descompacte o arquivo hello-plugins-src.zip em ${basedir}\, onde ${basedir} é o diretorio base de seu projeto de desenvolvimento de plugin.
    • Será criado, dentro desta pasta, duas outras: \build e \src.
  • Baixando as LIBs:
    • Baixe o arquivo desktop-shared-libs.zip.
    • Descompacte o arquivo desktop-shared-libs.zip em ${desktop-shared-libs-scr}\, onde ${desktop-shared-libs-src} é o diretorio onde os codigos das desktop-shared-libs estão.
    • Será criado, dentro desta pasta, duas outras: \build e \src.
2. Executando os plugins no UOL Messenger
  • Instalando a última versão do UOL Messenger:
  • Configurando o Windows:
    • Acesse "Tools>Folder" Options para abrir a janela de dialogo "Folder Options"
    • Clique na aba "View".
    • Verifique se a opção "Show Hidden Files and Folders" está selecionada.
  • Obtendo os plugins (binários)
    • Baixe o arquivo hello-plugins-DLL.zip
    • Descompacte o arquivo hello-plugins-DLL.zip em ${basedir}\dist.
    • Será criado, dentro desta pasta, três diretórios, cada um para um tipo de plugin, conforme explicado abaixo:
      • O "helloplugin1" ensina como criar um plugin que será instalado em um painel de interface própria dentro do UOL Messenger.
      • O "helloplugin2" ensina como criar um plugin que será instalado como um item adicional da área de ferramentas UOL do UOL Messenger.
      • O "helloplugin3" ensina como criar um plugin para interação com um contato através de uma janela de mensagens.
  • Configurando o plugin no UOL Messenger:
    • Copie o diretório de ${basedir}\dist\hellopluginX (X é o plugin escolhido para você quer instalar) para "C:\Documents and Settings\All Users\Application Data\UOL\UIM\Plugins"
    • Altere o arquivo "C:\Documents and Settings\All Users\Application Data\UOL\UIM\Plugins\localuolmessengerplugins.xml" adicionando a seguinte linha entre as tags <plugins> ... </plugins>:
      • ‹plugin internalname="helloplugin1" pluginFileName="HelloPlugin1.dll" pluginDirname="helloplugin1" /› ‹!--para instalar o plugin 1 --›
      • ‹plugin internalname="helloplugin2" pluginFileName="HelloPlugin2.dll" pluginDirname="helloplugin2" /› ‹!--para instalar o plugin 2 --›
      • ‹plugin internalname="helloplugin3" pluginFileName="HelloPlugin3.dll" pluginDirname="helloplugin3" /› ‹!--para instalar o plugin 3 --›
3. Conclusão da instalação
  • Feche o UOL Messenger e inicie-o novamente.
  • Clique em "Preferências" para abrir a janela "UOL Messenger - Preferências".
    • Clique no ícone "Plugins".
    • Marque a caixa de seleção correspondente ao plugin que deseja testar.
    • Por questoes de compatiblidade, desmarque a caixa de selecao do plugin "Criptografia de Mensagens"
4. Como saber se a instalação foi concluída com sucesso
  • Hello Plugin 1
    • Será acrescentada uma área com a frase "Hello, World 1!", editável na interface principal do UIM.
  • Hello Plugin 2
    • Será adicionado um item na área "Ferramentas UOL" com a frase "Hello, World 2!".
    • Se o item for clicado (duplo clique), o plugin abrirá uma janela com a frase "Hello, World 2!".
  • Hello Plugin 3
    • Dê um duplo clique em algum contato.
    • Verifique na barra superior se aparece um ícone com as iniciais "HW".
    • Clique no ícone e, caso o seu contato também tenha o plugin Hello Plugin 3 instalado, uma mensagem será enviada e aparecerá dentro de uma janela no desktop do seu contato.
      Ao receber a mensagem, o outro contato poderá respondê-la através do plugin "Hello Plugin 3

Glossário
${basedir} é o diretório base de seu projeto de desenvolvimento de plugin.

Atenção! Sua senha é secreta. Nenhum funcionário do UOL está autorizado a solicitá-la.