mirrors/dotnet-installer
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
dotnet-installer/README.md

168 lines
12 KiB
Markdown
Raw Normal View History

add readme
2015-10-08 21:41:04 +00:00
# .NET Command Line Interface
Add slack channel
2016-05-16 14:23:01 +00:00
[![.NET Slack Status](https://aspnetcoreslack.herokuapp.com/badge.svg?2)](http://tattoocoder.com/aspnet-slack-sign-up/) [![Join the chat at https://gitter.im/dotnet/cli](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/dotnet/cli?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
Add Gitter badge
2015-11-30 23:39:31 +00:00
Add contrib guidelines, Docker links Add contribution guidelines. These just link to the CoreCLR ones. Add stubs of the "user guide" and "developer guide". Add links to the Docker base image repo on GitHub.
2015-11-16 20:22:11 +00:00
This repo contains the source code for cross-platform [.NET Core](http://github.com/dotnet/core) command line toolchain. It contains the implementation of each command, the native packages for various supported platforms as well as documentation.
Change preview4 references to RC4 Preview4 is actually RC4 as all documentation and dotnet --info shows. I thought they were 2 separate things.
2017-02-07 23:11:13 +00:00
RC 4 release - MSBuild based tools
Update README.md (#5092) * Update README.md Add information about the Preview 4 bits. Fixes #5045, #5009
2016-12-20 19:36:08 +00:00
---------------------------------------
Update README.md
2017-02-07 18:22:21 +00:00
As was outlined in the ["Changes to project.json" blog post](https://blogs.msdn.microsoft.com/dotnet/2016/05/23/changes-to-project-json/), we have started work to move away from project.json to csproj and MSBuild. All the new `latest` releases from this repo (from `rel/1.0.0` branch) are MSBuild-enabled tools.
Update README.md (#3309) Adding more stuff around the docs and release schedules. Also, changing the outdated running information. skip ci please
2016-06-02 14:20:23 +00:00
Change preview4 references to RC4 Preview4 is actually RC4 as all documentation and dotnet --info shows. I thought they were 2 separate things.
2017-02-07 23:11:13 +00:00
The current official release of the csproj-enabled CLI tools is **CLI RC 4**.
Fixing the README.md and adding issues filing guide The README.md contained some errors, corrected those. Removed the native compilation bits for now. Added an issue filing guide to make the issue process slightly better so we can triage better.
2016-02-19 23:59:14 +00:00
Update README.md (#5092) * Update README.md Add information about the Preview 4 bits. Fixes #5045, #5009
2016-12-20 19:36:08 +00:00
There are a couple of things to keep in mind:
Piotrp msft/merge2msbuild (#3923) * Add Test for removing readonly flag when copying readonly library assets * change namespace * PR Feedback * Update README.md (#3904) * Update README.md * Responding to PR feedback * Responding to PR feedback
2016-07-23 17:38:31 +00:00
Change preview4 references to RC4 Preview4 is actually RC4 as all documentation and dotnet --info shows. I thought they were 2 separate things.
2017-02-07 23:11:13 +00:00
* RC 4 CLI bits are still **in development** so some rough edges are to be expected.
* RC 4 bits **do not support** project.json so you will have to either keep Preview 2 tools around or migrate your project or add a global.json file to your project to target preview2. You can find more information on this using the [project.json to csproj instructions](https://github.com/dotnet/cli/blob/rel/1.0.0/Documentation/ProjectJsonToCSProj.md).
* RC 4 refers to the **CLI tools only** and does not cover Visual Studio, VS Code or Visual Studio for Mac.
Update README.md (#5092) * Update README.md Add information about the Preview 4 bits. Fixes #5045, #5009
2016-12-20 19:36:08 +00:00
* We welcome any and all issues that relate to MSBuild-based tools, so feel free to try them out and leave comments and file any bugs/problems.
Piotrp msft/merge2msbuild (#3923) * Add Test for removing readonly flag when copying readonly library assets * change namespace * PR Feedback * Update README.md (#3904) * Update README.md * Responding to PR feedback * Responding to PR feedback
2016-07-23 17:38:31 +00:00
Update README.md (#5092) * Update README.md Add information about the Preview 4 bits. Fixes #5045, #5009
2016-12-20 19:36:08 +00:00
### Download links
Update README.md
2017-01-30 20:25:59 +00:00
* Instructions and links for download: [RC3 download links](https://github.com/dotnet/core/blob/master/release-notes/rc3-download.md).
Update README.md (#5092) * Update README.md Add information about the Preview 4 bits. Fixes #5045, #5009
2016-12-20 19:36:08 +00:00
* Directory for future Preview release notes: [.NET Core release notes](https://github.com/dotnet/core/tree/master/release-notes).
Piotrp msft/merge2msbuild (#3923) * Add Test for removing readonly flag when copying readonly library assets * change namespace * PR Feedback * Update README.md (#3904) * Update README.md * Responding to PR feedback * Responding to PR feedback
2016-07-23 17:38:31 +00:00
Fixing the README.md and adding issues filing guide The README.md contained some errors, corrected those. Removed the native compilation bits for now. Added an issue filing guide to make the issue process slightly better so we can triage better.
2016-02-19 23:59:14 +00:00
Found an issue?
---------------
Update README.md
2017-02-23 08:02:33 +00:00
You can consult the [known issues page](https://github.com/dotnet/core/blob/master/cli/known-issues.md) to find out the current issues and to see the workarounds.
Fixing the README.md and adding issues filing guide The README.md contained some errors, corrected those. Removed the native compilation bits for now. Added an issue filing guide to make the issue process slightly better so we can triage better.
2016-02-19 23:59:14 +00:00
If you don't find your issue, please file one! However, given that this is a very high-frequency repo, we've setup some [basic guidelines](Documentation/issue-filing-guide.md) to help you. Please consult those first.
Update README.md
2015-11-24 21:25:08 +00:00
Add Code of Conduct details to README.md
2016-06-22 16:29:08 +00:00
This project has adopted the code of conduct defined by the [Contributor Covenant](http://contributor-covenant.org/) to clarify expected behavior in our community. For more information, see the [.NET Foundation Code of Conduct](http://www.dotnetfoundation.org/code-of-conduct).
Update README.md Add build status badges
2015-10-21 22:47:45 +00:00
Build Status
------------
Remove OpenSUSE and Fedora from the readme.
2017-03-01 22:38:29 +00:00
|Ubuntu 14.04 / Linux Mint 17 |Ubuntu 16.04 |Debian 8.2 |Windows x64 |Windows x86 |Mac OS X |CentOS 7.1 / Oracle Linux 7.1 |RHEL 7.2 |
|:------:|:------:|:------:|:------:|:------:|:------:|:------:|:------:|
|[![][ubuntu-14.04-build-badge]][ubuntu-14.04-build]|[![][ubuntu-16.04-build-badge]][ubuntu-16.04-build]|[![][debian-8.2-build-badge]][debian-8.2-build]|[![][win-x64-build-badge]][win-x64-build]|[![][win-x86-build-badge]][win-x86-build]|[![][osx-build-badge]][osx-build]|[![][centos-build-badge]][centos-build]|[![][rhel-build-badge]][rhel-build]|
Update the daily build table. No longer include links to the runtime installers. Add a link to core-setup for people who want to install just the runtime. Refactor the links out of the table for easier maintenance. Consolidate into a single column for the branch.
2017-02-06 18:37:32 +00:00
Update badges for build status
2017-02-22 00:15:37 +00:00
[win-x64-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/5449/badge
[win-x64-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=5449
Update the daily build table. No longer include links to the runtime installers. Add a link to core-setup for people who want to install just the runtime. Refactor the links out of the table for easier maintenance. Consolidate into a single column for the branch.
2017-02-06 18:37:32 +00:00
Update badges for build status
2017-02-22 00:15:37 +00:00
[win-x86-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/5450/badge
[win-x86-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=5450
Update the daily build table. No longer include links to the runtime installers. Add a link to core-setup for people who want to install just the runtime. Refactor the links out of the table for easier maintenance. Consolidate into a single column for the branch.
2017-02-06 18:37:32 +00:00
Update badges for build status
2017-02-22 00:15:37 +00:00
[ubuntu-14.04-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/5447/badge
[ubuntu-14.04-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=5447
Update the daily build table. No longer include links to the runtime installers. Add a link to core-setup for people who want to install just the runtime. Refactor the links out of the table for easier maintenance. Consolidate into a single column for the branch.
2017-02-06 18:37:32 +00:00
Update badges for build status
2017-02-22 00:15:37 +00:00
[ubuntu-16.04-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/5448/badge
[ubuntu-16.04-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=5448
Update the daily build table. No longer include links to the runtime installers. Add a link to core-setup for people who want to install just the runtime. Refactor the links out of the table for easier maintenance. Consolidate into a single column for the branch.
2017-02-06 18:37:32 +00:00
Update badges for build status
2017-02-22 00:15:37 +00:00
[debian-8.2-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/5442/badge
[debian-8.2-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=5442
Update the daily build table. No longer include links to the runtime installers. Add a link to core-setup for people who want to install just the runtime. Refactor the links out of the table for easier maintenance. Consolidate into a single column for the branch.
2017-02-06 18:37:32 +00:00
Update badges for build status
2017-02-22 00:15:37 +00:00
[osx-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/5445/badge
[osx-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=5445
Update the daily build table. No longer include links to the runtime installers. Add a link to core-setup for people who want to install just the runtime. Refactor the links out of the table for easier maintenance. Consolidate into a single column for the branch.
2017-02-06 18:37:32 +00:00
Update badges for build status
2017-02-22 00:15:37 +00:00
[centos-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/5441/badge
[centos-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=5441
Update the daily build table. No longer include links to the runtime installers. Add a link to core-setup for people who want to install just the runtime. Refactor the links out of the table for easier maintenance. Consolidate into a single column for the branch.
2017-02-06 18:37:32 +00:00
Update badges for build status
2017-02-22 00:15:37 +00:00
[rhel-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/5446/badge
[rhel-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=5446
Update the daily build table. No longer include links to the runtime installers. Add a link to core-setup for people who want to install just the runtime. Refactor the links out of the table for easier maintenance. Consolidate into a single column for the branch.
2017-02-06 18:37:32 +00:00
Clean up product naming
2016-03-30 22:01:41 +00:00
Installers and Binaries
-----------------------
Update README.md
2015-11-08 06:16:39 +00:00
Update the daily build table. No longer include links to the runtime installers. Add a link to core-setup for people who want to install just the runtime. Refactor the links out of the table for easier maintenance. Consolidate into a single column for the branch.
2017-02-06 18:37:32 +00:00
You can download .NET Core SDK as either an installer (MSI, PKG) or a zip (zip, tar.gz). .NET Core SDK contains both the .NET Core runtime and CLI tools.
Clean up product naming
2016-03-30 22:01:41 +00:00
Update the daily build table. No longer include links to the runtime installers. Add a link to core-setup for people who want to install just the runtime. Refactor the links out of the table for easier maintenance. Consolidate into a single column for the branch.
2017-02-06 18:37:32 +00:00
In order to download just the .NET Core runtime without the SDK, please visit https://github.com/dotnet/core-setup#daily-builds.
Clean up product naming
2016-03-30 22:01:41 +00:00
Update README.md (#3309) Adding more stuff around the docs and release schedules. Also, changing the outdated running information. skip ci please
2016-06-02 14:20:23 +00:00
> **Note:** please be aware that below installers are the **latest bits**. If you
Fix broken link in README.md
2016-12-28 20:25:26 +00:00
> want to install the latest released versions, please check out the [section above](#download-links).)
Update README.md (#3309) Adding more stuff around the docs and release schedules. Also, changing the outdated running information. skip ci please
2016-06-02 14:20:23 +00:00
Update the daily build table. No longer include links to the runtime installers. Add a link to core-setup for people who want to install just the runtime. Refactor the links out of the table for easier maintenance. Consolidate into a single column for the branch.
2017-02-06 18:37:32 +00:00
| Platform | master<br>[![][version-badge]][version] |
|----------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
| **Windows x64** | [Installer][win-x64-installer] - [Checksum][win-x64-installer-checksum]<br>[zip][win-x64-zip] - [Checksum][win-x64-zip-checksum] |
| **Windows x86** | [Installer][win-x86-installer] - [Checksum][win-x86-installer-checksum]<br>[zip][win-x86-zip] - [Checksum][win-x86-zip-checksum] |
| **Ubuntu 14.04 / Linux Mint 17** | [Installer][ubuntu-14.04-installer] - [Checksum][ubuntu-14.04-installer-checksum]<br>*See Installer Note Below<br>[tar.gz][ubuntu-14.04-targz] - [Checksum][ubuntu-14.04-targz-checksum] |
| **Ubuntu 16.04** | [tar.gz][ubuntu-16.04-targz] - [Checksum][ubuntu-16.04-targz-checksum] |
| **Debian 8.2** | [tar.gz][debian-8.2-targz] - [Checksum][debian-8.2-targz-checksum] |
| **Mac OS X** | [Installer][osx-installer] - [Checksum][osx-installer-checksum]<br>[tar.gz][osx-targz] - [Checksum][osx-targz-checksum] |
| **CentOS 7.1 / Oracle Linux 7** | [tar.gz][centos-targz] - [Checksum][centos-targz-checksum] |
| **RHEL 7.2** | [tar.gz][rhel-targz] - [Checksum][rhel-targz-checksum] |
*Note: Our Debian packages are put together slightly differently than the other OS specific installers. Instead of combining everything, we have separate component packages that depend on each other. If you're installing these directly from the .deb files (via dpkg or similar), then you'll need to install the [corresponding Host, Host FX Resolver, and Shared Framework packages](https://github.com/dotnet/core-setup#daily-builds) before installing the Sdk package.*
[version]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/latest.version
[comment]: # (The latest versions are always the same across all platforms. Just need one to show, so picking win-x64's svg.)
update version badge for new moniker name.
2017-03-02 02:01:18 +00:00
[version-badge]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/win_x64_Release_version_badge.svg
Update the daily build table. No longer include links to the runtime installers. Add a link to core-setup for people who want to install just the runtime. Refactor the links out of the table for easier maintenance. Consolidate into a single column for the branch.
2017-02-06 18:37:32 +00:00
[win-x64-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-win-x64.latest.exe
[win-x64-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-win-x64.latest.exe.sha
[win-x64-zip]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-win-x64.latest.zip
[win-x64-zip-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-win-x64.latest.zip.sha
[win-x86-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-win-x86.latest.exe
[win-x86-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-win-x86.latest.exe.sha
[win-x86-zip]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-win-x86.latest.zip
[win-x86-zip-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-win-x86.latest.zip.sha
[ubuntu-14.04-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-ubuntu-x64.latest.deb
[ubuntu-14.04-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-ubuntu-x64.latest.deb.sha
[ubuntu-14.04-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-ubuntu-x64.latest.tar.gz
[ubuntu-14.04-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-ubuntu-x64.latest.tar.gz.sha
[ubuntu-16.04-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-ubuntu.16.04-x64.latest.tar.gz
[ubuntu-16.04-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-ubuntu.16.04-x64.latest.tar.gz.sha
[debian-8.2-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-debian-x64.latest.tar.gz
[debian-8.2-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-debian-x64.latest.tar.gz.sha
[osx-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-osx-x64.latest.pkg
[osx-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-osx-x64.latest.pkg.sha
[osx-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-osx-x64.latest.tar.gz
[osx-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-osx-x64.latest.tar.gz.sha
[centos-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-centos-x64.latest.tar.gz
[centos-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-centos-x64.latest.tar.gz.sha
[rhel-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-rhel-x64.latest.tar.gz
[rhel-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-rhel-x64.latest.tar.gz.sha
Add contrib guidelines, Docker links Add contribution guidelines. These just link to the CoreCLR ones. Add stubs of the "user guide" and "developer guide". Add links to the Docker base image repo on GitHub.
2015-11-16 20:22:11 +00:00
Docker
------
Update README.md
2015-10-19 08:47:45 +00:00
Add proper Docker link & some basic usage Add proper link to the Docker Hub for Docker images. Include some basic usage for the tools in the Readme.md so that users can have an immidiate start if they come to the repo first.
2015-11-18 07:19:39 +00:00
You can also use our Docker base images found on https://hub.docker.com/r/microsoft/dotnet to set up your dev or testing environment for usage.
Basic usage
-----------
Update Readme.md Fixed a typo
2015-12-31 17:38:04 +00:00
When you have the .NET Command Line Interface installed on your OS of choice, you can try it out using some of the samples on the [dotnet/core repo](https://github.com/dotnet/core/tree/master/samples). You can download the sample in a directory, and then you can kick the tires of the CLI.
Adding new stuff to README
2015-11-18 15:19:05 +00:00
Add proper Docker link & some basic usage Add proper link to the Docker Hub for Docker images. Include some basic usage for the tools in the Readme.md so that users can have an immidiate start if they come to the repo first.
2015-11-18 07:19:39 +00:00
First, you will need to restore the packages:
dotnet restore
This will restore all of the packages that are specified in the project.json file of the given sample.
Then you can either run from source or compile the sample. Running from source is straightforward:
dotnet run
Compiling to IL is done using:
update readmes to refer to build instead of compile
2015-12-29 21:37:12 +00:00
dotnet build
Update Readme for Mac CPPCodegen support
2015-11-25 18:16:57 +00:00
Update README.md (#3309) Adding more stuff around the docs and release schedules. Also, changing the outdated running information. skip ci please
2016-06-02 14:20:23 +00:00
This will drop an IL assembly in `./bin/[configuration]/[framework]/[binary name]`
that you can run using `dotnet bin/[configuration]/[framework]/[binaryname.dll]`.
Update CLI Readme.md for Mac JIT support
2015-12-19 23:19:57 +00:00
Update README.md (#3709) * Update README.md Fixing documentation links to point to actual (new) docs.
2016-06-27 22:48:49 +00:00
For more details, please refer to the [documentation](https://aka.ms/dotnet-cli-docs).
Update Readme for Mac CPPCodegen support
2015-11-25 18:16:57 +00:00
Additions to the intro document
2015-11-27 17:02:31 +00:00
Building from source
--------------------
Fix a couple of typos in the .md/doc files
2016-03-18 04:27:33 +00:00
If you are building from source, take note that the build depends on NuGet packages hosted on MyGet, so if it is down, the build may fail. If that happens, you can always see the [MyGet status page](http://status.myget.org/) for more info.
Update README.md Adding information about DOTNET_HOME to README.md when building from source.
2016-01-11 17:51:43 +00:00
Fixed links in README.md
2016-06-07 16:42:05 +00:00
Read over the [contributing guidelines](CONTRIBUTING.md) and [developer documentation](Documentation) for prerequisites for building from source.
Links to dev docs in root readme
2016-02-25 09:58:24 +00:00
Add contrib guidelines, Docker links Add contribution guidelines. These just link to the CoreCLR ones. Add stubs of the "user guide" and "developer guide". Add links to the Docker base image repo on GitHub.
2015-11-16 20:22:11 +00:00
Questions & Comments
--------------------
add some readme
2015-10-08 21:49:39 +00:00
Add contrib guidelines, Docker links Add contribution guidelines. These just link to the CoreCLR ones. Add stubs of the "user guide" and "developer guide". Add links to the Docker base image repo on GitHub.
2015-11-16 20:22:11 +00:00
For any and all feedback, please use the Issues on this repository.
Updating EULA and README for data collection policy
2016-03-30 23:42:25 +00:00
License
[Build kick-off] Change underline to match length
2016-10-27 23:02:05 +00:00
-------
Updating EULA and README for data collection policy
2016-03-30 23:42:25 +00:00
Update README.md
2016-06-27 18:55:38 +00:00
By downloading the .zip you are agreeing to the terms in the project [EULA](https://aka.ms/dotnet-core-eula).
Reference in a new issue Copy permalink