zhangwenquan / webapi Goto Github PK

OData Web API (i.e., ASP.NET Web API OData) is a server library built upon ODataLib and Web API.

The project currently has the following branches:

master branch

This is the active development branch for OData WebApi and it is currently most actively iterated. The package name is Microsoft.AspNet.OData. The is the OData WebApi for ODL v7.x releases which contain breaking changes against ODL v6.

release branch

This is the release branch for OData WebApi, contains code base up to most recently stable WebApi release. The latest release version is 6.0.

gh-pages branch

The gh-pages branch contains documentation source for OData WebApi - tutorials, guides, etc. The documention source is in Markdown format. It is hosted at ODataLib Pages.

maintenance-aspnetcore

This is the maintenance branch for OData WebApi with ASP.NET Core support. The package name is Microsoft.AspNetCore.OData.

maintenance-V4 branch

This is the maintenance branch for OData WebApi based on ODL 6.x, which implements the ODataV4 protocol. The package name is Microsoft.AspNet.OData, with latest maintenance release version 5.10.

maintenance-V3 branch

This is the maintenance branch for OData WebApi based on ODL 5.x, which implements the ODataV3 protocol. The package name is Microsoft.AspNet.WebApi.OData, with latest maintenance release version 5.7.

maintenance-dnx branch

This is maintenance branch for an early prototype version of OData WebApi based on original ASP.NET Core, aka DNX. Package name is Microsoft.AspNet.OData. This is for project archive purpose only, is not active and doesn't accept contributions. It has only one release with information available here.

odata-v5.3-rtm v2.0-rtm v3-rtm v3.1-rtm v3.2-rtm branches

These are maintenance branches for previous RTMs. Project archives only, contributions not accepted.

cd OData
build.cmd

Each solution contains some test projects. Test projects use xUnit runner nuget package.

Tests will not run correctly unless SkipStrongNames is Enabled. Please run

build.cmd EnableSkipStrongNames

• build.cmd build project, and run unit tests.

To run end-to-end tests, you need to open an elevated - Run as administrator - command prompt

• build.cmd e2eV4 build projects, run unit tests, and OData v4 end-to-end tests.
• build.cmd e2eV3 build projects, run unit tests, and OData v3 end-to-end tests.
• build.cmd full build projects, run unit tests, OData v4 and v3 end-to-end tests.

To disable the SkipStrongNames:

build.cmd DisableSkipStrongNames

Open the project, build it, and then test cases should appear in test explorer. If not, this is because the assemblies are delay signed and you're missing the private key so xunit will not load them in Visual Studio. To fix, please run build.cmd EnableSkipStrongNames. Run all the tests in the test explorer. For running end-to-end tests you must open the solution as Administrator. More detail at this.

1. In your NuGet Package Manager settings add the following package source:

• https://www.myget.org/F/aspnetwebstacknightly/

2. Package IDs

• Choose: Include Prerelease
• OData v4: Microsoft.AspNet.OData
• OData v3: Microsoft.AspNet.WebApi.OData

Please refer to the CONTRIBUTION.md.

Please visit the OData Web API pages.

Please refer to the ODataSamples WebApi.

Please refer to the How to debug.