Archive:Getting Started (zh TW): Difference between revisions

    From KDE TechBase
    No edit summary
    m (AnneW moved page Getting Started (zh TW) to Archive:Getting Started (zh TW) without leaving a redirect: Obsolete)
     
    (9 intermediate revisions by 2 users not shown)
    Line 1: Line 1:
    {{Template:I18n/Language Navigation Bar|Getting_Started}}
     
    {{Box|取得原始碼|
    == 決定您的需求==
    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/Using Project Neon to contribute to KDE|使用Project Neon來對KDE作出些貢獻]]
    * [[Getting_Started/Sources/Anonymous SVN|匿名 SVN 快速使用指南]]
    * [[Getting_Started/Sources/Anonymous SVN|匿名SVN快速使用指南]]
    * [[Getting_Started/Sources/Using Subversion with KDE|KDE 下使用 Subversion]]''更進一步的使用 subversion 來訪問 KDE 的原始碼,包括原始碼庫的修訂及補丁的排版和工作方式。''
    * [[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/Snapshots|每日開發快照]]
    * [[Getting_Started/Sources/Snapshots|每日開發快照]]
    * [http://websvn.kde.org/ 線上瀏覽程式碼]
    * [http://websvn.kde.org/ 線上瀏覽程式碼]或[http://lxr.kde.org/search 搜尋程式碼]
    |100%}}
     
    == 建構 ==
     
    ; Manual Steps
    * [[Getting_Started/Build/KDE4_(zh_TW)|KDE 4(開發版本,TRUNK)]]
    * [[Getting_Started/Build/KDE4.x|KDE 4.x(穩定版本或 4.x SVN BRANCH)]]
    * [[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]]
    * [[Getting_Started/Increased Productivity in KDE4 with Scripts|在 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.


    {{Box|建構 KDE|
    [[Image:Action_tool.svg|right|32px]]
    [[Image:Action_tool.svg|right|32px]]
    KDE有各種分支版本。若您是以生產為目的,我們推薦使用KDE的穩定版本。
    * [[Contribute|貢獻]]
    * [[Getting_Started/Build/KDE4 (zh TW)|KDE 4 (開發版本,TRUNK)]]
    * [[Contribute/Send_Patches|提交補丁]]
    * [[Getting_Started/Build/KDE4.x|KDE 4.x (目前 4.x 發行版或 4.x SVN BRANCH)]]
    * [[Contribute/Bugsquad|Bugsquad]]
    * [[Getting_Started/Build/Stable Version|KDE 3.5 (穩定版本)]]
    * [[Getting_Started/Using Project Neon to contribute to KDE_(zh_TW)|使用 Project Neon 來對 KDE 作出些貢獻]]
    * [[Getting_Started/Build (zh TW)|其他版本及FAQ]] ''含其他非linux系統的建立資訊''
    * [[Getting_Started/EasyStartDevelopmentOnDebian | Build, change and run packaged KDE applications on Debian]]
    |100%}}


    {{Box|設定環境|
    [[Category:Build_KDE]]
    [[Image:Action_pen.svg|right|32px]]
    在建構完KDE後,您會想要依照自己的方式來啟動應用程式,以及執行常用的開發環境:
    * [[Getting_Started/Increased Productivity in KDE4 with Scripts|在KDE4中使用腳本提高生產力]]
    * [[Getting_Started/Set up KDE 4 for development|設定開發用的KDE 4]]
    |100%}}
    [[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.

    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/

    建構

    Manual Steps
    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.