For more documentation, please refer to haxe.org
Currently haxelib has two ways to have project local setups.
- Using
haxelib newrepo
- Using
haxelib install all
When using haxelib newrepo
you can have a project-local haxelib repository. This feature is quite new and a little rough around the edges.
Caveats:
- if you mistakenly run a haxelib command in a subdirectory of your project, it will be executed on the global repo (to be fixed)
- there may be some issues with
haxelib run
andhaxelib selfupdate
(to be fixed) - libraries get downloaded for each project
- it requires a recent Haxe version (after 3.1.3) to work properly with ndlls.
Haxe allows you to define specific versions of the libraries you want to use with -lib <libname>:<version>
. If you make sure to use this in all your hxmls, then haxelib install all --always
(the --always
avoiding you being prompted for confirmation) will be able to ensure the libraries your project needs are available in the necessary versions. If in fact you run this in a checkout hook, your get to track your dependencies in your git repo (some other VCSs should allow for a similar setup), allowing you to have a well defined and replicable setup for any state (commit/branch/etc.).
Disadvantages:
- the approach requires you to define all dependencies with specific versions and then running
haxelib install all
to grab them - with this approach, any other project that does not have specific versions defined may be affected, as under some circumstances
haxelib install all
may set the global "current" version of the libraries (to be fixed)
Advantages:
- as pointed out above, this approach allows defining a versionable and replicable state.
- you don't have to download libraries for each project, which does make a difference for heavy weights like openfl and hxcpp
Because you cannot specify git versions with -lib
paremeters, we suggest using git submodules instead, as again they provide an adequate way of definining a versionable and replicable state.
You can of course combine both approaches, giving you the isolation provided by the first one, and the replicability provided by the second one.
A solution that combines the strengths of both approaches is in the making. Stay tuned.
# Initial checkout
git clone https://github.com/HaxeFoundation/haxelib
# Change to the checkout directory
cd haxelib
# Install all the libs
haxelib install newsite.hxml
# Create directories
mkdir -p www/legacy
mkdir -p www/api/3.0
mkdir -p www/files/3.0
# TODO: copy assets
# Compile the site
haxe legacysite.hxml
haxe newsite.hxml
# TODO: check the permissions, writeable directories etc.
# Start the server
nekotools server -rewrite
Build files:
- haxelib.hxml: Build the current haxelib tool from src/haxelib/Main
- legacyhaxelib.hxml: Build the haxelib tool that works with Haxe 2.x
- legacysite.hxml: Build the legacy website.
- prepare.hxml: Build a tool to prepare the server (I think)
- newsite.hxml: Build the new website, the new site unit tests, and the Haxe remoting API. (Also runs the unit tests).
- test.hxml: Build the automated tests.
Folders:
- /src/: Source code for the haxelib tool and the website, including legacy versions.
- /bin/: The compile target for building the haxelib tool, legacy tool, and site preparation tool.
- /www/: The compile target (and supporting files) for the haxelib website (including legacy site and API)
- /test/: Unit test source code for running on Travis.
- /testing/: A setup for manually testing a complete setup.
- /package/: Files that are used for bundling the haxelib_client zip file.