Archive:Getting Started (zh TW): Difference between revisions
No edit summary |
m (AnneW moved page Getting Started (zh TW) to Archive:Getting Started (zh TW) without leaving a redirect: Obsolete) |
||
(5 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
== 決定您的需求== | |||
KDE versions are split into branches off of the Trunk. The steps to build most branches are very similar. However, each branch has different [[Getting_Started/Build/KDE4/Prerequisites_(zh_TW)|prerequisites]]. | |||
You will need to know what version you want, how often you will use the development environment (more work upfront may be justified if you intend to use it more). | |||
Our content is generally written with KDE4 and Linux in mind. For Windows, BSD, and KDE3 look at the [[Getting_Started/Build_(zh_TW)|other Supported Platforms]] page. | |||
== [[Choose Version|選擇版本]] == | |||
; Distribution synchronized | |||
: To ease finding dependencies, See [[Distributions with KDE]], or you may have a requirement to support a version supplied by a vendor. | |||
: As a developer looking to develop a patch against an existing application, you might want to look at [[Getting_Started/EasyStartDevelopmentOnDebian | this]]. | |||
; Latest Features for production | |||
: [[branch]] (stable / beta) | |||
; Core Development | |||
: [[trunk]] Where new features grow (may have build problems on Mondays) | |||
;Browse availability: | |||
:http://websvn.kde.org/branches/KDE/ | |||
== 選擇位置 == | |||
Choose where you want to put the KDE installation, and keep source and build directories. | |||
(The [[QCA plugin]] may have to be installed as root if using system Qt). | |||
===原始碼與建構目錄=== | |||
: suggested: ~/kde/src and ~/kde/build (where ~ is the home directory of the user who runs KDE) | |||
: possibly /usr/src/ if [[building as root]]. | |||
===安裝目錄=== | |||
;[[Casual Curiosity]] | |||
: [[development user home]] if you do not want to mess up your production KDE | |||
: [[your home directory]] if you are willing to use environment variables to keep versions separate (using [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|scripts]]) or have no other access to the machine | |||
: [[As root]] not advised unless you have a dedicated machine | |||
; [[Application Developer]] | |||
: [[development user home]] same as for curious user | |||
: [[as root]] will be more useful to simulate environment of customers | |||
: [[your home directory]] may simplify your development | |||
; [[Distribution Manager]] | |||
: To test KDM, you may want to install [[as root]] and/or on a [[Getting_Started/Build/KDE4/on_virtual_machines|virtual machine]] so you do not damage a production system. | |||
; [[Contributor]] | |||
: keeping your system similar to other developers will help make troubleshooting easier, see [[Developer Setups]] | |||
== 收集事前需求 == | |||
Your build will fail if you are missing one of them, and the list changes. There are some options, however the make system can often find optional packages even if you do not intend to use them, so you may need to pass disable options. | |||
* [[Getting_Started/Build/KDE4/Prerequisites]] | |||
* [[build requirements]] by distribution | |||
===Qt === | |||
; 系統 Qt | |||
: Often the easiest way to go, because most people have it already, you may have to install the QCA plugin as root though. | |||
; KDE-Qt | |||
:Previously known as qt-copy -- This is the minimum version of Qt any of your users are expected to have. Some bugs may be fixed in new Qt, so you may have to work-around bugs in lower versions, including this one. | |||
; Main Qt | |||
: Get it straight from Nokia, experience the latest cool features, but note that many people will be using older distributions with older Qt. | |||
==取得原始碼== | |||
We are migrating from SVN to git. We have extensive infrastructure that is being converted, but please know that this is a much anticipated, complex, and popular change. http://www.omat.nl/2010/07/07/move-to-git-the-progress-so-far/ | |||
[[Image:Action_down.svg|right|32px]] | [[Image:Action_down.svg|right|32px]] | ||
* [[Getting_Started/Sources/Anonymous SVN|匿名 SVN 快速使用指南]] | * [[Getting_Started/Sources/Anonymous SVN|匿名 SVN 快速使用指南]] | ||
* [[Getting_Started/Sources/Using Subversion with KDE|KDE 下使用 Subversion]]'' | * [[Getting_Started/Sources/Using Subversion with KDE|KDE 下使用 Subversion]]''更進一步的使用 subversion 來訪問 KDE 的原始碼,包括原始碼庫的修訂及補丁的排版和工作方式。'' | ||
* [[Getting_Started/Sources/Amarok Git Tutorial|Amarok Git 教學]] ''Amarok 已經轉移到 Git(KDE其餘的程式將跟進),因此需要不同的步驟來查看和開發。'' | * [[Getting_Started/Sources/Amarok Git Tutorial|Amarok Git 教學]] ''Amarok 已經轉移到 Git(KDE其餘的程式將跟進),因此需要不同的步驟來查看和開發。'' | ||
* [[Getting_Started/Sources/Snapshots|每日開發快照]] | * [[Getting_Started/Sources/Snapshots|每日開發快照]] | ||
* [http://websvn.kde.org/ 線上瀏覽程式碼]或[http://lxr.kde.org/search 搜尋程式碼] | * [http://websvn.kde.org/ 線上瀏覽程式碼]或[http://lxr.kde.org/search 搜尋程式碼] | ||
== 建構 == | |||
[[ | |||
; Manual Steps | |||
* [[Getting_Started/Build/KDE4 | * [[Getting_Started/Build/KDE4_(zh_TW)|KDE 4(開發版本,TRUNK)]] | ||
* [[Getting_Started/Build/KDE4.x|KDE 4.x | * [[Getting_Started/Build/KDE4.x|KDE 4.x(穩定版本或 4.x SVN BRANCH)]] | ||
* [[Getting_Started/Build (zh TW)| | * [[Getting_Started/Build/KDE4.x Upgrade|Upgrade KDE-4.x.y release version or KDE-4.x SVN BRANCH)]] | ||
| | * [[Getting_Started/Build (zh TW)|其他版本及 FAQ]] ''包含其他非 linux 系統的建構資訊'' | ||
; augmented with bash functions. | |||
:[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts]] | |||
:Specific examples:[[Build KDE4.6 on Kubuntu]] | |||
; distribution specific | |||
There may be pre-made builds for your distribution, For example, in Kubuntu, Project Neon, aims to provide a recent trunk build environment, and PPA's provide latest branch versions. | |||
; kdesrc-build | |||
This script will do most of the downloading and compiling for you. It can be configured to build most versions, by default it builds Trunk. There full-process instructions at http://kdesrc-build.kde.org and more here [[Getting_Started/Build/kdesrc-build|kdesrc-build]], and here is a list of [[kdesrc-build/workingrclist|working configuration files]]. | |||
=== 建構疑難排解 === | |||
* [[Getting_Started/Build/KDE4/Troubleshooting|疑難排解]] | |||
[[Getting_Started/Build/KDE4/Troubleshooting|Troubleshooting]] information is similar between branches as well. | |||
Compile and Linking errors are frequent sources of discouragement. Make careful note of the first occurrence of an error in your build process. It could be as simple as a bad environment variable, an unexpected version of a library or missing prerequisite. | |||
Please review your logs and do searches for fixes. If you cannot find a solution, try [[Build/KDE4/Errors]], the IRC channel, and the mailing lists. [[Build/Stories]] | |||
==使用你的 KDE== | |||
After KDE has been built, you'll want a good way to launch apps and perform your regular development tasks: | |||
=== 環境變數 === | |||
Your system won't know to use your new KDE until you tell it how to find the KDE applications and libraries. | |||
[[Image:Action_pen.svg|right|32px]] | [[Image:Action_pen.svg|right|32px]] | ||
* [[Getting_Started/Increased Productivity in KDE4 with Scripts|在 KDE 4 中使用腳本提高生產力]] | * [[Getting_Started/Increased Productivity in KDE4 with Scripts|在 KDE 4 中使用腳本提高生產力]] | ||
* [[Getting_Started/Set up KDE 4 for development_(zh_TW)|建立開發用的 KDE 4]] | * [[Getting_Started/Set up KDE 4 for development_(zh_TW)|建立開發用的 KDE 4]] | ||
| | |||
[[ | ===建立開發工具=== | ||
You may need to set up or use, you will likely want to use a stable package from your distribution. | |||
it is unclear if the kde-devel user or your normal user will be running the development tools. Please Help | |||
For most development topics, and documentation, see [[Development_(zh_TW)|Development]] | |||
; Opening and creating KDE project files | |||
* [[eclipse]] | |||
* [[kdevelop]] | |||
* [[Development/Tutorials/Using_Qt_Designer|qtdesigner]] | |||
This is a stub, please help. | |||
===貢獻=== | |||
You may not need the latest bleeding-edge version of KDE with which to develop. Much of the code will be similar between versions and your patch might work. However, Trunk is where major changes are introduced, and branches are mostly for maintenance/bug fixes. | |||
[[Image:Action_tool.svg|right|32px]] | |||
* [[Contribute|貢獻]] | |||
* [[Contribute/Send_Patches|提交補丁]] | |||
* [[Contribute/Bugsquad|Bugsquad]] | |||
* [[Getting_Started/Using Project Neon to contribute to KDE_(zh_TW)|使用 Project Neon 來對 KDE 作出些貢獻]] | |||
* [[Getting_Started/EasyStartDevelopmentOnDebian | Build, change and run packaged KDE applications on Debian]] | |||
[[Category:Build_KDE]] |
Latest revision as of 13:13, 23 June 2013
決定您的需求
KDE versions are split into branches off of the Trunk. The steps to build most branches are very similar. However, each branch has different prerequisites.
You will need to know what version you want, how often you will use the development environment (more work upfront may be justified if you intend to use it more).
Our content is generally written with KDE4 and Linux in mind. For Windows, BSD, and KDE3 look at the other Supported Platforms page.
選擇版本
- Distribution synchronized
- To ease finding dependencies, See Distributions with KDE, or you may have a requirement to support a version supplied by a vendor.
- As a developer looking to develop a patch against an existing application, you might want to look at this.
- Latest Features for production
- branch (stable / beta)
- Core Development
- trunk Where new features grow (may have build problems on Mondays)
- Browse availability
- http://websvn.kde.org/branches/KDE/
選擇位置
Choose where you want to put the KDE installation, and keep source and build directories. (The QCA plugin may have to be installed as root if using system Qt).
原始碼與建構目錄
- suggested: ~/kde/src and ~/kde/build (where ~ is the home directory of the user who runs KDE)
- possibly /usr/src/ if building as root.
安裝目錄
- Casual Curiosity
- development user home if you do not want to mess up your production KDE
- your home directory if you are willing to use environment variables to keep versions separate (using scripts) or have no other access to the machine
- As root not advised unless you have a dedicated machine
- Application Developer
- development user home same as for curious user
- as root will be more useful to simulate environment of customers
- your home directory may simplify your development
- Distribution Manager
- To test KDM, you may want to install as root and/or on a virtual machine so you do not damage a production system.
- Contributor
- keeping your system similar to other developers will help make troubleshooting easier, see Developer Setups
收集事前需求
Your build will fail if you are missing one of them, and the list changes. There are some options, however the make system can often find optional packages even if you do not intend to use them, so you may need to pass disable options.
- Getting_Started/Build/KDE4/Prerequisites
- build requirements by distribution
Qt
- 系統 Qt
- Often the easiest way to go, because most people have it already, you may have to install the QCA plugin as root though.
- KDE-Qt
- Previously known as qt-copy -- This is the minimum version of Qt any of your users are expected to have. Some bugs may be fixed in new Qt, so you may have to work-around bugs in lower versions, including this one.
- Main Qt
- Get it straight from Nokia, experience the latest cool features, but note that many people will be using older distributions with older Qt.
取得原始碼
We are migrating from SVN to git. We have extensive infrastructure that is being converted, but please know that this is a much anticipated, complex, and popular change. http://www.omat.nl/2010/07/07/move-to-git-the-progress-so-far/
- 匿名 SVN 快速使用指南
- KDE 下使用 Subversion更進一步的使用 subversion 來訪問 KDE 的原始碼,包括原始碼庫的修訂及補丁的排版和工作方式。
- Amarok Git 教學 Amarok 已經轉移到 Git(KDE其餘的程式將跟進),因此需要不同的步驟來查看和開發。
- 每日開發快照
- 線上瀏覽程式碼或搜尋程式碼
建構
- Manual Steps
- KDE 4(開發版本,TRUNK)
- KDE 4.x(穩定版本或 4.x SVN BRANCH)
- Upgrade KDE-4.x.y release version or KDE-4.x SVN BRANCH)
- 其他版本及 FAQ 包含其他非 linux 系統的建構資訊
- augmented with bash functions.
- Getting_Started/Increased_Productivity_in_KDE4_with_Scripts
- Specific examples:Build KDE4.6 on Kubuntu
- distribution specific
There may be pre-made builds for your distribution, For example, in Kubuntu, Project Neon, aims to provide a recent trunk build environment, and PPA's provide latest branch versions.
- kdesrc-build
This script will do most of the downloading and compiling for you. It can be configured to build most versions, by default it builds Trunk. There full-process instructions at http://kdesrc-build.kde.org and more here kdesrc-build, and here is a list of working configuration files.
建構疑難排解
Troubleshooting information is similar between branches as well.
Compile and Linking errors are frequent sources of discouragement. Make careful note of the first occurrence of an error in your build process. It could be as simple as a bad environment variable, an unexpected version of a library or missing prerequisite.
Please review your logs and do searches for fixes. If you cannot find a solution, try Build/KDE4/Errors, the IRC channel, and the mailing lists. Build/Stories
使用你的 KDE
After KDE has been built, you'll want a good way to launch apps and perform your regular development tasks:
環境變數
Your system won't know to use your new KDE until you tell it how to find the KDE applications and libraries.
建立開發工具
You may need to set up or use, you will likely want to use a stable package from your distribution.
it is unclear if the kde-devel user or your normal user will be running the development tools. Please Help
For most development topics, and documentation, see Development
- Opening and creating KDE project files
This is a stub, please help.
貢獻
You may not need the latest bleeding-edge version of KDE with which to develop. Much of the code will be similar between versions and your patch might work. However, Trunk is where major changes are introduced, and branches are mostly for maintenance/bug fixes.