You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: packages/documentation/docs/updates/migrate-v3.md
+54-49Lines changed: 54 additions & 49 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,9 +1,10 @@
1
1
# Migrate to v3
2
2
3
-
!!! warning "Superseded"
4
-
**UI5 CLI 3.0 has been superseded by version 4.0. See [Migrate to v4](./migrate-v4.md).**
3
+
::: warning "Superseded"
4
+
**UI5 CLI 3.0 has been superseded by version 4.0. See [Migrate to v4](./migrate-v4.md).**
5
5
6
-
Find the announcement blog post for version 3.0 here: **[SAP Community: UI5 CLI 3.0](https://blogs.sap.com/2023/02/10/ui5-tooling-3.0/)**
6
+
Find the announcement blog post for version 3.0 here: **[SAP Community: UI5 CLI 3.0](https://blogs.sap.com/2023/02/10/ui5-tooling-3.0/)**
7
+
:::
7
8
8
9
## Node.js and npm Version Support
9
10
@@ -19,8 +20,9 @@ This means your old projects might still work. Unless they have non-standard con
19
20
20
21
## Changes for Projects
21
22
22
-
!!! info
23
-
✅ Projects defining **Specification Version 2.x** are expected to be **fully compatible with UI5 CLI v3**
23
+
::: info
24
+
✅ Projects defining **Specification Version 2.x** are expected to be **fully compatible with UI5 CLI v3**
25
+
:::
24
26
25
27
For projects defining the latest **Specification Versions 3.0 and higher**, some changes apply:
26
28
@@ -30,8 +32,9 @@ See also [Configuration: Specification Version 3.0](../pages/Configuration.md#sp
30
32
31
33
## Changes for Extensions
32
34
33
-
!!! info
34
-
✅ Custom Tasks and Custom Middleware defining **Specification Version 2.x** are expected to be **fully compatible with UI5 CLI v3**
35
+
::: info
36
+
✅ Custom Tasks and Custom Middleware defining **Specification Version 2.x** are expected to be **fully compatible with UI5 CLI v3**
37
+
:::
35
38
36
39
For extensions defining the latest **Specification Versions 3.0 and higher**, some changes and improvements apply:
37
40
@@ -44,27 +47,28 @@ For extensions defining the latest **Specification Versions 3.0 and higher**, so
44
47
45
48
## Changes to Dependency Configuration
46
49
47
-
!!! info
48
-
✅ The **`ui5.dependencies` package.json configuration** becomes obsolete and is ignored in UI5 CLI v3.
49
-
50
-
Configuration like the following is not needed anymore:
51
-
52
-
```diff title="package.json"
53
-
{
54
-
[...]
55
-
- "ui5": {
56
-
- "dependencies": [
57
-
- "my-package"
58
-
- ]
59
-
- }
60
-
[...]
61
-
}
62
-
```
50
+
::: info
51
+
✅ The **`ui5.dependencies` package.json configuration** becomes obsolete and is ignored in UI5 CLI v3.
52
+
53
+
Configuration like the following is not needed anymore:
54
+
55
+
```diff title="package.json"
56
+
{
57
+
[...]
58
+
- "ui5": {
59
+
- "dependencies": [
60
+
- "my-package"
61
+
- ]
62
+
- }
63
+
[...]
64
+
}
65
+
```
63
66
64
-
`dependencies`, `devDependencies` and `optionalDependencies` are now [automatically analyzed](https://github.com/SAP/ui5-project/blob/ff04ae4aeeb7f7d889dffd0c0e3e8774dd708c79/lib/graph/providers/NodePackageDependencies.js#L104).
65
-
If a dependency can be configured as a UI5 project or UI5 CLI extension, it is added to the graph and its `dependencies` are analyzed.
67
+
`dependencies`, `devDependencies` and `optionalDependencies` are now [automatically analyzed](https://github.com/SAP/ui5-project/blob/ff04ae4aeeb7f7d889dffd0c0e3e8774dd708c79/lib/graph/providers/NodePackageDependencies.js#L104).
68
+
If a dependency can be configured as a UI5 project or UI5 CLI extension, it is added to the graph and its `dependencies` are analyzed.
66
69
67
-
Note that `devDependencies` and `optionalDependencies` are ignored for all but the current root project. For projects that are intended to be consumed in other projects (for example libraries), this means that any required custom tasks must be added to `dependencies`.
70
+
Note that `devDependencies` and `optionalDependencies` are ignored for all but the current root project. For projects that are intended to be consumed in other projects (for example libraries), this means that any required custom tasks must be added to `dependencies`.
let graph = await graphFromPackageDependencies({cwd: "."});
121
-
122
-
await graph.build({
123
-
destPath: "./dist",
124
-
includedDependencies: ["*"], // Parameter "buildDependencies" has been removed
125
-
});
126
-
}
127
-
```
130
+
}
131
+
```
128
132
129
133
## Changes to @ui5/cli
130
134
@@ -145,10 +149,11 @@ Especially for projects of type `library`, where standard tasks like [`buildThem
145
149
146
150
In the future, a caching mechanism should help and improve build times with this new behavior.
147
151
148
-
!!! info
149
-
The CLI flags `-a` and `--all` are still present and now an alias for `--include-all-dependencies`. This flag (along with `--include-dependency*` and `--exclude-dependency*`) mainly controls the **build output**. Use it to define whether dependency resources should be part of the build result.
152
+
::: info
153
+
The CLI flags `-a` and `--all` are still present and now an alias for `--include-all-dependencies`. This flag (along with `--include-dependency*` and `--exclude-dependency*`) mainly controls the **build output**. Use it to define whether dependency resources should be part of the build result.
150
154
151
-
Please also refer to the [`ui5 build` documentation](../pages/CLI.md#ui5-build).
155
+
Please also refer to the [`ui5 build` documentation](../pages/CLI.md#ui5-build).
Copy file name to clipboardExpand all lines: packages/documentation/docs/updates/migrate-v4.md
+7-5Lines changed: 7 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,12 +1,14 @@
1
1
# Migrate to v4
2
2
3
-
!!! tip "New Release"
4
-
**UI5 CLI 4.0 has been released on July 24, 2024 🎉**
3
+
::: tip "New Release"
4
+
**UI5 CLI 4.0 has been released on July 24, 2024 🎉**
5
5
6
-
Install the latest version in your projects via: `npm i --save-dev @ui5/cli@latest`
7
-
And update your global install via `npm i --global @ui5/cli@latest`
6
+
Install the latest version in your projects via: `npm i --save-dev @ui5/cli@latest`
7
+
And update your global install via `npm i --global @ui5/cli@latest`
8
+
9
+
And find the announcement blog post here: **[SAP Community: UI5 CLI 4.0](https://community.sap.com/t5/technology-blogs-by-sap/ui5-tooling-4-0/ba-p/13769578)**
10
+
:::
8
11
9
-
And find the announcement blog post here: **[SAP Community: UI5 CLI 4.0](https://community.sap.com/t5/technology-blogs-by-sap/ui5-tooling-4-0/ba-p/13769578)**
0 commit comments