Skip to content

Commit

Permalink
Add docs
Browse files Browse the repository at this point in the history
  • Loading branch information
jakub-gonet committed Sep 23, 2024
1 parent 3ab3412 commit 878b121
Show file tree
Hide file tree
Showing 2 changed files with 38 additions and 1 deletion.
37 changes: 37 additions & 0 deletions packages/docs/docs/launch-configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -124,6 +124,43 @@ Below is an example of how the `launch.json` file could look like with android v
}
```

### Custom build settings

Instead of letting Radon IDE build your app, you can use scripts or [Expo
Application Services (EAS)](https://expo.dev/eas) to do
it with `buildScript` configuration option.

The requirement for scripts is to output the absolute path to the built app as the
last line of standard output.

You can also use `eas build`, `eas build:list` or `eas build:view` with
JSON output to use builds from EAS. If multiple builds are present, Radon IDE
will take the most recent one. Builds for iOS need to have `"ios.simulator":
true` config option set.

`buildScript` configuration option is an object with `ios` and `android` keys.
Both are optional, specifying any of them will replace default build logic for
that platform with command of your choice.

Below is an example that replaces Android build with build from EAS:

```json
{
"version": "0.2.0",
"configurations": [
{
"type": "radon-ide",
"request": "launch",
"name": "Radon IDE panel",
"buildScript": {
"android": "eas build:list --non-interactive --json --platform android"
}
}
]
}
```


### Other settings

Here, we list other attributes that can be configured using launch configuration which doesn't fit in any of the above categories:
Expand Down
2 changes: 1 addition & 1 deletion packages/vscode-extension/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -210,7 +210,7 @@
},
"buildScript": {
"type": "object",
"description": "Scripts used to build Android or iOS app or fetch them from known location. Executed as part of building process. Should print a JSON result from `eas build` command (invoked with --json --non-interactive flags and profile used for development) or a filesystem path to the built app as the last line of the standard output.",
"description": "Scripts used to build Android or iOS app or fetch them from known location. Executed as a part of building process. Should print a JSON result from `eas build` command or a filesystem path to the built app as the last line of the standard output.\nIf using EAS, it should be invoked with --json --non-interactive flags and use a profile for development, iOS additionally needs `\"ios.simulator\": true` config option in eas.json",
"properties": {
"ios": {
"type": "string",
Expand Down

0 comments on commit 878b121

Please sign in to comment.