Acessando a documentação da API e aprendendo com código gerado do modelo

Existe um jeito fácil e rápido de acessar a documentação da API que esteja sendo utilizada no desenvolvimento de aplicações no x-code.

E para quem ainda está aprendendo a desenvolver aplicações para iPhone, um jeito simples e prático de aprender o funcionamento básico das aplicações é consultando a documentação de cada classe ou método utilizados no código gerado automaticamente quando é criado um novo projeto baseado em um modelo.

No exemplo abaixo estou usando o SDK do Iphone, portanto é um pré-requisito caso queira reproduzir exatamente o que está escrito, caso contrário, também pode ser feito com a Core Library que já vem junto com o x-code e não há necessidade de download e nem do SDK do Iphone, porém a escolha do projeto deverá ser um projeto para Mac OS X.

Primeiramente, será necessário atualizar a coleção de documentos do seu x-code:

  • Inicie o x-code.
  • Pressione option+command+? para acessar o help do x-code.

x-code help

  • No menu, à esquerda, clique em subscribe nas documentações que quiser adicionar e aguarde o término do download.
  • Feche a janela de help.
  • Pressione command+shift+N para criar um novo projeto.
  • Embaixo da categoria Iphone OS, selecione Application e alguns modelos aparecerão do lado direito.
  • Selecione o modelo View-Based-Application.

x-code novo projeto

  • Dê um nome para o projeto e confirme.
  • Pronto, com o projeto criado, algum código padrão gerado, acesse uma classe qualquer, por exemplo, a implementação do ViewController, no meu caso, exemploViewController.m

exemploViewController.m

  • E agora é que vem a dica… Com o código-fonte aberto, pressione option e perceba que o cursor do mouse virou uma cruz, com option ainda pressionado, dê duplo clique em uma classe, ou um método, ou qualquer coisa que voce queira saber mais e a documentação será aberta apresentando o tópico selecionado.
  • No exemplo, cliquei em initWithNibName: que se encontra na linha 17.

help x-code initWithNibName

Agora é possível navegar pela documentação, através dos cliques no código-fonte, e compreender exatamente o que o código faz. Assim, com o tempo vai entrando no sangue🙂

Tags: , ,

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s


%d bloggers like this: