Programando para Symbian OS

S60 Platform SDKs for Symbian OS , for C++

Diego Mendes Rodrigues (diego@drsolutions.com.br) 27 Agosto/2007

Aula1
Preparando o ambiente de desenvolvimento

Objetivo da aula: Propiciar ao leitor uma viso inicial da plataforma Symbian e ensinar os procedimentos bsicos de instalao do SDK para que seja possvel o desenvolvimento de aplicativos para Symbian OS sem o uso de nenhuma IDE especfica.

Tpicos abordados: Introduo Download dos softwares essenciais Instalando o SDK Ajustando o ambiente Softwares adicionais

1. Introduo
1.1. Symbian, SymbianOS, Symbian C/C++ e Series 60
O Symbian um consrcio de vrias empresas, fundado em 1998. Atualmente fazem parte do consrcio as empresas Nokia, Siemens, Samsung, Ericsson, Sony Ericsson e Panasonic. No incio da era de equipamentos portteis, por volta de 1998, a Symbian era a empresa que fornecia o sistema EPOC 32 para os handhelds da inglesa Psion. A prpria Psion era a maior acionista da empresa e investia bastante para conseguir uma fatia do mercado de sistemas operacionais de aparelhos portteis. Outras empresas que faziam parte da Symbian eram Nokia, Motorola e Ericsson. Com a exploso de consumo dos telefones celulares, a Symbian comeou a desenvolver sistemas para as grandes empresas do ramo, principalmente Nokia, Ericsson e Motorola. A grande maioria dos celulares modernos de hoje pussuem sistema operacional da Symbian. Ele um sistema totalmente modular e permite que cada empresa crie sua prpria interface, portanto este sistema no tem uma cara definida. O software final instalado no dispositivo mvel pode ser um simples sistema de textos em telas monocromticas, ou um completo sistema operacional to potente como o PalmOS ou PocketPC que j pode ser encontrado nos SmartPhones da Nokia, Sony Ericsson, Foma, Siemens, Motorola, dentre outras. SymbianOS um sistema operacional criado para rodar embarcado em dispositivos mveis "multimdia" com suporte cmeras fotogrficas, MMS, wireless, bluetooth, Wi-Fi dentre outras funes. Este sistema operacional predominantemente baseado em um ambiente grfico bastante simples. Atualmente ele utilizado na maioria dos recentes modelos de telefones celulares dos grandes fabricantes. A grande preocupao do Symbian OS evitar ao mximo o desperdcio de recursos do celular, como bateria e memria. Para isso ele conta com diversos mecanismos que so eficientes ao tratar desses problemas. Em sua verso mais nova 9.5, foi reduzido o consumo de memria em 30% em relao verso anterior. Atualmente o Symbian lidera como sendo o SO mais utilizado em smartphones, a frente do Linux, Windows Mobile e outros concorrentes. Vantagens: um sistema aberto e de baixo custo (em torno de $4 por aparelho) Possui recursos para gerenciar e utilizar pouca bateria e memria Permite a instalao de softwares de terceiros Baseado em padres de comunicao e dados Mecanismos que asseguram a transferncia e armazenamento de dados Symbian C/C++ uma variao do padro C++ feita para Symbian. O contexto da linguagem muito parecido o C++ original, mudando apenas algumas funes e tipos, alm de adotar uma forte padronizao de nomes na sua API.
drSolutions Tecnologia e Informtica Ltda (drsolutions.com.br) Diego Mendes Rodrigues 2/19

Mudanas do padro C/C++: Os tipos de variveis foram alteradas, apesar de ser possvel o uso de tipos de variveis padro C/C++, aconselhvel o uso desses novos tipos Ex: TInt = Inteiro 32 bits, TBool = Booleano, TReal = Ponteiro flutuante Houve tambm algumas mudanas tambm na forma que o Symbian trata excees, excees em Symbian so chamadas de Leaves (abandonos). Essa foi uma maneira de simplificar as excees padres de C++, para reduzir o cdigo e o uso de memria Alm disso, uma vasta API est disponvel para que o programador interaja com todos os recursos do aparelho, sem preocupar-se com detalhes de funcionamento de hardware Series 60 uma plataforma desenvolvida pela Nokia e utilizada tambm pela Ericsson. Atualmente a maior plataforma para smartphones do mercado, utiliza o Symbian como sistema operacional. A UIQ, tambm baseada em Symbian, a plataforma concorrente da Series 60 e usada predominantemente em aparelhos Motorola.

1.2. Aparelhos celulares que rodam Symbian OS

Hoje existem centenas de dispositivos mveis que funcionam com o Symbian OS, abaixo apenas uma pequena lista de aparelhos normalmente encontrados no mercado:

Nokia E60, E61, E61i

Nokia 3250

Nokia 7710

LG Joy

Motorola MOTORRIZR

Sony Ericsson P990

3/19

drSolutions Tecnologia e Informtica Ltda (drsolutions.com.br) Diego Mendes Rodrigues

Samsung SGH-D720

BenQ P30

FOMA SH902iSL

Consulte a lista com mais de 100 de aparelhos que usam o Symbian OS em: http://www.symbian.com/phones/index.html

1.3. Termos que voc deve conhecer

ARM: Arquitetura ARM (primeiramente Acorn RISC Machine, atualmente Advanced RISC Machine) uma arquitetura de processador de 32 bits (processadores mais antigos usam 16 bits) e usado principalmente em sistemas embarcados. Muito usado na indstria e na informtica, seu desenvolvimento se deu principalmente para ter o melhor desempenho possvel com a limitao de ser simples, ocupar pouca rea e ter baixo consumo de energia. So conhecidos pela sua versatilidade pois possuem poucas instrues para programao. Encontrados em PDAs, telefones celulares, calculadoras, perifricos de computador, fora as aplicaes industriais. THUMB: Instrues dos processadores ARM de 16 bits ARM4: Instrues dos processadores ARM de 32 bits GUI: Graphical User Interface, ou interface grfica de usurio AVKON: Biblioteca para desenvolvimento GUI na plataforma S60. CONE: Control Environment, ou controle de ambiente UIKON: Framework comum de desenvolvimento na plataforma Symbian, para UI (user interface) e rotinas de controle IDE: Integrated Development Environment, ou Ambiente de desenvolvimento integrado um ambiente que auxilia e agiliza o desenvolvimento de softwares. Normalmente incluem editores de cdigo, compiladores, debugadores, emuladores e etc. Algumas IDEs muito conhecidas: Eclipse, Visual Studio, Carbide e etc SDK: Software Development Kit, ou Kit de desenvolvimento de software um conjunto de ferramentas para criao de softwares para determinadas plataformas. UID: Um nmero de 32 bits que gera uma identificao nica para um determinado objeto, tipo, vendedor e etc. WINS: Plataforma alvo para o desenvolvimento de programas que sero executados dentro de emulador no sistema operacional Microsoft Windows.
4/19

drSolutions Tecnologia e Informtica Ltda (drsolutions.com.br) Diego Mendes Rodrigues

2. Instalando S60 Platform SDKs for Symbian OS , for C++ no seu computador
Antes de instalar o SDK no seu computador, verifique se o mesmo possui os requisitos mnimos apresentados nas reas abaixo. Atendendo esses pr-requisitos mnimos, o leitor ser capaz de usar o SDK pelo menos na forma stand-alone, desenvolvendo aplicativos atravs de editores de texto simples e compilando seus programas atravs da linha de comando (procedimento que ser abordado na segunda aula desse mini-curso).

2.1. Pr-requisitos
2.1.1 Hardware mnimo recomendado
Processador de 1 GHz (o mnimo necessrio 500 MHz) 512 MB RAM (o mnimo necessrio 128 MB) Placa de vdeo com uma resoluo de pelo menos 16-bits Resoluo de pelo menos 1024x768 1 GB de espao livre em disco Placa de som compatvel com Microsoft Windows Teclado e mouse

2.1.2 Requisitos de Software

Sistemas operacionais suportados: Microsoft Windows XP Professional SP2 Microsoft Windows 2000 SP4 Outros softwares que devem ser estar instalados antes da instalao do SDK: Active Perl verso 5.6.1 (a instalao do Active Perl ser detalhada na seo 2.2 deste material) Java Runtime verso 1.4.2_02 ou mais recente (a instalao do JRE 1.6 ser detalhada na seo 2.2 deste material)

2.2. Instalando os softwares necessrios

2.2.1. Instalando o Active Perl verso 5.6.1
Faa o download do Active Perl verso 5.6.1 no site oficial da Active State: http://www.activestate.com/store/activeperl/ Caso voc prefira, voc pode fazer o download de uma cpia armazenada no servidor da drSolutions: http://www.drsolutions.com.br/tutorial_symbian/ActivePerl-5.6.1.633-MSWin32x86.msi
drSolutions Tecnologia e Informtica Ltda (drsolutions.com.br) Diego Mendes Rodrigues 5/19

Agora um duplo clique no arquivo ActivePerl-5.6.1.633-MSWin32-x86.msi (8.78MB) deve iniciar o processo de instalao no seu computador. Siga o processo de instalao e no altere os locais de instalao do software.

drSolutions Tecnologia e Informtica Ltda (drsolutions.com.br) Diego Mendes Rodrigues

6/19

2.2.1. Instalando o Java Runtime verso 1.6

Faa o download do JRE no site da SUN: http://java.sun.com/javase/downloads/index.jsp Caso voc prefira, voc pode fazer o download de uma cpia armazenada no servidor da drSolutions: http://www.drsolutions.com.br/tutorial_symbian/jre-6u1-windows-i586-p-s.exe Agora um duplo clique no arquivo jre-6u1-windows-i586-p-s.exe (13.1MB) deve iniciar o processo de instalao no seu computador. Siga o processo de instalao e no altere os locais de instalao do software.

drSolutions Tecnologia e Informtica Ltda (drsolutions.com.br) Diego Mendes Rodrigues

7/19

2.1.3. Ajuste do PATH

Voc agora deve ter o Perl instalado em c:\Perl o o JRE instalado em C:\Arquivos de programas\Java\jre1.6.0_01.

Para que o SDK funcione corretamente, necessrio que o Perl e o JRE estejam no PATH do sistema. V em Iniciar Painel de Controle Sistema Depois na aba Avanado e clique no boto Variveis de Ambiente Dentro da lista de Variveis do sistema, localize a linha Path Verifique se foram os diretrios esto includos na lista: C:\Arquivos de programas\Java\jre1.6.0_01\bin\ C:\Perl\bin\ Caso algum deles no esteja na lista, inclua o mesmo. Lembre-se que cada diretrio dessa lista deve estar separado por ponto-e-vrgula. Exemplo: C:\Perl\bin\;C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\ Wbem;C:\Arquivos de programas\Java\jre1.6.0_01\bin\

drSolutions Tecnologia e Informtica Ltda (drsolutions.com.br) Diego Mendes Rodrigues

8/19

Agora, reinicie o computador antes de prosseguir!

2.2. Instalando o SDK

2.2.1. S60 Platform SDK for Symbian OS, for C++
Faa o Download do S60 Platform SDK for Symbian OS, for C++ no Nokia Forum. Entre no Link: http://www.forum.nokia.com/main/resources/tools_and_sdks/index.html Escolha a opo C++ SDKs for all versions Na prxima pgina, escolha o arquivo 3rd Edition, FP1 (355 MB) Clique em Download Now
9/19

drSolutions Tecnologia e Informtica Ltda (drsolutions.com.br) Diego Mendes Rodrigues

Descompacte o arquivo em qualquer lugar de seu computador. Entre na pasta descompactada em execute o arquivo setup.exe.

drSolutions Tecnologia e Informtica Ltda (drsolutions.com.br) Diego Mendes Rodrigues

10/19

Instale o SDK sem alterar os caminhos e diretrios sugeridos pelo instalador.

drSolutions Tecnologia e Informtica Ltda (drsolutions.com.br) Diego Mendes Rodrigues

11/19

Instale o CSL ARM QIC Toolchain (GCCE).

drSolutions Tecnologia e Informtica Ltda (drsolutions.com.br) Diego Mendes Rodrigues

12/19

drSolutions Tecnologia e Informtica Ltda (drsolutions.com.br) Diego Mendes Rodrigues

13/19

2.2.2. Instalando o Symbian_Env_Updade

Faa o download do arquivo Symbian_Env_Updade.zip no site da drSolutions: http://www.drsolutions.com.br/tutorial_symbian/Symbian_Env_Updade.zip Descompacte o mesmo na raiz (c:\) de seu computador.

drSolutions Tecnologia e Informtica Ltda (drsolutions.com.br) Diego Mendes Rodrigues

14/19

Entre na pasta C:\Symbian_Env_Updade\env_switch e execute o programa env_update.exe. Na tela que aparece, aceite as alteraes com um y.

2.2.3. Verificando o PATH

Para que o SDK funcione corretamente, necessrio que o CSL Arm Toolchain e o Symbian_Env_Updade tambm sejam adicionados ao no PATH do sistema. V em Iniciar Painel de Controle Sistema Depois na aba Avanado e clique no boto Variveis de Ambiente Dentro da lista de Variveis do sistema, localize a linha Path Verifique se foram os diretrios esto includos na lista: C:\Arquivos de programas\Java\jre1.6.0_01\bin\ C:\Perl\bin\ C:\Symbian_Env_Updade\Symbian_Tools\Command_Line_Tools C:\Arquivos de programas\CSL Arm Toolchain\bin Caso algum deles no esteja na lista, inclua o mesmo. Lembre-se que cada diretrio dessa lista deve estar separado por ponto-e-vrgula. Exemplo: C:\Symbian_Env_Updade\Symbian_Tools\Command_Line_Tools;C:\Arquivos de programas\CSL Arm Toolchain\bin;C:\Arquivos de programas\Arquivos comuns\Symbian\Tools;C:\Perl\bin\;C:\WINDOWS\system32;C:\WINDOWS;C:
15/19

drSolutions Tecnologia e Informtica Ltda (drsolutions.com.br) Diego Mendes Rodrigues

\WINDOWS\System32\Wbem;C:\Perl\bin\;C:\WINDOWS\system32;C:\WINDO WS;C:\WINDOWS\System32\WbemC:\Perl\bin\;C:\WINDOWS\system32 ;C:\WINDOWS;C:\WINDOWS\System32\Wbem;C:\Arquivos de programas\Java\jre1.6.0_01;

Agora, reinicie o computador antes de prosseguir!

2.2.4. Ajuste na configurao do Emulador

Agora, voc precisa alterar o arquivo config.properties que est no diretrio C:\Symbian\9.2\S60_3rd_FP1\Epoc32\tools\ecmt\config.

Abra o arquivo com o Bloco de Notas e adicione ,1.6,6.0 na linha epdt.java.version.start=:

drSolutions Tecnologia e Informtica Ltda (drsolutions.com.br) Diego Mendes Rodrigues

16/19

2.3. Ps-requisitos
Caso voc tenha seguido todos os passos descritos nas pginas anteriores, seu SDK est instalado e funcional em seu computador. No decorrer da prxima aula, iremos aprender a compilar um Hello World, test-lo no emulador e depois transferi-lo para um celular (no caso usaremos um Nokia E61). Embora o intuito dessas aulas iniciais seja mostrar o funcionamento do SDK cr, ou seja, sem usar nenhuma IDE especfica, eu aconselho o leitor instalar dois pequenos programas para uma maior comodidade no desenvolvimento.

2.3.1. Microsoft Power Toy Open Command Window Here

Faa o download do arquivo CmdHerePowertoySetup.exe (514 Kb) no link: http://download.microsoft.com/download/whistler/Install/2/WXP/ENUS/CmdHerePowertoySetup.exe ou entra na pgina de Power Toys da Microsoft: http://www.microsoft.com/windowsxp/downloads/powertoys/xppowertoys.mspx Depois de instalado, sempre que voc estiver no Windows Explorer e clicar com o boto direito em alguma pasta, a opo Open Command Window Here estar disponvel. Ao clicar nela, ser aberta uma janela de Prompt de Comando j na pasta selecionada.

drSolutions Tecnologia e Informtica Ltda (drsolutions.com.br) Diego Mendes Rodrigues

17/19

3.3.2 NotePad++ e Extenses

O NotePad++, como o prprio nome sugere, um bloco de notas melhorado. Alm de voc poder abrir vrios arquivos de uma nica vez (navegao por abas), ele consegue deixar colorido o seu cdigo fonte e existem vrios plugins disponveis para incrementar ainda mais as funcionalidades do programa. Iremos usar esse programa nas prximas aulas, portanto eu recomendo que o leitor instale esse programa. Faa o Download do programa em: http://notepad-plus.sourceforge.net/ e depois instale o programa. Agora faa o download do plug-in Explorer plugin v1.2 na rea de downloads do site. Descompacte o arquivo Explorer_1_2_dll.zip e copie o Explorer.dll para a pasta C:\Arquivos de programas\Notepad++\plugins

Abra o Notepad++. V no menu Plugins Explorer Explorer

drSolutions Tecnologia e Informtica Ltda (drsolutions.com.br) Diego Mendes Rodrigues

18/19

Correes e atualizaes desse documento estaro disponveis em: http://www.drsolutions.com.br/programando_symbian

drSolutions Tecnologia e Informtica Ltda (drsolutions.com.br) Diego Mendes Rodrigues

19/19