The vvvv-sdk is the one-stop solution that allows you to contribute stuff to the addonpack. It includes all of vvvv's open source code and the source code of all contributed addons. As it comes as a git repository it allows you to conveniently stay uptodate with latest developments and always build your addons against the latest alpha builds.
If you just want to browse through the code you can do so at the vvvv-sdk github page. There are 3 reasons that would make you want to follow the instructions below:
The following steps will get you going:
There are countless ways to work with git repositories on windows. In order to keep this guide clean we recommend using the Git Extensions GUI which served us very well. During its installation make sure to check installing all 3:
The first is the actual git engine (to which Git Extensions is only the GUI) and the second is a nice diff tool that helps you compare files when it comes to merge-conflicts. The third is useful helper that stores your login information in the windows credential manager. When asked to choose between OpenSSH and PuTTY just click Next.
When running Git Extensions for the first time you'll have to enter your name and email address that will be used for your commits. Just follow the instructions there..
If at some point you need/want to know more about working with git your best starting point is the official git website with all its documentation and reference material.
The vvvv-sdk git repository is hosted onhttp://github.com (which is just one of many git-repository hosting services). In order to be able to contribute back to that repository one day you'll have to fork it. Here are the steps to do so:
Now on github you have your own "forked" version of the vvvv-sdk repository which you'll be mainly working with. Clone this repository to your local disk using Git Extensions like so:
This will take a while as it now makes a local copy (ie. clone) of the specified repository.
By cloning the repository you got a local copy that should look like this:
\common \Hoster \scripts \tools \vvvv45
Now don't worry about \common \Hoster and \scripts and navigate to the \vvvv45 directory. What you see here is essentially the same directory layout you get when downloading vvvv as an enduser (except the \src and \tests directories which are not in the enduser download).
\addonpack \girlpower \lib \licenses \src \tests
Navigate to the \addonpack directory which is where you will work. It contains 4 directories as follows:
\girlpower \lib \licenses \src
The \src directory contains addons that need to be compiled before being useful (ie. plugins) while the \lib directory contains addons that will be shippped in the pack as they are (ie. modules, effects).
So depending on what kind of addon you're working on you put your nodes in the respective subdirectories:
\src\nodes\plugins \lib\nodes\effects \lib\nodes\modules
Before being able to build the solution you'll need to download a matching vvvv.exe to the \vvvv45 directory. To do this make sure you've powershell 3.0 installed (installed by default on windows 8), open Git Extensions and go to the Menu
Git -> Git bash (Ctrl + G)
to open the bash. In the bash navigate to the directory you cloned to, eg:
Before running vvvv.exe from your \vvvv45 directory (which is the latest available alpha build of vvvvs closed sources) you need to build the opensource parts, including the whole addonpack so you have all the plugins from the pack available while working from this setup.
The addonpack is split into 2 solutions:
The first of which contains managed plugins only (which is the biggest part of the addonpack) and is likely to compile without any issues.
The second one contains mixed managed/unmanaged plugins that can only be built on a machine having the Windows SDK 7.1 installed.
Building may take a while and is supposed to return with "Build Successfull. 0 Errors" in which case you're done and can close the solution. If the build fails, you best contact us on irc?.
Now you're ready to work on your own code. For this open the Addonpack.sln and add your project. Now in order to get your project built from within that solution you need to do one step manually:
<Import Project="..\..\Default.Plugin.Project.settings" />
You can have a look at the project file of another plugin in the addonpack for an example of how your project file should look like.
If your project has thirdparty .dll dependencies put them in a directory called
in your project directory and reference them from there.
If your project depends on platform dependent assemblies put them in
open the project file with a text editor and write something like this:
<Reference Include="AssemblyName"> <HintPath>dependencies\$(Platform)\AssemblyName.dll</HintPath> </Reference>
If your project references unmanaged .dlls you also put them in your local
directory but instead of adding them as reference to your project (which is not possible) you do as follows:
This only needs to be done for such linked native .dlls since for ordinary references Local copy = true is the default anyway.
When you compile your project you'll see that those native dependencies will get copied to the output directory including their relative path name. In order to be found at runtime we need to add this relative path name to the PATH environment variable once our plugin gets loaded. To do that add a static constructor to your plugin and put in the following lines of code:
Place a file called
directly in the directory of your plugin. From there it will be automatically collected and put in the common \addonpack\licenses directory after the build.
Don't forget to provide a helppatch for your plugin. Put helppatches directly into the
directory. This is a bit of a mess, we know. Please come complain on irc?.
The git pull command is used to fetch (and merge) code from a remote repository. By default when you pull in your repository you'll update your local code from your remote code. But in order to get the freshest bits from the vvvv-sdk you need to pull from the original repository.
For this you have to add the original repo as an extra remote to your repository. In the Git Extensions menu go to:
Remotes -> Manage remote repositories
and add a new remote giving it the name "upstream" and the url:
Now you can pull from either of your two remotes:
Pulling upstream will get you the latest changes to the vvvv-sdk. Now in order to get the latest suitable vvvv.exe and setup.exe from a git bash call:
And whenever you do so make sure to rebuild the Addonpack.sln in order for the vvvv.exe you got to be compatible with the latest codechanges.
You added a project to the addonpack and want it to be distributed with the official addonpack download? Send us a pull request pulling against the vvvv-sdk develop branch.
vvvv is following this branching model.
Note that you can start multiple individual pull requests by creating different branches on your end and then pull-request from those against vvvv-sdk's develop branch.
Before start a pull-request please make sure to:
When building the pack as 64bit you'll also need the according 64bit alpha of vvvv.exe which you can get by manually calling:
from the bash (remember: Ctrl+G in GitExtensions).
anonymous user login