A primeira aplicação

Pois bem, chegou a hora de desenvolvermos nossa primeira aplicação, o vídeo do post anterior certamente ajuda muito, mas aqui vou definir os passos necessários para que você possa desenvolver um aplicativo Hello World básico usando xml, opensocial, Google Project Hosting e o Sandbox do Orkut.

Muito bem, o primeiro passo é criar sua conta no Orkut Sandbox, que é uma "versão" do Orkut que te permite testar suas próprias Gadgets (No momento em que estou escrevendo esse artigo usuários do Brasil ainda não tem acesso as aplicações OpenSocial, porém basta setar seu país natal como Estados Unidos para visualizá-las), para criar sua conta acesse:

Cadastro no SandBox do Orkut

Lembrando que o sandbox é, no momento, apenas para programadores então o cadastro não é imediato, você vai receber um e-mail da google confirmando se você foi ou não cadastrado no sandbox.

Você deve nesse momento ter uma conta Google, o Google Projecting Hosting é uma ferramenta que permite que você disponibilize seus arquivos xml, html, etc online para que possam ser acessados pelo OpenSocial no OrkutSandbox, Site do Google Project Hosting.

Com sua conta no sandbox ativa, vamos desenvolver nosso primeiro programa.
Uma Gadget OpenSocial é um arquivo xml simples, para criar um desses abra um editor de texto e digite as seguintes linhas:

Explicando esse arquivo.
A primeira linha contém a versão do xml e a codificação dos caracteres.
Module é uma tag importante das Gadgets, é a tag principal para se indicar que se trata de uma.
ModulePrefs (Preferências de Module) indica qual o título da aplicação (entre outra coisas).
Require feature define quais recursos são requeridos (aqui a versão do opensocial é requerida, nesse caso a 0.7).
Content type define o tipo de linguagem utilizada, aqui apenas html puro.
Dentro da tag [CDATA[]], mais especificamente dentro dos colchetes , vai o nosso código, Javascript, htm, etc. No exemplo, como foi dito, html apenas.

Então, salve seu arquivo como helloworld.xml.

Acesse sua conta do Google Project Hosting , para criar um novo projeto clique em Create a new project e siga as instruções, o nome do projeto deve conter apenas letras minúsuclas e não pode conter espaços e certos caracteres especias pois tudo que você depositar no Google Project Hosting vai ser open source e pode ser acessado por uma URL simples, como no caso do código que postei aqui, que vem diretamente do meu projeto "primeiroteste".

OK, agora você tem um projeto no Google Project Hosting mas precisa fazer o upload do arquivo recém salvo, o modo mais fácil de fazê-lo é obtendo a ferramenta Tortoise SVN.

Essa ferramenta faz uma conexão com um site de web hosting como o Google Project Hosting e provê de maneira simples o upload de arquivos para o seu projeto online.

Com a ferramenta instalada, você notará uma nova opção ao clicar com o botão direito em seus arquivos:


Ao clicar em Repo-Browser o Tortoise vai pedir a url segura do seu web hoster, no nosso caso, na página do seu projeto, acesse a tab Source e a tab Checkout, onde haverá um link seguro (https) para o seu projeto, copie esse link para o campo requisitado pelo Tortoise.

No meu caso o link era https://primeiroteste.googlecode.com/svn/trunk/

O Tortoise deve então requisitar o username e a senha, o usuário é a sua conta google e a senha deve ser obtida na tab Checkout, no link generated googlecode password.

Ao acessar o Tortoise você terá a seguinte tela:




O diretório trunk é onde você deve salvar seus arquivos xml e html.
Botão direito nele, adicionar arquivo, ou add file se você não tiver instalado o patch Português BR disponível no site Tortoise SVN.

Selecione o helloworld.xml e parabéns, seu arquivo foi adicionado ao seu projeto. Acesse a tab Browse em Source no seu projeto e pronto, vejá lá que no diretório trunk se encontra seu arquivo helloworld.xml.

OK, agora testemos essa Gadget OpenSocial no Orkut Sandbox!

Acesse o seu sandbox, clique em editar, ao lado da seção Apls ao lado esquerdo.

Deve aparecer uma caixa de texto e uma opção para adicionar seu próprio aplicativo!


Agora basta adicionar a URL do seu aplicativo (no meu caso http://primeiroteste.googlecode.com/svn/trunk/helloworld.xml)
E adicioná-lo ao seu Orkut Sandbox!

Pronto, seu aplicativo pode agora ser testado!


Muito bem, espero ter ajudado na compreensão dos conceitos básicos das ferramentas apresentadas, espero que você tenha conseguido postar seu primeiro aplicativo no Orkut SandBox, esse é um grande passo para desenvolver aplicações OpenSocial, não deixe de comentar qualquer dúvida ou idéias.