P10 dev studio

  • Published on
    05-Jun-2015

  • View
    611

  • Download
    4

Embed Size (px)

Transcript

<ul><li> 1. Educao CorporativaTotvsDevStudio1Todososdireitosreservados. PlanejamentoecontroleoramentrioMatriz - Av.Braz Leme,1.717 - 02511-000 - So Paulo - SP - Brasil.Tel.:55 (11) 3981 - 7001 www.microsiga.com.br</li></ul><p> 2. 2 Todososdireitosreservados.TotvsDevStudioVISO GERAL DO CURSO 4Objetivos do Curso 4TotvsDevStudio 4CONFIGURAO 5Preferncias 5Configuraes 9Criao e Edio de Programas 11Novo Arquivo 12Caracter ASCll 14Documentao de Explicao 15Documentao de Cdigos 16Documentao de Cabealhos 17Localizar 19Repetir Procura Abaixo 19Indentar 20Substituir 20Minsculo 21Maisculo 21Duplicar Linha 22Ir para a Linha 23Ir para a Linha em Execuo 23Projetos,Compilao,Gerao,Aplicao de Patch e Anlise do RPO 24Projetos 24Compilar Tudo 27Compilao de Projetos 29Compilao de Pastas 29Compilao de Arquivos 29Compilao em Batch 30Gerao de Patchs 30Aplicaes de Patchs 32Inspetores de Objetos 34Logs dos Repositrios 35Gerente de Projetos 37Execuo dos Programas 37Executar 38Pausa da Execuo 41Parar a Execuo 41Ponto de Parada (Break Point) 42Book Marks 44Percorrer Linha 46Pular Linha 47Executar at o Cursor 48Animao 49Para Animao 50Acelera Animao 51Desacelera Animao 52Ferramentas 53Assistentes de Cdigos 53Assistentes de Converses 57Gerenciador de Dados 59Sumrio 3. 3Todososdireitosreservados. TotvsDevStudioVerificao de Integridades 64Desfragmentar Repositrio 65Configurao de Ferramentas 66Anlises de Variveis,Tabelas e Campos 68Comandos 68Watchs 70Break Points 72Pilha de Chamadas (Call Stacks) 74Variveis 75Tabelas e Campos 77Desenho de Interface 78 4. 4 Todososdireitosreservados.TotvsDevStudioVISO GERAL DO CURSOEste curso foi elaborado para capacitar os analistas e programadores do Protheus a utilizarem osrecursos da Ferramenta de Desenvolvimento TotvsDevStudio da MICROSIGA, para que seja possvel odesenvolvimento de rotinas personalizadas referentes customizaes futuras dentro do Protheus.ObjetivosdoCursoO objetivo deste curso ensinar os futuros desenvolvedores utilizarem por completo a Ferramenta deDesenvolvimento TotvsDevStudio,com todos os recursos oferecidos.TotvsDevStudioO que a Ferramenta de DesenvolvimentoTotvsDevStudio?O TotvsDevStudio (Totvs Development Studio) um ambiente de desenvolvimento integrado queacompanhaoProtheus,permitindoaousurioeditar,compilaredepurarprogramasescritosnaLinguagemde Programao ADVPL.Como Ferramenta de Edio, possui todos os recursos das ferramentas mais populares, como Cortar eColar,Levar o Cursor at determinada linha do cdigo,Localizao e Substituio de Texto,etc.,e recursosadicionais,como Indentao de Cdigo,Insero de Comentrios de Documentao,etc.Como Ferramenta de Debug,dispe de aes de debug como Percorrer Linha,Pular Linha,Executar,SeguiratoRetorno,PausarExecuo,DerrubarClient,etc.,permitindoaousurioexecutaredepurarsuasrotinasde dentro de seu ambiente integrado, inspecionando o ambiente de execuo de suas rotinas atravsde diversas janelas de informaes, como variveis (divididas entre variveis locais, variveis pblicas,variveis privadas e variveis estticas), expresses em Watch, Tabelas, ndices e Campos, Break Points,Programas Registrados (Inspetor de Objetos) e Pilha de Chamadas.Alm disso,os programas criados so compilados diretamente doTotvsDevStudio,onde so mantidos emProjetos e Grupos de Projetos.Os Grupos de Projetos facilitam a compilao de um ou mais projetos de arquivos,utilizando conceitos deRepositrios e Diretivas de Compilao, possibilitando inclusive a manuteno de bibliotecas de rotinasdo usurio.Anotaes 5. 5Todososdireitosreservados. TotvsDevStudioCONFIGURAONeste captulo, aprenderemos como devero ser feitas as configuraes bsicas do TotvsDevStudio paraum melhor aproveitamento de seus recursos.Ferramenta de Desenvolvimento TotvsDevStudio: Preferncias; Configuraes.PrefernciasNa opo de Preferncias onde so definidas as informaes que influenciam no comportamento doTotvsDevStudio,ou seja,o perfil de teclas utilizado,cores dos fontes,tabulao,etc.Para configurar Preferncias do TotvsDevStudio, acesse a "Ferramenta de Desenvolvimento -TotvsDevStudio;Anotaes 6. 6 Todososdireitosreservados.TotvsDevStudioSelecioneArquivo,Preferncias;Na pastaGeral,na opoPadro de teclas utilizado,selecione o pradro de telas desejado;Marque a opoIgnorar todos os fontes no encontrados,que est localizada na parte inferior; 7. 7Todososdireitosreservados. TotvsDevStudioNa pastaCdigo,verifique as cores que sero utilizadas durante aDigitao do Fonte;Na pasta Controle de Verso, informe o Caminho do Software, utilizado para realizar o Controle deVerses dos Fontes,caso seja utilizado algum;Anotaes 8. 8 Todososdireitosreservados.TotvsDevStudioExercciosNa pasta Compilao, dever ser informado o Nmero de Processadores existentes no Servidor deAplicao,para que hajaGanhos de Performancedurante aCompilao dos Programas;Aps verificar todas asPreferncias,confirme.Como configurar Preferncias do TotvsDevStudio:1.Acesse a "Ferramenta de Desenvolvimento TotvsDevStudio",atravs do atalho no desktop;2.Selecione as seguintes opes:Arquivo&gt; Preferncias;3.Na pastaGeral,na opoPadro de teclas utilizado,selecione a opoDelphi;4. Marque a opo Ignorar todos os fontes no encontrados, que est localizada na parteinferior;5.Na pastaCdigo,verifique as cores que sero utilizadas durante aDigitao do Fonte;6.Na pastaControle deVerso,informe oCaminho do Software,utilizado para realizar oControlede Verses dos Fontes,caso seja utilizado algum;7.NapastaCompilao,deverserinformadooNmerodeProcessadoresexistentesnoServidorde Aplicao,para que hajaGanhos de Performancedurante aCompilao dos Programas;8. Aps verificar todas asPreferncias,confirme. 9. 9Todososdireitosreservados. TotvsDevStudioConfiguraesAps a definio de todas as Preferncias que sero utilizadas,deveremos ento configurar o Ambiente deTrabalhoqueserutilizadopelocompilador,ouseja,qualocaminhoquedeverserusadopelaFerramentade Desenvolvimento TotvsDevStudio, para atualizar um determinado RPO durante a Compilao dosFontes.Para Configurar o TotvsDevStudio,selecioneArquivo,Configuraes;Clique na opoAdicionar;NoCampo Descrio:,informe oNome do Ambiente,que ser utilizado;Na pasta Compilao, informe no Campo Ambiente, o Nome do Ambiente, que ser utilizado peloCompilador;Dever ser umAmbiente Vlido, noArquivo de Inicializao do TotvsApplicationServer(TotvsAppServer.INI);NoCampo Conexo:,informe oProtocolo Vlido,para aConexo com o TotvsApplicationServer,quedever serTCP;No Campo Diretrio de Includes, informe o Caminho das Pastas, onde se encontram os Arquivos deCabealhos de Programas (*.CH); 10. 10 Todososdireitosreservados.TotvsDevStudioNa pastaGeral,posicione com o cursor sobre o campoOtimizao do Repositrioe selecione qual sera maneira que o Compilador ir atualizar o Repositrio de Objetos, as opes so:Por Tamanho doRepositrioouPor Velocidade da Compilao;Se selecionada a opoPor Tamanho do Repositrio,o mesmo ficar com um tamanho reduzido,pois ocompilador ir alocar asFunesde acordo com os espaos existentes entre uma funo e outra dentrodo repositrio,porm,a compilao ir demorar mais,pois ser necessrio maior tempo para a indexaodas mesmas dentro repositrio;Caso seja selecionada a opo Por Velocidade de Compilao, a compilao dos programas ser bemmais rpida, porm o RPO ficar com um tamanho maior em relao opo anterior, pois conformeas funes forem geradas, o compilador apenas ir inser-las no repositrio,normalmente no final domesmo, caso no encontre espao suficiente para aloc-las entre uma funo e outra, ou seja, o arquivoficar fragmentado.NapastaHandHeld,poderserdefinidoparaqualTipodeInterfaceocompiladorestarsendo utilizado,isso para programas desenvolvidos paraPocket PCePalmOS 11. 11Todososdireitosreservados. TotvsDevStudioExercciosComo Configurar o TotvsAppServer:1.Selecione as seguintes opes:Arquivo&gt;Configuraes;2.Clique na opoAdicionar;3.NoCampo Descrio:,informe oNome do Ambiente;4.NapastaCompilao,informenoCampoAmbiente,oNomedoAmbiente,queserutilizadopeloCompilador;5.NoCampoConexo:,informeoProtocoloVlido,paraaConexocomoTotvsApplicationServer,que dever serTCP;6. No Campo Diretrio de Includes, informe o Caminho das Pastas, onde se encontram osArquivos de Cabealhos de Programas (*.CH);7.Na pastaGeral,posicione com o cursor sobre o campoOtimizao do Repositrioe selecionequal ser a maneira que oCompiladorir atualizar oRepositrio de Objetos,as opes so:PorTamanho do RepositrioouPor Velocidade da Compilao;CriaoeEdiodeProgramasNeste captulo, aprenderemos quais os procedimentos corretos, para a elaborao de Novos Programase suas respectivas manutenes.Ferramenta de Desenvolvimento TotvsDevStudio: Novo Arquivo; Caracter ASCll; Documentao de Explicao; Documentao de Cdigo; Documentao de Cabealho; Localizar;Anotaes 12. 12 Todososdireitosreservados.TotvsDevStudioAnotaes Repetir Procura Abaixo; Repetir Procura Acima; Substituir; Indentao; Minsculo; Maisculo; Duplicar Linha; Ir para a Linha; Ir para a Linha em Execuo.NovoArquivoA opo Novo Arquivo,ir possibilitar a edio de novos programas,dentro do TotvsDevStudio.Para criar Novos Arquivos no TotvsDevStudio, Selecione Arquivo, Novo Arquivo ou clique no botoNovo Arquivo,disponvel naBarra de Ferramentas;NestaPgina de Edio possvel digitar o programa fonte; 13. 13Todososdireitosreservados. TotvsDevStudioExercciosSelecioneArquivo+ Salvarou clique no botoSalvar ,disponvel na "Barra de Ferramentas" e salve nodiretrio previamente criado para guardar os programas fonte e projetos.Note que aps Salvar o Programa, automaticamente o mesmo ser salvo com a extenso PRW, quesignifica que o fonte pertence ao ADVPL;Procure sempre salvar seus programas na pastaRdmake, localizada noDiretrio Raiz do Protheus, essapasta exclusivo para este propsito.Como criar Novos Arquivos no TotvsDevStudio:1.Selecione as seguintes opes:Arquivo &gt;Novo Arquivo2.NaPgina de Edio,informe o programa a seguir:#IncludeRwmake.chUser Function Exemplo1For nI:=1 to 10MsgAlert(Exemplo de Programa.)NextReturn3.Salve o programa fonte como Exemplo1e confirme.ParaumamelhorVisualizaodoTextoinformadoduranteaelaboraodeumprograma,utilizeafonteMsLineDraw,atravs das seguintes opes Arquivo+ Escolha de Fonte,selecionado a fonte citada.AnotaesDica 14. 14 Todososdireitosreservados.TotvsDevStudioExercciosCaracterASCllTem como finalidade inserir um Caracter no Padro ASCll no fonte dos programas, caso isso sejanecessrio.Para utilizar a Tabela ASCll,selecioneArquivo,Novo ArquivoClique emInserir+ Caracter ASClle selecione algumCaracter da Tabela;Note que oCaracter,foi inserido no fonte;Para inserir d um duplo clique no caracter desejadoComo utilizar a Tabela ASCll:1.Selecione as seguintes opesArquivo &gt;Novo Arquivo2. Clique nas seguintes opes Inserir + Caracter ASCll e selecione algum Caracter daTabela;3.Insira o caracter desejado dando um duplo cliqueAnotaes 15. 15Todososdireitosreservados. TotvsDevStudioDocumentaodeExplicaoEsta opo tem por finalidade criar um Documento de Explicao, que poder ser utilizado como meio,para detalhar as Etapas do Programa, tambm Cria um Log referenciando os pontos do programa queforam documentados.Para utilizar Documentaes de Explicao,selecioneArquivo,Novo ArquivoOu clique no botoNovo Arquivo ,disponvel naBarra de Ferramentas;Clique emInserir+ Documentao de ExplicaoNo Box que foi exibido,informe a mensagem a seguir:Teste de programa,utilizando a Documentao de Explicao.Confira os dados e confirme; 16. 16 Todososdireitosreservados.TotvsDevStudioExercciosVerifique que o Comentrio, foi gravado no Editor, iniciando com BEGINDOC e encerrando comENDDOC.Como utilizar Documentaes de Explicao:1.Selecione as seguintes opes:Arquivo&gt;Novo Arquivo2.Clique nas seguintes opesInserir+ Documentao de Explicao3.No Box que foi exibido,informe a mensagem a seguir:Teste de programa,utilizando a Documentao de Explicao.4.Confira os dados e confirme;DocumentaodeCdigosA Documentao de Cdigos utilizada na sequncia da Documentao de Explicao,pois nessa opoencontram-se gravados todos os pontos onde foram inseridos os comentrios.Para utilizar Documentaes de Cdigo,selecioneFerramentas,Documentao de Cdigo;Verifique que o Comentrio, digitado na Documentao de Explicao, foi gravado nesta opo, almdisso,asLinhasonde esse comentrio foi inserido tambm est sendo informada.Anotaes 17. 17Todososdireitosreservados. TotvsDevStudioExercciosComo utilizar Documentaes de Cdigos:1.Selecione as seguintes opes:Ferramentas&gt;Documentao de Cdigo;2.Confira os dados,confirme eCancele o Editor sem Salvar.DocumentaodeCabealhosA opo Documentao de Cabealhos, dever ser utilizada quando for iniciado um programa, poisdessa maneira poderemos deixar documentado todos os detalhes principais sobre a elaborao daquelefonte.Como por exemplo:Nome do Programa,Autor,Data,Finalidade e etc...Para utilizar Documentaes de Cabealhos,selecioneArquivo,Novo Arquivo;Clique emInserir,Documentao de Cabealho;AnotaesAnotaes 18. 18 Todososdireitosreservados.TotvsDevStudioExercciosVerifique que ser inserido noEditor,umaCaixa Formatada,para aInformao dos Comentrios.Como utilizar Documentaes de Cabealhos:1.Selecione as seguintes opes:Arquivo &gt;Novo Arquivo;2.Clique nas seguintes opes:Inserir&gt; Documentao de Cabealho;3.Confira os dados eCancele a Operao. 19. 19Todososdireitosreservados. TotvsDevStudioAnotaesLocalizarPara Localizarmos uma determinada palavra dentro de um Cdigo-Fonte Aberto,poderemos utilizar estaopo.Ela possui diversos Tipos de Pesquisas bastante criteriosas.Como por exemplo:Coincidir as Palavras Maisculas e Minsculas,realizar a Pesquisa Abaixo ou Acima do posicionamento docursor,Localizao em Pastas e Subpastas.Para utilizar este recurso,selecioneEditar,Lcalizar;RepetirProcuraAbaixoDever ser utilizada quando houver a necessidade de se encontrar uma determinada palavra dentro dotexto digitado, lembrando que essa pesquisa ser feita partir da linha onde localiza-se o Cursor paraBaixo.RepetirProcuraAcimaDeverserutilizadaquandohouveranecessidadedeseencontrarumadeterminadapalavra dentro do texto digitado,lembrando que essa pesquisa ser feita partir da linha onde localiza-seo Cursor para Cima.Para utilizar este recurso,selecioneEditar,Repetir Procura Abaixoou pressioneF3; 20. 20 Todososdireitosreservados.TotvsDevStudioExercciosSubstituirQuando houver a necessidade uma Substituio de Palavras no programa, poderemos optar por utilizara opo Substituir.Aqui encontraremos ao mesmo tempo a opo Localizar e Substituir simultaneamente, sendo que oscritrios para o mesmo,tambm sero bem detalhados,assim como na opo Localizar.Para utilizar este recurso,selecioneEditar,Substituir;IndentarQuando quisermos que o fonte digitado seja Indentado (Organizado) deveremos utilizadar esta opo.Para Indentar,selecioneEditar,Texto,Indentar;Note que oFonte,digitado anteriormente foiIndentado.Como utilizar Indentaes:1.Selecione as seguintes opes:Arquivo&gt; Abrir;2.NoDiretrio Rdmake,na pastaMP8,abra o arquivoExemplo1.prw;3.Selecione as seguintes opes:Editar&gt; Texto&gt; Indentar;Quando a opoIndentar,for utilizada em um fonte no qual estiver faltando o encerramento de algumacondio,ser exibida uma mensagem indicando a linha onde est faltando o trmin...</p>