Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add a doc describing how to add new RIDs to source-build #2103

Merged
merged 3 commits into from
Jun 10, 2021

Conversation

omajid
Copy link
Member

@omajid omajid commented Mar 22, 2021

Anyone else adding their Linux distribution's RID to source-build might find this useful.

I am trying to get this out of my head and into a shape where others can make use of this.

See: #2095

Anyone else adding their Linux distribution's RID to source-build
might find this useful.

I am trying to get this out of my head and into a shape where others
can make use of this.

See: dotnet#2095
@omajid
Copy link
Member Author

omajid commented Mar 22, 2021

cc @crummel

@dotnet-issue-labeler dotnet-issue-labeler bot added the area-additional-repos Adding additional contributing repos label Mar 22, 2021
Then build with the `/p:UpdateRuntimeFiles=true` flag:

```
./build.sh /p:UpdateRuntimeFiles=true

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe this should be
./build.sh -- /p:UpdateRuntimeFiles=true

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the dotnet/runtime release/5.0 branch, ./build.sh --help says:

...
Command line arguments starting with '/p:' are passed through to MSBuild.
...

Have you run into any cases where -- was required?

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Defenitly yes

dotnet-v5.0.104-SDK$ ./build.sh --help
usage: ./build.sh [options]
options:
  --with-ref-packages <dir>          use the specified directory of reference packages
  --with-packages <dir>              use the specified directory of previously-built packages
  --with-sdk <dir>                   use the SDK in the specified directory for bootstrapping
use -- to send the remaining arguments to MSBuild
dotnet-v5.0.104-SDK$ ./build.sh --with-sdk ../bootstrap/.dotnet /p:UpdateRuntimeFiles=true 
Unrecognized argument '/p:UpdateRuntimeFiles=true'
usage: ./build.sh [options]
options:
  --with-ref-packages <dir>          use the specified directory of reference packages
  --with-packages <dir>              use the specified directory of previously-built packages
  --with-sdk <dir>                   use the SDK in the specified directory for bootstrapping
use -- to send the remaining arguments to MSBuild

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hm. I think we might be talking about different things.

I think you are looking at source-build's support/tarball/build.sh (which becomes ./build.sh when you create the tarball). That needs -- to separate normal arguments from msbuild arguments.

The step here is for passing the /p:UpdateRuntimeFiles flag to dotnet/runtime's build.sh, which doesn't need that: https://github.com/dotnet/runtime/blob/fb2db274ae16120b16c64167cc00538b2acaf155/eng/common/build.sh#L40

Do you know where I could have made that clearer in this doc?

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank You very match

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

May be after "1. Grab the source code" add something like "(Not this repository) because I completly miss it :(

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! Does the new commit make it clearer?

Copy link
Contributor

@crummel crummel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for writing this up, I think it's be really helpful!

Documentation/add-new-rid.md Outdated Show resolved Hide resolved
Co-authored-by: Chris Rummel <crummel@microsoft.com>
@dseefeld dseefeld merged commit 5df7424 into dotnet:release/5.0 Jun 10, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area-additional-repos Adding additional contributing repos
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants