Home Explore Help
Register Sign In
samien
/
RakNet
1
0
Fork 0
Files Issues 0 Pull Requests 0 Wiki
Tree: d4414eeec5
Branches Tags
RakNet
/
Help
/
compilersetup_xcode.html

compilersetup_xcode.html 7.8 KB
History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172 
  1. <HTML>
    2. 

  2. <HEAD>
    3. 

  3. <TITLE>Compiler Setup (Xcode)</TITLE>
    4. 

  4. <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"></HEAD>
    5. 

  5. <link href="RaknetManual.css" rel="stylesheet" type="text/css">
    6. 

  6. <meta name="title" content="RakNet - Advanced multiplayer game networking API">
    7. 

  7. </HEAD>
    8. 

  8. <BODY BGCOLOR="#ffffff" LINK="#003399" vlink="#003399" alink="#003399" LEFTMARGIN="0" TOPMARGIN="0" MARGINWIDTH="0" MARGINHEIGHT="0"">
    9. 

  9. <img src="RakNet_Icon_Final-copy.jpg" alt="Oculus VR, Inc." width="150" height="150"><BR>
    10. 

  10. <BR>
    11. 

  11. 

  12. <table width="100%" border="0"><tr><td bgcolor="#2c5d92" class="RakNetWhiteHeader">
    13. 

  13. <img src="spacer.gif" width="8" height="1">Xcode notes</td>
    14. 

  14. </tr></table>
    15. 

  15. 

  16. <TABLE BORDER="0" CELLPADDING="10" CELLSPACING="0" WIDTH="100%">
    17. 

  17. <TR>
    18. 

  18. <TD>
    19. 

  19. 

  20. Although Raknet is cross-platform, not all of the samples provided will compile/run on Mac OS X or iOS.
    21. 

  21. Here I'll show you how to compile Raknet for Mac OS X and iOS, along with one of the samples for testing
    22. 

  22. <br><br>
    23. 

  23. </TD></TR></TABLE>
    24. 

  24. 

  25. <table width="100%" border="0"><tr><td bgcolor="#2c5d92" class="RakNetWhiteHeader">
    26. 

  26. <img src="spacer.gif" width="8" height="1">Compiling as a static library for Mac OS X</td>
    27. 

  27. </tr></table>
    28. 

  28. 

  29. <TABLE BORDER="0" CELLPADDING="10" CELLSPACING="0" WIDTH="100%"><TR><TD>
    30. 

  30.   <p class="RakNetBlueHeader">Create an empty workspace</p>
    31. 

  31.   <ol>
    32. 

  32.   <li>Create a folder named <i>RakNetTests</i>, and then create a new empty Workspace. Name it <i>RakNetTests</i>, and save it inside the new folder<BR><BR>
    33. 

  33.   <IMG SRC="xcode_newworkspace.jpg"><BR><BR>
    34. 

  34.   </li>
    35. 

  35.   </ol>
    36. 

  36. 

  37.   <p class="RakNetBlueHeader">Create the RakNet static library project</p>
    38. 

  38.   <ol>
    39. 

  39.   <li>
    40. 

  40.   Using <i>File->New->New Project</i>, create a new Mac OS X C/C++ library project<BR><BR>
    41. 

  41.   <A HREF="xcode_library.jpg"><IMG SRC="xcode_librarysmall.jpg"></A><BR><BR>
    42. 

  42.   Name it <i>RakNet</i> and use the following options:<BR>
    43. 

  43.   <IMG SRC="xcode_libraryname.jpg"><BR>
    44. 

  44.   Save it inside the same folder as the workspace<BR><BR>
    45. 

  45.   </li>
    46. 

  46.   
    47. 

  47.   <li>Using Finder, copy RakNet's source code (<i>Source</i> folder) to where RakNet project file was created<BR><BR>
    48. 

  48.   <IMG SRC="xcode_sourcefolder.jpg">
    49. 

  49.   <BR><BR>
    50. 

  50.   </li>
    51. 

  51.   <li>
    52. 

  52.   Right-click the <i>RakNet</i> project, and select <i>Add Files to "RakNet"...</i> ,
    53. 

  53.   and select the new <i>Source</i> folder you should have in the same folder as the <i>RakNet</i> 
    54. 

  54.   Project file. Use the following options:<BR><BR>
    55. 

  55.   <IMG SRC="xcode_addfiles.jpg"><BR><BR>
    56. 

  56.   This should create a <i>Source</i> group, like this:<BR>
    57. 

  57.   <IMG SRC="xcode_addfiles_newgroup.jpg"><BR><BR>
    58. 

  58.   </li>
    59. 

  59.   
    60. 

  60.   <li>
    61. 

  61.   The <font color="red">files inside the <i>cat</i> folder aren't supposed to be compiled</font>, so remove the <i>Source/cat</i> group from the project files.<br>
    62. 

  62.   When prompted for the deletion method, pick <strong><i>Remove References Only</i></strong>.<BR>
    63. 

  63.   <IMG SRC="xcode_remove_cat.jpg"><BR><BR>
    64. 

  64.   </li>
    65. 

  65.   
    66. 

  66.   <li>
    67. 

  67.   Build Raknet using <i>Product->Build</i><BR>
    68. 

  68.   You should get a successful compilation.
    69. 

  69.   </li>
    70. 

  70. 

  71.   </ol>
    72. 

  72.   </TD></TR>
    73. 

  73. </TABLE>
    74. 

  74. 

  75. 

  76. <table width="100%" border="0"><tr><td bgcolor="#2c5d92" class="RakNetWhiteHeader">
    77. 

  77. <img src="spacer.gif" width="8" height="1">Testing the static library</td>
    78. 

  78. </tr></table>
    79. 

  79. 

  80. <TABLE BORDER="0" CELLPADDING="10" CELLSPACING="0" WIDTH="100%"><TR><TD>
    81. 

  81.   <p class="RakNetBlueHeader">A simple sample...</p>
    82. 

  82.   For testing, we're going to use the sample <i>"Chat Example"</i> provided with the Raknet. You can find it the <i>"Samples/Chat Example"</i> folder.
    83. 

  83.   This sample has 2 source files, named <i>"Chat Example Server.cpp"</i> and <i>"Chat Example Client.cpp"</i>.
    84. 

  84.   We are going to create two projects from those files (one project for the Server, and another for the Client).
    85. 

  85. 

  86.   <BR><BR>
    87. 

  87.   Inside the folder where you have your workspace, create another folder named <i>Samples</i>, 
    88. 

  88.   and copy <i>"Chat Example Server.cpp"</i> and <i>"Chat Example Client.cpp"</i> into that folder.<BR><BR>
    89. 

  89.   
    90. 

  90.   <p class="RakNetBlueHeader">The server</p>
    91. 

  91.   <ol>
    92. 

  92.   <li>Create a <i>Command Line Tool</i> project for the Server:<BR>
    93. 

  93.   <IMG SRC="xcode_newcommandlinetool.jpg"><BR>
    94. 

  94.   In the next window where it asks for the options for your new project, name it <i>ChatExampleServer</i>, 
    95. 

  95.   leave <i>Type</i> as <i>C++</i>, and <i>"Use Automatic Reference Counting"</i> unchecked.<BR>
    96. 

  96.   Save the project inside your <i>Samples</i> folder.<BR><BR>
    97. 

  97.   <li>
    98. 

  98.   Inside the newly created ChatExampleServer, you should have a group named <i>ChatExampleServer</i>.
    99. 

  99.   Delete the <i>main.cpp</i> you'll find inside that group, and add the <i>"Chat Example Server.cpp"</i> file<BR><BR>
    100. 

  100.   </li>
    101. 

  101. 

  102.   <li>
    103. 

  103.   Specify where to look for the RakNet header files, by changing the Build Settings of the ChatExampleServer project.
    104. 

  104.   This can be done in the <strong><i>Header Search Paths</i></strong> option, under the <strong><i>Search Paths</i></strong> section:<BR>
    105. 

  105.   <IMG SRC="xcode_headersearchpaths.jpg"><BR>
    106. 

  106.   If your folder structure is exactly the same as the one used for this tutorial, then the search path
    107. 

  107.   should be what you see in the above image. If not then you need to adjust it accordingly.<BR>
    108. 

  108.   <strong>NOTE:</strong> The search path is relative to the project file's location.<BR><BR>
    109. 

  109.   </li>
    110. 

  110.   
    111. 

  111.   <li>
    112. 

  112.   Link <i>ChatExampleServer</i> project with our RakNet static library, by going to <strong><i>Build Phases</i></strong>, section
    113. 

  113.   <strong><i>Link Binary With Libraries</i></strong>, clicking the <strong>'+'</strong> button and picking our RakNet library as shown:<BR>
    114. 

  114.   <IMG SRC="xcode_linkwithlibrary.jpg"><BR><BR>
    115. 

  115.   </li>
    116. 

  116.   <li>
    117. 

  117.   You should be able to successfully build and run the Server now.<BR>
    118. 

  118.   </li>
    119. 

  119.   </ol>
    120. 

  120.   
    121. 

  121.    <p class="RakNetBlueHeader">The Client</p>
    122. 

  122.   The steps to create the client project are the same as the ones for the Server:
    123. 

  123.   <ol>
    124. 

  124.   <li>Create a <i>"Command Line Tool"</i> project, and name it <i>ChatExampleClient</i></li>
    125. 

  125.   <li>Delete the file <i>main.cpp</i> and add the file <i>"Chat Example Client.cpp"</i></li>
    126. 

  126.   <li>Change the C/C++ compiler to <strong><i>LLVM GCC</i></strong></li>
    127. 

  127.   <li>Set the header search paths</li>
    128. 

  128.   <li>Add <i>RakNet</i> library to the list of libraries to link with.</li>
    129. 

  129.   </ol>
    130. 

  130. 

  131.    <p class="RakNetBlueHeader">Running the sample</p>
    132. 

  132.    You should now have 2 products ready to run (ChatExampleClient and ChatExampleServer). You can run
    133. 

  133.    one of them from inside Xcode, and run the other externally by right-clicking on it and selecting 
    134. 

  134.    <strong>"Open With External Editor"</strong>.
    135. 

  135.   
    136. 

  136. </TD></TR></TABLE>
    137. 

  137. 

  138. <table width="100%" border="0"><tr><td bgcolor="#2c5d92" class="RakNetWhiteHeader">
    139. 

  139. <img src="spacer.gif" width="8" height="1">Compiling as a static library for iOS</td>
    140. 

  140. </tr></table>
    141. 

  141. <br>
    142. 

  142. <TABLE BORDER="0" CELLPADDING="10" CELLSPACING="0" WIDTH="100%"><TR><TD>
    143. 

  143. 

  144. Compiling Raknet as a static library for iOS is essentially the same as for Mac OS X.<br>
    145. 

  145. You can create a new project for the iOS library, or you can just create another Target for your Mac OS X
    146. 

  146. static library project, and change what SDK to use:<br><br>
    147. 

  147. <img src="xcode_changesdk.jpg">
    148. 

  148. <br>
    149. 

  149. <br>
    150. 

  150. You can find some iOS samples in the <strong>Samples/iOS</strong> folder.<br><br>
    151. 

  151. <br>
    152. 

  152. </TD></TR>
    153. 

  153. </TABLE>
    154. 

  154. 

  155. <table width="100%" border="0"><tr><td bgcolor="#2c5d92" class="RakNetWhiteHeader">
    156. 

  156. <img src="spacer.gif" width="8" height="1">See Also</td>
    157. 

  157. </tr></table>
    158. 

  158. <TABLE BORDER="0" CELLPADDING="10" CELLSPACING="0" WIDTH="100%"><TR><TD>
    159. 

  159. 

  160.   <p><A HREF="index.html">Index</A><BR>
    161. 

  161.      <A HREF="dependencies.html">3rd party dependencies</A><BR>
    162. 

  162.     <A HREF="introduction.html">Introduction</A><BR>
    163. 

  163.     <A HREF="systemoverview.html">System Overview</A><BR>
    164. 

  164.     <A HREF="detailedimplementation.html">Detailed Implementation</A><BR>
    165. 

  165.     <A HREF="tutorial.html">Tutorial</A><BR>
    166. 

  166.     <A HREF="preprocessordirectives.html">Preprocessor directives</A><BR>
    167. 

  167.   </p></TD></TR></TABLE>
    168. 

  168. 

  169. 

  170. 

  171. </BODY>
    172. 

  172. </HTML>
    173.
粤ICP备19079148号