build_platform.adoc 2.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667
  1. = build_platform
  2. :revnumber: 2.0
  3. :revdate: 2020/07/10
  4. :keywords: documentation, sdk, builds, project
  5. == Building jMonkeyEngine SDK Yourself
  6. === In the jMonkeyEngine SDK or NetBeans
  7. ==== Plugins
  8. Make sure all necessary plugins are installed and active:
  9. * From the menu bar, select `Tools` → `Plugins` to open a `Plugins` dialog.
  10. * Select the `Available Plugins` tab.
  11. * Sort the plugin list by category.
  12. * Check the `Install` checkbox for any plugins in the `Developing NetBeans` category.
  13. * Click on the `Install` button and complete the wizard.
  14. * Select the `Installed` tab.
  15. * Activate any inactive plugins in the `Developing NetBeans` category.
  16. * Close the `Plugins` dialog.
  17. ==== Checkout
  18. * From the menu bar, select `Team` → `Git` → `Clone` to open a `Clone Repository` dialog.
  19. * In the `Repository +++<abbr title="Uniform Resource Locator">URL</abbr>+++:` textbox, type `link:https://github.com/jMonkeyEngine/jmonkeyengine[https://github.com/jMonkeyEngine/jmonkeyengine]`.
  20. * Clear the `User:` and `Password:` textboxes.
  21. * Click on the `Next` button.
  22. * Choose the remote branch, typically "`master`", and click the Next button.
  23. * Click on the `Browse…` button to the right of the `Parent directory:` textbox to open a `Browse Local Folder` dialog.
  24. * Select an empty or non-existent directory (folder) where you want to save the jMonkeyEngine sources on your hard drive.
  25. * Click the `Finish` button.
  26. Project checkout may take awhile. Do not proceed before the task is complete.
  27. ==== Build
  28. On the commandline:
  29. . `cd jmonkeyengine`
  30. . `./gradlew build`
  31. From the SDK:
  32. * From the menu bar, select `File` → `Open project…` to open an `Open Project` dialog.
  33. * Highlight the free-form project folder you used for checkout and click on the `Open Project` button.
  34. ** A new free-form project named `jME3-SDK` should appear in the SDK's `Projects` window.
  35. * Build the free-form project by right-clicking on it and selecting `Build`.
  36. * Wait until the `jME3-SDK (build)` task is complete. At one point, a web browser window may open.
  37. * From the menu bar, select `File` → `Open project…` to open an `Open Project` dialog.
  38. * Browse into the free-form project folder, highlight the `sdk` node, and click on the `Open Project` button.
  39. ** A number of new projects should appear in the SDK's `Projects` window.
  40. Building the main freeform project copies the jME3 libraries to the sdk, so you should run its build script each time jME3 changes.
  41. ==== Run
  42. * In the SDK's `Projects` window, right-click on the `jMonkeyEngine SDK` project and select `Run`.
  43. ** The SDK you just built will start executing in a new window.