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.
Preparing OpenWrap
OpenWrap 2.0.2 is required to use our repositories. You can skip this entire section if you already have it.
Make sure you have OpenWrap 1.0.2 before upgrading, otherwise bad things may happen:
o update-wrap openwrap -system
Add the official beta repository:
o add-remote -name beta -href http://wraps.openwrap.org/beta
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.
Add the public OpenWrap repository:
o add-remote -name public -href http://openwrap.gw.symbolsource.org/Public/OpenWrap
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.
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%
Try listing packages (
o.exe
should accessindex.wraplist
from both locations, pluswraps.openwrap.org
):o list-wrap -remote
If everything goes fine, you'll see a package from the public repository:
- symbolsource-repositorytest (available: 0.0.1.84582059)
Using the repositories
Go to a new directory and initialize a new wrap:
o init-wrap
Now you can add the test library from SymbolSource:
o add-wrap symbolsource-repositorytest
Uploading your packages
Take a package from somewhere or just build your test wrap:
o build-wrap
Publish package to SymbolSource:
o publish-wrap -path test-1.0.wrap -remote private
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.