Note: This website is archived. For up-to-date information about D projects and development, please visit wiki.dlang.org.

Changes between Version 8 and Version 9 of GettingStarted

Show
Ignore:
Author:
zzzzrrr (IP: 98.218.6.102)
Timestamp:
03/15/09 15:15:07 (15 years ago)
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GettingStarted

    v8 v9  
    1 = '''Getting Started'''
     1= Step 1: Compiler install
    22 
    3 Editing this page in detail is on the TODO list.   
     3First, it's recommended you start with the the Tango variant of the [http://www.dsource.org/projects/tango/wiki/DmdDownloads dmd] compiler.  Linux users may also want to consider the new [http://www.dsource.org/projects/ldc ldc] compiler. [http://www.digitalmars.com/d/download.html Phobos] fans can still use Blaze, although you will not be able to compile the testbed examples because of Tango dependencies. 
    44 
    5 For help compiling, please ask in the [http://www.dsource.org/forums/viewforum.php?f=187 forum][[BR]] 
    6 For help with engine features, see the [http://www.box2d.org/wiki/index.php?title=Main_Page Box2D Wiki] 
     5Make sure you remember to add '''<install location>/dmd/bin''' to your system path. 
    76 
    8 = Library Dependencies
     7= Step 2: Install a build tool
    98 
    10 Fortunately, Blaze is library independent!!! 
     9Fortunately, the Windows Tango package includes an excellent tool called jake. Linux users will want to install rebuild, which is included with the [http://www.dsource.org/projects/dsss dsss] package.  Windows users can also install dsss, although jake will work fine. 
    1110 
    12 However, the testbed demos require the following tools: 
    13 * [http://www.dsource.org/projects/tango Tango] 
    14 * [http://hybrid.team0xf.com/ Hybrid] 
     11Again, if you choose to use rebuild, make sure you add '''<install location>/dsss/bin''' to your system path. 
    1512 
     13= Step 3: Install Blaze = 
     14 
     15Checkout a working copy with [http://subversion.tigris.org/ Subversion]. 
     16 
     17For most purposes, you way want to consider creating an active working directory where you will maintain all of your libraries and projects.  For example, windows users should create something like `c:\workspace\` and on Linux, something like `~/workspace` 
     18[[BR]] 
     19 
     20Checkout the source files: 
     21{{{ 
     22cd workspace 
     23svn co http://svn.dsource.org/projects/blaze/trunk blaze 
     24}}} 
     25 
     26To update: 
     27{{{ 
     28cd <install location>/workspace/blaze 
     29svn up 
     30}}} 
     31 
     32= Step 4: Compile hello world = 
     33 
     34Ok, you've made it this far without destroying your computer in frustration... Now comes the easy park! 
     35 
     36{{{ 
     37cd workspace/blaze/examples/helloWorld 
     38}}} 
     39 
     40Windows w/ jake: 
     41{{{ 
     42jake -I../../ helloWorld.d 
     43}}} 
     44 
     45Windows or Linux with rebuild: 
     46 
     47{{{ 
     48rebuild -I../../ helloWorld.d 
     49}}} 
     50 
     51That's it! If you've make it this far as a D noob, congrats! You've already overcome the most difficult part of learning the D Programming Language: installing the compiler tools! Coding in D is a breeze.... 
     52 
     53= Step 5: Compile the testbed examples = 
     54 
     55Ok, Phobos fanboys can stop here.  The testbed examples have Tango dependencies and you will not be able to compile.  
     56 
     57First, you will need to install [http://www.selenic.com/mercurial/wiki/ Mercurial]. Next head over to team0xf and install their excellent set of library [http://hybrid.team0xf.com/wiki/Main/GettingStarted tools]. 
     58 
     59Make sure you install everything into `<install path>/workspace/xf` 
     60 
     61When finished, you should have a directory structure that looks something (Windows example) like this: 
     62{{{ 
     63c:\workspace\blaze 
     64c:\workspace\xf  
     65}}} 
     66 
     67The testbed framework includes a number of build scripts, so they should be fairly easy to compile. 
     68{{{ 
     69cd workspace\blaze\examples\testBed\framework 
     70}}} 
     71 
     72On Windows, run the included batch file to compile: 
     73{{{ 
     74build-dmd-win.bat 
     75}}} 
     76 
     77On Linux, try this: 
     78{{{ 
     79chmod a+x build-dmd.sh 
     80./build-dmd.sh 
     81}}} 
     82 
     83Now sit back and wait for it to compile. If it's your first time, it may take a few minutes. Run the `main` binary when it's finished, and have fun! 
     84 
     85= For Help = 
     86 
     87Sign up for a dsource account, and ask for help in the forum. 
     88