Using SymbolSource as an OpenWrap repository

We have some very exciting news to announce today. The OpenWrap package gateway has been extended and now supports the entire protocol. Which means that SymbolSource now offers regular OpenWrap package repositories. You can take advantage of SymbolSource and its flexible permission system to store and share wraps, symbols and sources.

OpenWrap

Preparing OpenWrap

  1. OpenWrap 2.0.2 is required to use our repositories. You can skip this entire section if you already have it.

  2. Make sure you have OpenWrap 1.0.2 before upgrading, otherwise bad things may happen:

    o update-wrap openwrap -system

  3. Add the official beta repository:

    o add-remote -name beta -href http://wraps.openwrap.org/beta

  4. Update OpenWrap in the system repository (or skip -system if you're running from a test project):

    o update-wrap openwrap -system

Configuring repositories

It might be good idea to start up Fiddler at this point to verify that o.exe is contacting remote repositories. It should, but this is all still beta stuff. Also, you will need an account on SymbolSource to complete some of the steps, so go ahead and register now, if you don't have one yet. From now on %login% will be, you guessed it, your login, and %key% will be your Visual Studio access key.

  1. Add the public OpenWrap repository:

    o add-remote -name public -href http://openwrap.gw.symbolsource.org/Public/OpenWrap

  2. Go to Metadata and create a private repository for upload testing. 'OpenWrap' is a nice name. Also make note of our Visual Studio key while you're there, it will be used as the password for authentication.

  3. Register the private repository with your install of OpenWrap:

    o add-remote -name private -href http://openwrap.gw.symbolsource.org/Public/Private.%login%.OpenWrap -user %login% -pwd %key%

  4. Try listing packages (o.exe should access index.wraplist from both locations, plus wraps.openwrap.org):

    o list-wrap -remote

  5. If everything goes fine, you'll see a package from the public repository:

    - symbolsource-repositorytest (available: 0.0.1.84582059)

Using the repositories

  1. Go to a new directory and initialize a new wrap:

    o init-wrap

  2. Now you can add the test library from SymbolSource:

    o add-wrap symbolsource-repositorytest

Uploading your packages

  1. Take a package from somewhere or just build your test wrap:

    o build-wrap

  2. Publish package to SymbolSource:

    o publish-wrap -path test-1.0.wrap -remote private

  3. Verify that the package was uploaded:

    o list-wrap -remote

Symbol package support

With a SymbolSource repository for OpenWrap you also get the entire on-demand debugging experience. Just make sure, before uploading, that your package contains PDB files in bin-* folders and all the sources you used to build the package from in an src folder - you will need to add those files manually (with a ZIP tool) for now. The package will be then processed on the SymbolSource servers. The version for download will be stripped from these files, but they will be available on-demand for Visual Studio. Once OpenWrap gets flavor support, these files will be included automatically during o build-wrap.

Hosting official packages

If you wish to maintain official packages for your project in the main OpenWrap repository at SymbolSource, please let us know through the usual channels (Google Group, Twitter) and we'll assign the required permissions to your account ASAP.

Posted by Marcin Mikołajczak (TripleEmcoder) on Saturday, October 8, 2011

blog comments powered by Disqus