Skip to content

Commit

Permalink
Add more details and examples for embedded relative path to apphost-e…
Browse files Browse the repository at this point in the history
…mbed-install-location.md (#319)
  • Loading branch information
elinor-fung authored Aug 2, 2024
1 parent 62c393d commit 272c7f8
Showing 1 changed file with 10 additions and 0 deletions.
10 changes: 10 additions & 0 deletions proposed/apphost-embed-install-location.md
Original file line number Diff line number Diff line change
Expand Up @@ -104,6 +104,16 @@ explicitly set to a value that does not include `AppRelative`, then setting
`AppHostRelativeDotNet` is meaningless - the SDK will not write the relative
path into the `apphost` and the `apphost` will not check for a relative path.

The path must not be rooted and will be written into the `apphost` unmodified.
At run time, the path will be considered relative to the app location - that is,
it is appended to the location of the `apphost` itself. The app relies on file
system APIs of the underlying OS to determine if the path is valid and exists.

When running `C:\dir\app.exe` or `/home/dir/app` with `AppHostRelativeDotNet` set to:
- `my_dotnet`: the app will look at `C:\dir\my_dotnet` or `/home/dir/my_dotnet`
- `./my_dotnet`: the app will look at `C:\dir\my_dotnet` or `/home/dir/my_dotnet`
- `../my_dotnet` the app will look at `C:\my_dotnet` or `/home/my_dotnet`

## Updated behaviour

At a high level, the updated process and priority for `apphost` determining the
Expand Down

0 comments on commit 272c7f8

Please sign in to comment.