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 para configurar seu ambiente de desenvolvimento para poder trabalhar com os códigos dos plugins. É necessário utilizar a IDE Microsoft Visual Studio .Net 2003.

Após preparar o ambiente, acesse a página com o Tutorial de instalação dos plugins de exemplo no UOL Messenger para ver os como instalá-los.

Tutorial de configuração do ambiente de desenvolvimento

1. Instalando as dependências e arquivos dos plugins
  • Baixando os Arquivos Fonte dos plugins de exemplo
    • Baixe o arquivo hello-plugins-src.zip.
    • Descompacte o arquivo na pasta ${basedir}, onde ${basedir} é o diretório base de seu projeto de desenvolvimento de plugin.
    • Após a descompactação, dentro desta pasta teremos duas outras: \build e \src.
  • Baixando as LIBs
    • Baixe o arquivo desktop-shared-libs.zip.
    • Descompacte o arquivo na pasta ${desktop-shared-libs-scr}\, onde ${desktop-shared-libs-src} é o diretorio onde os codigos das desktop-shared-libs estão.
    • Após a descompactação, dentro dessa pasta teremos duas outras: \build e \src.
2. Adicionando as variáveis de ambiente
  • Clique em "Start".
  • Clique no ícone "Control Panel", para abrir o painel de controles.
  • Clique no ícone "System" para abrir a janela "System Properties".
  • Acesse a aba "Advanced".
  • Clique no botão "Enviroment Variables".
  • Na primeira janela identificada por "User variables", clique no botão "New".
    • Preencha o campo "Variable name:" com: UOL_SHARED_INCLUDE
    • Preencha o campo "Variable value:" com: ${desktop-shared-libs-src}\src
  • Repita os procedimentos do item anterior adicionando as seguintes variáveis:
    • UOL_SHARED_LIB = ${desktop-shared-libs-src}\build
    • UOL_SHARED_SRC = ${desktop-shared-libs-src}\src
    • _NT_SYMBOL_PATH = srv*${localsymbols}*http://msdl.microsoft.com/download/symbols onde ${localsymbols} é um diretório onde você deseja instalar seus localsymbols.
3. Compilando o projeto
  • Instalando a última versão do UOL Messenger:
  • Abra o seu Microsoft Visual Studio .Net 2003.
  • Abrindo o Projeto dos fontes do UOL Messenger:
    • Acesse o menu File>Open e clique em "Project" para abrir a janela "Open Project".
    • Navegue até o diretorio ${basedir}\scr.
    • Dê um duplo clique no arquivo UIM.sln.
  • Compilando o projeto:
    • Na janela "Solution Explorer" clique no ícone da solução.
    • Acesse o menu 'Build".
    • Clique no item "Configuration Manager".
    • Selecione a opção "Release" no item "Active Solution Configuration".
    • Compilando os plugins:
      •    Clique com o botão direito no projeto "HelloPlugin1".
      •    Clique no item "Build".
    • Repita o passo anterior (compilando os plugins) para os projetos "HelloPlugin2" e "HelloPlugin3".
4. Trabalhando com o projeto de plugins de exemplo
  • Compilando o Projeto:
    • Compile o projeto, como descrito no item 3, alterando os passos 3.4.4 para o seguinte:
      Selecione a opção "Debug" no item "Active Solution Configuration".
    • Siga as instruções na pagina para a correta instalação do UOL Messenger.
    • Renomeie o arquivo C:\Documents and Settings\All Users\Application Data\UOL\UIM\Plugins\helloplugin1\helloplugin1d.dll para helloplugin1.dll.
    • Repita o passo acima para HelloPlugin2 e HelloPlugin3.
  • Execute o UOL Messenger.
  • Anexando o processo ao depurador:
    • Acesse o menu "Tools".
    • Clique no item "Debug Processes" para abrir a janela "Processes".
    • Na lista dentro da janela de um duplo clique em "uimd.exe", isso abrirá a janela "Attach Process".
    • Selecione apenas o campo "Native".
    • Clique em OK.
    • Feche a janela "Processes".
  • Agora utilize o depurador normalmente, adicionando breakpoints etc.

Glossário
${basedir} é o diretório base de seu projeto de desenvolvimento de plugin.
${desktop-shared-libs-src} é o diretório onde se encontram os códigos das desktop-shared-libs.
${localsymbols} é o diretório onde você deseja instalar seus localsymbols.

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