libsodium-uwp 0.1.0-alpha2

This is a prerelease version of libsodium-uwp.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package libsodium-uwp --version 0.1.0-alpha2
NuGet\Install-Package libsodium-uwp -Version 0.1.0-alpha2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="libsodium-uwp" Version="0.1.0-alpha2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add libsodium-uwp --version 0.1.0-alpha2
#r "nuget: libsodium-uwp, 0.1.0-alpha2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install libsodium-uwp as a Cake Addin
#addin nuget:?package=libsodium-uwp&version=0.1.0-alpha2&prerelease

// Install libsodium-uwp as a Cake Tool
#tool nuget:?package=libsodium-uwp&version=0.1.0-alpha2&prerelease

libsodium-uwp - A secure cryptographic library for Universal Windows Platform

Product Compatible and additional computed target framework versions.
native native is compatible. 
Universal Windows Platform uap was computed.  uap10.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on libsodium-uwp:

Package Downloads
Globeport.Client.Uwp.Host

UWP host for Globeport Elements

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.160 3,735 6/24/2018
1.0.152 1,108 10/11/2017
1.0.151 1,033 10/9/2017
1.0.150 1,065 10/3/2017
1.0.132 1,147 7/27/2017
1.0.131 1,018 7/19/2017
1.0.123 14,407 6/8/2017
1.0.122 1,089 6/8/2017
1.0.12 1,162 3/22/2017
1.0.0-rc1 1,466 11/1/2016
1.0.0-alpha6 985 10/27/2016
0.1.0-alpha5 957 10/21/2016
0.1.0-alpha4 950 10/20/2016
0.1.0-alpha3 956 10/17/2016
0.1.0-alpha2 920 10/14/2016

# 0.1.0-alpha2

This is the initial release of `libsodium-uwp`. `libsodium-uwp` is a Universal Windows Runtime Component that exposes the `libsodium` library to both desktop and mobile universal windows applications.

## Installation

1. Install package from Nuget

   ```
   Install-Package libsodium-uwp -Pre
   ```

2. Add the following to your `Package.appxmanifest` file.

   ```xml
   <Extensions>
       <Extension Category="windows.activatableClass.inProcessServer">
           <InProcessServer>
               <Path>libsodium-uwp.dll</Path>
               <ActivatableClass ActivatableClassId="Sodium.Core" ThreadingModel="both" />
               <ActivatableClass ActivatableClassId="Sodium.KeyPair" ThreadingModel="both" />
               <ActivatableClass ActivatableClassId="Sodium.Utilities" ThreadingModel="both" />
               <ActivatableClass ActivatableClassId="Sodium.SecretBox" ThreadingModel="both" />
               <ActivatableClass ActivatableClassId="Sodium.SecretKeyAuth" ThreadingModel="both" />
               <ActivatableClass ActivatableClassId="Sodium.SecretAead" ThreadingModel="both" />
               <ActivatableClass ActivatableClassId="Sodium.SealedPublicKeyBox" ThreadingModel="both" />
               <ActivatableClass ActivatableClassId="Sodium.PublicKeyBox" ThreadingModel="both" />
               <ActivatableClass ActivatableClassId="Sodium.PublicKeyAuth" ThreadingModel="both" />
               <ActivatableClass ActivatableClassId="Sodium.CryptoHash" ThreadingModel="both" />
               <ActivatableClass ActivatableClassId="Sodium.ScalarMult" ThreadingModel="both" />
           </InProcessServer>
       </Extension>
   </Extensions>
   ```

## Usage

As a Universal C Runtime Component, this project can be consumed from C#, C++, and JavaScript UWP applications. For more information, please see the [docs](/docs) directory.

### Universal C# Example

A basic example in C# is outlined below.

```C#
using Sodium;
var data = Sodium.Core.GetRandomBytes(32);
```

## Limitations & Known Issues.

1. The Nuget package requires you to add extension information to your `Package.appxmanifest`.
2. Only certain `libsodium` API endpoints are exposed. For more information on what exactly is supported, please see the [docs](/docs) directory.