blob: 5976cd6e7273d3b9f911a4f08c7e92a7c3e085e3 [file] [log] [blame]
Prerequisites
* csc.exe must be available on your PATH. Usually it can be found in C:\WINDOWS\Microsoft.NET\Framework\[version]
* NUnit must be installed or otherwise configured, see http://incubator.apache.org/npanday/getting-started.html
Initial Build
* The latest version of NPanday requires .NET 2.0+ to build and run NPanday. This is due to needing the .NET 2.0 AppDomainManagers for
executing Maven .NET plugins. You may still target your own projects with .NET 1.1 build.
* On the first build, for Windows execute
bootstrap-build.bat [ -DMicrosoft | -DVisualStudio2005 | -DMono ]
Or on *nix,
bootstrap-build.sh
If this is a clean build (meaning that you do not have a ~./m2/npanday-settings.xml file)
then you will also need to make sure that you have csc within your path. On subsequent builds, you can just type mvn -f pom.xml install from
the command prompt.
IntelliJ IDEA Setup
* Do the initial build. This will create the dotnet modello model source code and will download all of the maven
binary dependencies. Next, click the maven-dotnet.ipr file. Go to settings/Path variables and set localRepository
to your ~/.m2/repository directory (specify the absolute path). Exit IntelliJ and click the maven-dotnet.ipr file.
Now all of the binary dependencies will be mapped to the local maven repo.
Deploying NPanday Artifacts (File System Only)
* On the command line
set phase=deploy
set deploy.directory=${remoteRepository}
bootstrap-build.bat
* Due to a bug with not being able to use snapshots with an executables exe.config file, you will need to do this
next step manually: Copy ${localRepository}\NPanday\Plugins\NPanday.Plugin.Resx\0.14\NPanday.Plugin.Resx.exe.config to
${remoteRepository}\NPanday\Plugins\NPanday.Plugin.Resx\0.14\NPanday.Plugin.Resx.exe.config
To set up a remote repository accessible to others, you can transfer the contents of ${remoteRepository}
from your file system to a web server.
Generating CS Project Files and Solutions:
* Go to the directory containing a pom file.
* type: mvn npanday.plugin:maven-solution-plugin:solution
If the project was multi-module, the plugin will pick those up as well.
Setting up the Visual Studio 2005 Addin:
After building the project with bootstrap-build -DVisualStudio2005
* Deploy the components/dotnet-service/embedder/target/dotnet-service-embedder.war file on a standard web server
running port 8080.
* To generate the Addin for VisualStudio type: mvn npanday.plugin:maven-vsinstaller-plugin:install
* Start the IDE
* Click on an NPanday project
* Click on Tools/NPanday Addin
Changing NPanday's Version:
If you need to either update (or change) NPanday's project version, run the following:
modify-versions.bat <<new_npanday_version>> <<new_maven_version>>
For example,
modify-versions.bat 0.15 2.1-SNAPSHOT
changes the maven version to 0.15 and changes (or leaves) the maven version as 2.1-SNAPSHOT
This changes all of the versions within the pom.xml files.
If you also need to override the maven version at build time (it is currently set to maven-2.1-SNAPSHOT)
bootstrap-build.bat -DmavenVersion=<<new_version>>
Building Against NonPublic Repo (For release versions)
Deploy local versioned snapshot of maven 2.1 to internal repo
Deploy openrdf artifacts to internal repo
Deploy Castle artifacts to internal repo
Modify version to internal release version (as shown above)
Manually change the mavenVersion property in the pom.xml to a release version
Type: bootstrap-build.bat -DrdfProfile.none -DVisualStudio2005 -DmavenVersion=<<Internal versioned copy of 2.1>>