Difference between revisions of "Getting Started (gl)"

Jump to: navigation, search
(+gl)
(Updated.)
Line 1: Line 1:
{{Template:I18n/Language Navigation Bar (gl)|Getting_Started}}
+
{{Template:I18n/Language Navigation Bar|Getting Started}}
{{Box|Obter as fontes|
+
 
 +
==Requisitos previos==
 +
As versións de KDE divídense en pólas que parten da principal (''trunk''). Os pasos a seguir para compilar cada unha desas pólas son moi similares. Porén, cada unha ten cadanseus [[Getting Started/Build/KDE4/Prerequisites (gl)|requisitos previos]].
 +
 
 +
Terá que decidir cal é a versión que quere e a frecuencia con que empregará o ambiente de desenvolvemento.
 +
 
 +
O contido deste wiki está escrito principalmente para as distintas versións da póla 4 de KDE e sistemas GNU/Linux. Para Windows, BSD ou a póla 3 de KDE bótelle unha ollada á sección correspondente na [[Getting Started/Build (gl)|páxina sobre como compilar KDE]].
 +
 
 +
==Escoller unha versión==
 +
;Sincronización coa distribución de GNU/Linux
 +
:Para atopar as dependencias de maneira doada, vexa a [[Distributions with KDE (gl)|páxina sobre distribucións de GNU/Linux con KDE]].
 +
:Para os ''desenvolvedores'' que queiran crear un parche para un programa existente, quizais queira botarlle un ollo a [[Getting Started/EasyStartDevelopmentOnDebian (gl)|isto]].
 +
 
 +
;Últimas funcionalidades
 +
:Póla estable ou de probas.
 +
 
 +
;Desenvolvemento do núcleo
 +
:Póla principal, que é onde se engaden as últimas funcionalidades (pode ter problemas de compilación os luns).
 +
 
 +
;Vexa as pólas dispoñibles:
 +
:http://websvn.kde.org/branches/KDE/
 +
 
 +
==Escolla as rutas==
 +
Escolla onde quere instalar KDE, e manter os directorios do código fonte e compilación. En caso de empregar a versión do sistema de Qt, pode que sexa necesario instalar o [[QCA plugin (gl)|complemento QCA]] como administrador (''root'').
 +
 
 +
===Directorios do código fonte e de compilación===
 +
:Suxírese empregar <tt>~/kde/src</tt> e <tt>~/kde/build</tt> (sendo «<tt>~</tt>» o directorio persoal do usuario de KDE).
 +
:<tt>/usr/src/</tt> sería outra posibilidade en caso de que a compilación se faga coma administrador (''root'').
 +
 
 +
===Directorio da instalación===
 +
Estes son os directorios de instalación recomendados para as distintas situacións:
 +
 
 +
;Curiosidade casual
 +
:O directorio persoal do usuario utilizado para o desenvolvemento se non quere estragar o KDE do sistema.
 +
:O seu directorio persoal, se está disposto a empregar variables de ambiente para manter versións separadas de KDE ─mediante [[Getting Started/Increased Productivity in KDE4 with Scripts (gl)|guións]]─ ou en caso de que non teña outra forma de acceder ao computador.
 +
:Como administrador (''root'') non se recomenda a menos que teña un computador que vaia dedicarse unicamente ao desenvolvemento de KDE.
 +
 
 +
;Desenvolvemento dun programa
 +
:O directorio persoal do usuario, ao igual que para o caso anterior.
 +
:Como administrador (''root'') será máis útil para simular o ambiente dos usuarios.
 +
:O seu directorio persoal podería simplificar o proceso de desenvolvemento.
 +
 
 +
;Xestión dunha distribución
 +
:Para probar KDM, pode que lle pague a pena realizar a instalación coma administrador (''root'') ou nunha [[Getting Started/Build/KDE4/On virtual machines|máquina virtual]] para non arriscar a integridade do sistema.
 +
 
 +
;Contribuír
 +
:Manter o sistema de xeito similar a como fan outros ''desenvolvedores'' poderá simplificar a solución de erros, bótelle unha ollada ás [[Developer Setups (gl)|escollas dos ''desenvolvedores'']].
 +
 
 +
==Reunir os requisitos previos==
 +
Se non cumpre con algún dos requisitos previos, a compilación fallará. E a lista vai cambiando. Existen algunhas opcións, porén o sistema <tt>make</tt> pode atopar a miúdo paquetes opcionais aínda que non se pretenda empregalos, polo que pode resultar necesario desactivar algunhas desas opcións.
 +
 
 +
*[[Getting Started/Build/KDE4/Prerequisites (gl)|Requisitos previos]].
 +
*[[Build requirements (gl)|Requisitos para a compilación]] segundo a distribución empregada.
 +
 
 +
===Qt===
 +
 
 +
;Sistema Qt
 +
:Adoita ser a forma máis doada de facelo porque a maior parte da xente xa o ten. Pode que teña que instalar o complemento QCA como administrador (''root'').
 +
 
 +
;KDE-Qt
 +
:Este sistema, outrora coñecido coma <tt>qt-copy</tt>. Esta é a versión mínima de KDE que deben ter os usuarios. Pode que algúns errores estean xa corrixidos en versións máis novas de Qt, polo que ao mellor ten que solucionar pola súa conta estes erros nas versións anteriores, incluída esta.
 +
 
 +
;Qt principal
 +
:Obtéñao directamente de Nokia, experimente as últimas funcionalidades, pero teña en conta que moita xente estará empregando versións anteriores de Qt.
 +
 
 +
==Obter o código fonte==
 
[[Image:Action_down.svg|right|32px]]
 
[[Image:Action_down.svg|right|32px]]
O código fonte de KDE está disponíbel de diversos xeitos:
+
Estamos a migrar de SVN a Git. Estamos a sufrir importantes cambios na nosa infraestrutura, pero que quede claro que se trata dun cambio complexo e popularmente aceptado do que xa se avisara con tempo<sup>[http://www.omat.nl/2010/07/07/move-to-git-the-progress-so-far/ *]</sup>.
* [[Getting Started/Sources/Anonymous SVN (gl)|Guía de consulta rápida do SVN anónimo]]
+
* [[Getting Started/Sources/Using Subversion with KDE|Usar subversion con KDE]] ''Unha ollada máis profunda ao acceso ao código fonte de KDE con subversion, incluído o aspecto do repositorio e o manexo de revisións e parches.''
+
* [http://websvn.kde.org/ Explora o código en liña]
+
* [[Getting Started/Sources/Snapshots|Instantáneas diarias do repositorio]]
+
|100%}}
+
  
{{Box|Compilar KDE|
+
*[[Getting Started/Sources/Anonymous SVN (gl)|Guía rápida de introdución ao SVN anónimo]].
[[Image:Action_tool.svg|right|32px]]
+
*[[Getting Started/Sources/Using Subversion with KDE (gl)|Empregar Subversion con KDE]], unha guía máis completa sobre o acceso ao código fonte de KDE mediante Subversion que inclúe o esquema do ''repositorio'' e mailo método de traballo coas revisións e parches.
Hai diferentes ramas de KDE. Para o seu uso en produción recoméndase a versión estábel.
+
*[[Getting Started/Sources/Amarok Git Tutorial (gl)|Aprender a empregar Git con Amarok]]. Amarok xa está a empregar Git (tal e como acabarán facendo o resto de programas de KDE), polo que fai falla seguir uns pasos distintos para obter o código e desenvolver sobre el.
* [[Getting Started/Build/KDE4_(gl)|KDE 4 (Versión en desenvolvemento, trunk)]]
+
*[[Getting Started/Sources/Snapshots (gl)|Instantáneas diarias]].
* [[Getting Started/Build/Stable Version|KDE 3.5 (Versión estábel)]]
+
*[http://websvn.kde.org/ Navegar polo código dende o ''navegador web''] (''en inglés''), ou [http://lxr.kde.org/search buscar nel] (''en inglés'').
* [[Getting Started/Build|Outras versións]] ''Incluída información sobre a compilación en sistemas diferentes a GNU/Linux''
+
|100%}}
+
  
{{Box|Configurar o contorno|
+
==Compilalo==
 +
 
 +
;Pasos manuais
 +
*[[Getting Started/Build/KDE4 (gl)|KDE 4]] (versión principal de desenvolvemento, tamén chamada''trunk'').
 +
*[[Getting Started/Build/KDE4.x (gl)|KDE 4.x]] (versión estable, tamén coñecida como “póla 4.x do SVN”).
 +
*[[Getting Started/Build/KDE4.x Upgrade (gl)|Actualizar a versión 4.x.y de KDE]].
 +
*[[Getting Started/Build (gl)|Outras versións, así como dúbidas habituais]], con información respecto de como compilar KDE en sistemas operativos que non sexan GNU/Linux.
 +
 
 +
;Guión en Bash con argumentos
 +
:[[Getting Started/Increased Productivity in KDE4 with Scripts (gl)|Uso de guións]].
 +
:Exemplos específicos: [[Build KDE4.6 on Kubuntu (gl)|Compilar KDE 4.6 en Kubuntu]].
 +
 
 +
;Pasos específicos de cada distribución
 +
:Pode que existan compilacións para a súa distribución. Por exemplo, o Project Neon busca fornecer compilacións regulares da póla principal (''trunk''), e ''repositorios'' PPA coas últimas versións estables.
 +
 
 +
;<tt>kdesrc-build</tt>
 +
:Este guión realizará por vostede gran parte do proceso de descarga e compilación. Pode configurarse para compilar a maior parte das versións, sendo a póla principal (''trunk'') a versión por omisión. Hai instrucións completas sobre o proceso en http://kdesrc-build.kde.org (''en inglés'') e máis [[Getting Started/Build/kdesrc-build (gl)|aquí]], e existe ademais unha [[kdesrc-build/workingrclist (gl)|lista de ficheiros de configuración probados]].
 +
 
 +
===Solución de erros relativos á compilación===
 +
*[[Getting Started/Build/KDE4/Troubleshooting (gl)|Solución de erros]].
 +
 
 +
[[Getting Started/Build/KDE4/Troubleshooting|A información sobre a solución de erros]] tampouco cambia moito dunhas versións a outras.
 +
 
 +
Os erros de compilación e ligazón adoitan ser o motivo de que algúns desistan. Anote coidadosamente a primeira aparición dun erro no seu proceso de compilación. Pode que se trate de algo tan simple coma unha variable de ambiente incorrecta, unha versión inesperada dunha biblioteca ou un requisito previo que non se cumpriu.
 +
 
 +
Revise os seus rexistros e busque como solucionar os erros. Se non dá atopada unha solución, probe [[Build/KDE4/Errors (gl)|nesta páxina sobre erros]], na canle de IRC e nas roldas de correo. Pode que lle interese tamén botarlle unha ollada a [[Build/Stories (gl)|esta páxina sobre casos de compilacións]].
 +
 
 +
==Uso de KDE==
 +
Unha vez compilado correctamente, interesaralle dispor dun bo xeito de iniciar programas e realizar as súas tarefas de desenvolvemento habituais:
 +
 
 +
===Variables de ambiente===
 
[[Image:Action_pen.svg|right|32px]]
 
[[Image:Action_pen.svg|right|32px]]
Despois de ter compilado KDE, quererás ter algún xeito de lanzar aplicacións e realizar as túas tarefas de desenvolvemento habituais:
+
O seu sistema non saberá empregar o seu novo KDE ata que lle “diga” como atopar os programas de bibliotecas de KDE.
* [[Getting Started/Increased Productivity in KDE4 with Scripts|Produtividade mellorada con guións de shell en KDE 4]]
+
 
* [[Getting Started/Set up KDE 4 for development|Configurar KDE 4 para o desenvolvemento]]
+
*[[Getting Started/Increased Productivity in KDE4 with Scripts (gl)|Incremento da produtividade en KDE 4 mediante o uso de guións]].
|100%}}
+
*[[Getting Started/Set up KDE 4 for development (gl)|Preparar KDE 4 para traballar coma ''desenvolvedor'']].
 +
 
 +
===Preparar as ferramentas de desenvolvemento===
 +
Á hora de utilizar ferramentas de desenvolvemento, probablemente lle interese empregar os paquetes estables da súa distribución. Para máis información respecto do tema do desenvolvemento e documentación ao respecto, diríxase a [[Development (gl)|esta páxina]].
 +
 
 +
;Abrir e crear ficheiros de proxecto de KDE
 +
*[[Eclipse (gl)|Eclipse]].
 +
*[[KDevelop (gl)|KDevelop]].
 +
*[[Development/Tutorials/Using Qt Designer (gl)|QtDesigner]].
 +
 
 +
===Contribuír===
 +
[[Image:Action_tool.svg|right|32px]]
 +
Pode que non necesite a ''ultimísima'' versión estable de KDE para o seu desenvolvemento. Gran parte do código vai ser idéntico dunha versión a outra, e pode que os parches que xere funcionen. Porén, a póla principal (''trunk'') é onde se realizan a maior parte dos cambios, e as pólas estables son principalmente para as tarefas de mantemento e a solución de erros.
 +
 
 +
*[[Contribute (gl)|Contribuír]].
 +
*[[Contribute/Send Patches (gl)|Enviar parches]].
 +
*[[Contribute/Bugsquad (gl)|Solucionar erros]].
 +
*[[Getting Started/Using Project Neon to contribute to KDE (gl)|Empregar Project Neon para contribuír a KDE]].
 +
*[[Getting Started/EasyStartDevelopmentOnDebian (gl)|Compilar, modificar e executar programas empaquetados de KDE en Debian]].
 +
 
 
[[Category:Build KDE]]
 
[[Category:Build KDE]]

Revision as of 20:14, 19 November 2010


Contents

Getting Started


Requisitos previos

As versións de KDE divídense en pólas que parten da principal (trunk). Os pasos a seguir para compilar cada unha desas pólas son moi similares. Porén, cada unha ten cadanseus requisitos previos.

Terá que decidir cal é a versión que quere e a frecuencia con que empregará o ambiente de desenvolvemento.

O contido deste wiki está escrito principalmente para as distintas versións da póla 4 de KDE e sistemas GNU/Linux. Para Windows, BSD ou a póla 3 de KDE bótelle unha ollada á sección correspondente na páxina sobre como compilar KDE.

Escoller unha versión

Sincronización coa distribución de GNU/Linux
Para atopar as dependencias de maneira doada, vexa a páxina sobre distribucións de GNU/Linux con KDE.
Para os desenvolvedores que queiran crear un parche para un programa existente, quizais queira botarlle un ollo a isto.
Últimas funcionalidades
Póla estable ou de probas.
Desenvolvemento do núcleo
Póla principal, que é onde se engaden as últimas funcionalidades (pode ter problemas de compilación os luns).
Vexa as pólas dispoñibles
http://websvn.kde.org/branches/KDE/

Escolla as rutas

Escolla onde quere instalar KDE, e manter os directorios do código fonte e compilación. En caso de empregar a versión do sistema de Qt, pode que sexa necesario instalar o complemento QCA como administrador (root).

Directorios do código fonte e de compilación

Suxírese empregar ~/kde/src e ~/kde/build (sendo «~» o directorio persoal do usuario de KDE).
/usr/src/ sería outra posibilidade en caso de que a compilación se faga coma administrador (root).

Directorio da instalación

Estes son os directorios de instalación recomendados para as distintas situacións:

Curiosidade casual
O directorio persoal do usuario utilizado para o desenvolvemento se non quere estragar o KDE do sistema.
O seu directorio persoal, se está disposto a empregar variables de ambiente para manter versións separadas de KDE ─mediante guións─ ou en caso de que non teña outra forma de acceder ao computador.
Como administrador (root) non se recomenda a menos que teña un computador que vaia dedicarse unicamente ao desenvolvemento de KDE.
Desenvolvemento dun programa
O directorio persoal do usuario, ao igual que para o caso anterior.
Como administrador (root) será máis útil para simular o ambiente dos usuarios.
O seu directorio persoal podería simplificar o proceso de desenvolvemento.
Xestión dunha distribución
Para probar KDM, pode que lle pague a pena realizar a instalación coma administrador (root) ou nunha máquina virtual para non arriscar a integridade do sistema.
Contribuír
Manter o sistema de xeito similar a como fan outros desenvolvedores poderá simplificar a solución de erros, bótelle unha ollada ás escollas dos desenvolvedores.

Reunir os requisitos previos

Se non cumpre con algún dos requisitos previos, a compilación fallará. E a lista vai cambiando. Existen algunhas opcións, porén o sistema make pode atopar a miúdo paquetes opcionais aínda que non se pretenda empregalos, polo que pode resultar necesario desactivar algunhas desas opcións.

Qt

Sistema Qt
Adoita ser a forma máis doada de facelo porque a maior parte da xente xa o ten. Pode que teña que instalar o complemento QCA como administrador (root).
KDE-Qt
Este sistema, outrora coñecido coma qt-copy. Esta é a versión mínima de KDE que deben ter os usuarios. Pode que algúns errores estean xa corrixidos en versións máis novas de Qt, polo que ao mellor ten que solucionar pola súa conta estes erros nas versións anteriores, incluída esta.
Qt principal
Obtéñao directamente de Nokia, experimente as últimas funcionalidades, pero teña en conta que moita xente estará empregando versións anteriores de Qt.

Obter o código fonte

Action down.svg

Estamos a migrar de SVN a Git. Estamos a sufrir importantes cambios na nosa infraestrutura, pero que quede claro que se trata dun cambio complexo e popularmente aceptado do que xa se avisara con tempo*.

Compilalo

Pasos manuais
Guión en Bash con argumentos
Uso de guións.
Exemplos específicos: Compilar KDE 4.6 en Kubuntu.
Pasos específicos de cada distribución
Pode que existan compilacións para a súa distribución. Por exemplo, o Project Neon busca fornecer compilacións regulares da póla principal (trunk), e repositorios PPA coas últimas versións estables.
kdesrc-build
Este guión realizará por vostede gran parte do proceso de descarga e compilación. Pode configurarse para compilar a maior parte das versións, sendo a póla principal (trunk) a versión por omisión. Hai instrucións completas sobre o proceso en http://kdesrc-build.kde.org (en inglés) e máis aquí, e existe ademais unha lista de ficheiros de configuración probados.

Solución de erros relativos á compilación

A información sobre a solución de erros tampouco cambia moito dunhas versións a outras.

Os erros de compilación e ligazón adoitan ser o motivo de que algúns desistan. Anote coidadosamente a primeira aparición dun erro no seu proceso de compilación. Pode que se trate de algo tan simple coma unha variable de ambiente incorrecta, unha versión inesperada dunha biblioteca ou un requisito previo que non se cumpriu.

Revise os seus rexistros e busque como solucionar os erros. Se non dá atopada unha solución, probe nesta páxina sobre erros, na canle de IRC e nas roldas de correo. Pode que lle interese tamén botarlle unha ollada a esta páxina sobre casos de compilacións.

Uso de KDE

Unha vez compilado correctamente, interesaralle dispor dun bo xeito de iniciar programas e realizar as súas tarefas de desenvolvemento habituais:

Variables de ambiente

Action pen.svg

O seu sistema non saberá empregar o seu novo KDE ata que lle “diga” como atopar os programas de bibliotecas de KDE.

Preparar as ferramentas de desenvolvemento

Á hora de utilizar ferramentas de desenvolvemento, probablemente lle interese empregar os paquetes estables da súa distribución. Para máis información respecto do tema do desenvolvemento e documentación ao respecto, diríxase a esta páxina.

Abrir e crear ficheiros de proxecto de KDE

Contribuír

Action tool.svg

Pode que non necesite a ultimísima versión estable de KDE para o seu desenvolvemento. Gran parte do código vai ser idéntico dunha versión a outra, e pode que os parches que xere funcionen. Porén, a póla principal (trunk) é onde se realizan a maior parte dos cambios, e as pólas estables son principalmente para as tarefas de mantemento e a solución de erros.


KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V.Legal