-
Notifications
You must be signed in to change notification settings - Fork 3.2k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #1 from dotnet/main
Main
- Loading branch information
Showing
270 changed files
with
9,279 additions
and
3,102 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,63 @@ | ||
# Daily Builds | ||
|
||
Daily builds are created automatically whenever a new commit is merged to the `main` branch. These builds are verified by more than 70,000 tests each running on a range of platforms. These builds are reliable and have significant advantages over using previews: | ||
|
||
* Previews typically lag behind daily builds by around three to five weeks. This means that each preview is missing many bug fixes and enhancements, even if you get it on the day it is released. The daily builds always have the latest features and bug fixes. | ||
* Serious bugs are usually fixed and available in a new daily build within one or two days--sometimes less. The same fix will likely not make a new preview/release for weeks. | ||
* You are able to provide feedback immediately on any change we make, which makes it more likely we will be able to take action on this feedback before the change is baked in. | ||
|
||
## Using daily builds | ||
|
||
The daily builds are not published to NuGet.org because there are way too many of them! Instead they can be pulled from a custom NuGet feed. To access this feed, create a `NuGet.config` file in the same directory as your .NET solution or projects. The file should contain the following content: | ||
|
||
```xml | ||
<?xml version="1.0" encoding="utf-8"?> | ||
<configuration> | ||
<packageSources> | ||
<clear /> | ||
<add key="dotnet-eng" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet-eng/nuget/v3/index.json" /> | ||
<add key="dotnet-tools" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet-tools/nuget/v3/index.json" /> | ||
<add key="dotnet6" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet6/nuget/v3/index.json" /> | ||
<add key="dotnet6-transport" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet6-transport/nuget/v3/index.json" /> | ||
<add key="nuget.org" value="https://api.nuget.org/v3/index.json" /> | ||
</packageSources> | ||
</configuration> | ||
``` | ||
|
||
## Which version to use | ||
|
||
Daily builds are currently branded as EF Core 6.0. For example, `6.0.0-alpha.1.20457.2`. This is an artifact of the build system; these builds still contain the bits what we plan to ship as EF Core 5.0. | ||
|
||
### Using an explicit version | ||
|
||
You can use your IDE to choose the latest version. For example, in Visual Studio: | ||
|
||
![image](https://user-images.githubusercontent.com/1430078/92644977-01108780-f299-11ea-897e-bb8e9705ada7.png) | ||
|
||
Alternately, your IDE might provide auto-completion directly in the .csproj file: | ||
|
||
![image](https://user-images.githubusercontent.com/1430078/92645046-1d142900-f299-11ea-9e40-c2b1fe1f61c1.png) | ||
|
||
### Using wildcards | ||
|
||
It may be more convenient to use wildcards in project references. For example: | ||
|
||
```xml | ||
<ItemGroup> | ||
<PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="6.0.0-*" /> | ||
<PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="6.0.0-*" /> | ||
<PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="6.0.0-*" /> | ||
<PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer.NetTopologySuite" Version="6.0.0-*" /> | ||
</ItemGroup> | ||
``` | ||
|
||
This will cause NuGet to pull the latest daily build whenever packages are restored. | ||
|
||
## What about Visual Studio and the SDK? | ||
|
||
EF Core 5.0 targets .NET Standard 2.1. This means that: | ||
|
||
* Your application does not need to target .NET 5; .NET Core 3.1 is fine. | ||
* The daily builds should work with any IDE that supports .NET Core 3.1. | ||
* They do not require a Visual Studio preview release, although previews will also work. | ||
* The daily builds should work with either the .NET Core 3.1 SDK or the .NET 5 SDK installed. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,61 +1,61 @@ | ||
<?xml version="1.0" encoding="utf-8"?> | ||
<Dependencies> | ||
<ToolsetDependencies> | ||
<Dependency Name="Microsoft.Extensions.Caching.Memory" Version="6.0.0-alpha.1.20423.9"> | ||
<Dependency Name="Microsoft.Extensions.Caching.Memory" Version="6.0.0-alpha.1.20454.24"> | ||
<Uri>https://github.com/dotnet/runtime</Uri> | ||
<Sha>da90d08d81aa730a26ffa31d2396654c1b86b03d</Sha> | ||
<Sha>4fd87bc4ce9f90bcaf82de3fc5fed18486d54ea6</Sha> | ||
</Dependency> | ||
<Dependency Name="Microsoft.Extensions.Configuration.EnvironmentVariables" Version="6.0.0-alpha.1.20423.9"> | ||
<Dependency Name="Microsoft.Extensions.Configuration.EnvironmentVariables" Version="6.0.0-alpha.1.20454.24"> | ||
<Uri>https://github.com/dotnet/runtime</Uri> | ||
<Sha>da90d08d81aa730a26ffa31d2396654c1b86b03d</Sha> | ||
<Sha>4fd87bc4ce9f90bcaf82de3fc5fed18486d54ea6</Sha> | ||
</Dependency> | ||
<Dependency Name="Microsoft.Extensions.Configuration.Abstractions" Version="6.0.0-alpha.1.20423.9"> | ||
<Dependency Name="Microsoft.Extensions.Configuration.Abstractions" Version="6.0.0-alpha.1.20454.24"> | ||
<Uri>https://github.com/dotnet/runtime</Uri> | ||
<Sha>da90d08d81aa730a26ffa31d2396654c1b86b03d</Sha> | ||
<Sha>4fd87bc4ce9f90bcaf82de3fc5fed18486d54ea6</Sha> | ||
</Dependency> | ||
<Dependency Name="Microsoft.Extensions.Configuration.Json" Version="6.0.0-alpha.1.20423.9"> | ||
<Dependency Name="Microsoft.Extensions.Configuration.Json" Version="6.0.0-alpha.1.20454.24"> | ||
<Uri>https://github.com/dotnet/runtime</Uri> | ||
<Sha>da90d08d81aa730a26ffa31d2396654c1b86b03d</Sha> | ||
<Sha>4fd87bc4ce9f90bcaf82de3fc5fed18486d54ea6</Sha> | ||
</Dependency> | ||
<Dependency Name="Microsoft.Extensions.Configuration" Version="6.0.0-alpha.1.20423.9"> | ||
<Dependency Name="Microsoft.Extensions.Configuration" Version="6.0.0-alpha.1.20454.24"> | ||
<Uri>https://github.com/dotnet/runtime</Uri> | ||
<Sha>da90d08d81aa730a26ffa31d2396654c1b86b03d</Sha> | ||
<Sha>4fd87bc4ce9f90bcaf82de3fc5fed18486d54ea6</Sha> | ||
</Dependency> | ||
<Dependency Name="Microsoft.Extensions.DependencyInjection" Version="6.0.0-alpha.1.20423.9"> | ||
<Dependency Name="Microsoft.Extensions.DependencyInjection" Version="6.0.0-alpha.1.20454.24"> | ||
<Uri>https://github.com/dotnet/runtime</Uri> | ||
<Sha>da90d08d81aa730a26ffa31d2396654c1b86b03d</Sha> | ||
<Sha>4fd87bc4ce9f90bcaf82de3fc5fed18486d54ea6</Sha> | ||
</Dependency> | ||
<Dependency Name="Microsoft.Extensions.DependencyModel" Version="6.0.0-alpha.1.20423.9"> | ||
<Dependency Name="Microsoft.Extensions.DependencyModel" Version="6.0.0-alpha.1.20454.24"> | ||
<Uri>https://github.com/dotnet/runtime</Uri> | ||
<Sha>da90d08d81aa730a26ffa31d2396654c1b86b03d</Sha> | ||
<Sha>4fd87bc4ce9f90bcaf82de3fc5fed18486d54ea6</Sha> | ||
</Dependency> | ||
<Dependency Name="Microsoft.Extensions.HostFactoryResolver.Sources" Version="6.0.0-alpha.1.20423.9"> | ||
<Dependency Name="Microsoft.Extensions.HostFactoryResolver.Sources" Version="6.0.0-alpha.1.20454.24"> | ||
<Uri>https://github.com/dotnet/runtime</Uri> | ||
<Sha>da90d08d81aa730a26ffa31d2396654c1b86b03d</Sha> | ||
<Sha>4fd87bc4ce9f90bcaf82de3fc5fed18486d54ea6</Sha> | ||
</Dependency> | ||
<Dependency Name="Microsoft.Extensions.Logging" Version="6.0.0-alpha.1.20423.9"> | ||
<Dependency Name="Microsoft.Extensions.Logging" Version="6.0.0-alpha.1.20454.24"> | ||
<Uri>https://github.com/dotnet/runtime</Uri> | ||
<Sha>da90d08d81aa730a26ffa31d2396654c1b86b03d</Sha> | ||
<Sha>4fd87bc4ce9f90bcaf82de3fc5fed18486d54ea6</Sha> | ||
</Dependency> | ||
<Dependency Name="System.Collections.Immutable" Version="6.0.0-alpha.1.20423.9"> | ||
<Dependency Name="System.Collections.Immutable" Version="6.0.0-alpha.1.20454.24"> | ||
<Uri>https://github.com/dotnet/runtime</Uri> | ||
<Sha>da90d08d81aa730a26ffa31d2396654c1b86b03d</Sha> | ||
<Sha>4fd87bc4ce9f90bcaf82de3fc5fed18486d54ea6</Sha> | ||
</Dependency> | ||
<Dependency Name="System.ComponentModel.Annotations" Version="6.0.0-alpha.1.20423.9"> | ||
<Dependency Name="System.ComponentModel.Annotations" Version="6.0.0-alpha.1.20454.24"> | ||
<Uri>https://github.com/dotnet/runtime</Uri> | ||
<Sha>da90d08d81aa730a26ffa31d2396654c1b86b03d</Sha> | ||
<Sha>4fd87bc4ce9f90bcaf82de3fc5fed18486d54ea6</Sha> | ||
</Dependency> | ||
<Dependency Name="System.Diagnostics.DiagnosticSource" Version="6.0.0-alpha.1.20423.9"> | ||
<Dependency Name="System.Diagnostics.DiagnosticSource" Version="6.0.0-alpha.1.20454.24"> | ||
<Uri>https://github.com/dotnet/runtime</Uri> | ||
<Sha>da90d08d81aa730a26ffa31d2396654c1b86b03d</Sha> | ||
<Sha>4fd87bc4ce9f90bcaf82de3fc5fed18486d54ea6</Sha> | ||
</Dependency> | ||
<Dependency Name="Microsoft.DotNet.Arcade.Sdk" Version="5.0.0-beta.20419.21"> | ||
<Dependency Name="Microsoft.DotNet.Arcade.Sdk" Version="5.0.0-beta.20453.7"> | ||
<Uri>https://github.com/dotnet/arcade</Uri> | ||
<Sha>56a95cc477558c1ccdf16d7abe962849ea970ba4</Sha> | ||
<Sha>16b71a2f216c3c5be5860977c4cb03a95ee2f0e3</Sha> | ||
</Dependency> | ||
<Dependency Name="Microsoft.DotNet.Helix.Sdk" Version="5.0.0-beta.20419.21"> | ||
<Dependency Name="Microsoft.DotNet.Helix.Sdk" Version="5.0.0-beta.20453.7"> | ||
<Uri>https://github.com/dotnet/arcade</Uri> | ||
<Sha>56a95cc477558c1ccdf16d7abe962849ea970ba4</Sha> | ||
<Sha>16b71a2f216c3c5be5860977c4cb03a95ee2f0e3</Sha> | ||
</Dependency> | ||
</ToolsetDependencies> | ||
</Dependencies> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.