1e4e0bacde
This adds gradle support for building wpilibj and wpilibc. At this point, both of these libraries should be fully ready to go. Gradle should give us a number of improvements, including less dependencies for getting building up and running, and MUCH faster build times. I'm noticing significantly faster build times already compared to Maven, with neither system building the plugins. The changes here should be pretty straight forward. The basic command for gradle is './gradlew'. This is the gradle wrapper, and it will find and download the correct gradle executable for your system. There is no need to install anything yourself. To see every task available, run './gradlew tasks'. The important tasks for us are listed under the WPILib header when the tasks command is run. To generate unit test binaries, the fRCUserProgramExecutable command will create the C++ tester, and the wpilibjIntegrationTestJar command will create the Java tester. The Jenkins deploy scripts have been modified to know the difference between maven generated and gradle generated jars with an environment variable. Creating the eclipse plugins still requires Maven, but gradle will handle calling it correctly and generating the proper dependencies for it. Create the plugins by calling ./gradlew eclipsePlugins. Jenkins can now be modified to support the new build system. Unit tests are run with ./gradlew test. Generating the integration tests uses the above two commands, and then process proceeds exactly as it did before. For publishing documentation, a new task has been created, ./gradlew publishDocs, which handles putting the documentation where Jenkins expects for publishing. Change-Id: I9a260d391984f98ef9170993efe933e4026161dc
Purpose
NetworkTables is a HashTable synchronized across the network. It provides a simple interface for sharing numbers, booleans, strings and homogeneous arrays of those components between the robot, driverstation, co-processor and any other computer teams wish to have provide or consume data.
Contributing
- Checkout
- Edit
- Commit
- Push using
git push origin HEAD:refs/for/master - Wait for code review, checking for comments.
Editing
You can always use any text editor and then build with Maven. Eclipse support works well with the m2eclipse plugin. Individual components may have there own project files.
Building with Maven
Currently, Maven only builds NetworkTables Java and C++. The various table viewer projects have not been migrated yet.
There are multiple build targets that NetworkTables supports. To build it, it is assumed that the toolchains have been setup as described in the WPILib development documentation. In both Java and C++ there are three build targets, Desktop, Azalea and Athena. For Java the Athena and Desktop builds are identical. Building the Desktop versions will run UnitTests on the platform.
cdinto the root directory if you want to build both languages. Otherwise,cdinto the language you want to build.- Run
mvn installif you want to build and install everything. - That's it. You can build only for a specific platform by using
Maven profiles. For example, just add
-Pdesktopwhen developing to run the unit tests without compiling for other platforms.