@@ -60,20 +60,20 @@ See [DEVELOPING.md](DEVELOPING.md)
60
60
61
61
## ` sf package convert `
62
62
63
- Create a second- generation package version from a first -generation package.
63
+ Convert a managed-released first- generation managed package into a second -generation managed package.
64
64
65
65
```
66
66
USAGE
67
67
$ sf package convert -v <value> -p <value> [--json] [--flags-dir <value>] [--api-version <value>] [-k <value>] [-f
68
68
<value>] [-x] [-w <value>] [-m <value>] [--verbose] [-a <value>]
69
69
70
70
FLAGS
71
- -a, --patch-version=<value> Specific released patch version to convert
71
+ -a, --patch-version=<value> Specific released patch version to be converted.
72
72
-f, --definition-file=<value> Path to a definition file that contains features and org preferences that the metadata
73
73
of the package version depends on.
74
74
-k, --installation-key=<value> Installation key for key-protected package.
75
75
-m, --seed-metadata=<value> Directory containing metadata to be deployed prior to conversion.
76
- -p, --package=<value> (required) ID (starts with 033) of the first-generation package to convert.
76
+ -p, --package=<value> (required) ID (starts with 033) of the first-generation managed package to convert.
77
77
-v, --target-dev-hub=<value> (required) Username or alias of the Dev Hub org. Not required if the `target-dev-hub`
78
78
configuration variable is already set.
79
79
-w, --wait=<value> Minutes to wait for the package version to be created.
@@ -86,30 +86,27 @@ GLOBAL FLAGS
86
86
--json Format output as json.
87
87
88
88
DESCRIPTION
89
- Create a second- generation package version from a first -generation package.
89
+ Convert a managed-released first- generation managed package into a second -generation managed package.
90
90
91
- The package convert creates a new package in the Dev Hub if one does not already exist for the specified
92
- first -generation package.
91
+ The package conversion command automatically selects the latest released major.minor first-generation managed package
92
+ version, and converts it into a second -generation managed package version .
93
93
94
- It then creates a new package version in the Dev Hub with contents based on the specified first-generation package.
95
-
96
- By default, the latest released non-patch version from the specified first-generation package will be converted. Use
97
- --patch-version to override the default. Read more about --patch-version option in help
94
+ Use --patch-version to specify a released patch version.
98
95
99
96
To retrieve details about a package version create request, including status and package version ID (04t), run "sf
100
97
package version create report -i 08c...".
101
98
102
- We recommend specifying the --installation-key to protect the contents of your package and to prevent unauthorized
103
- installation of your package .
99
+ To protect the contents of your package and to prevent unauthorized installation of your package, specify the
100
+ -- installation-key flag .
104
101
105
102
To list package version creation requests in the org, run "sf package version create list".
106
103
107
104
ALIASES
108
105
$ sf force package convert
109
106
110
107
EXAMPLES
111
- Create a second-generation package version from the first-generation package with the specified ID and give it the
112
- installation key "password123"; uses your default Dev Hub org:
108
+ Create a second-generation managed package version from the first-generation managed package with the specified ID
109
+ and give it the installation key "password123"; uses your default Dev Hub org:
113
110
114
111
$ sf package convert --package 033... --installation-key password123
115
112
@@ -118,9 +115,9 @@ EXAMPLES
118
115
$ sf package convert --package 033... --installation-key password123 --target-dev-hub [email protected]
119
116
120
117
FLAG DESCRIPTIONS
121
- -a, --patch-version=<value> Specific released patch version to convert
118
+ -a, --patch-version=<value> Specific released patch version to be converted.
122
119
123
- Specify a released patch version as major.minor.patch.build to convert to second generation package version
120
+ Specify a released patch version as major.minor.patch to convert to a second- generation managed package version.
124
121
125
122
-f, --definition-file=<value>
126
123
@@ -135,15 +132,15 @@ FLAG DESCRIPTIONS
135
132
136
133
-m, --seed-metadata=<value> Directory containing metadata to be deployed prior to conversion.
137
134
138
- The directory containing metadata that will be deployed on the build org prior to attempting conversion.
135
+ The directory containing metadata that will be deployed on the build org prior to attempting package conversion.
139
136
140
137
-x, --installation-key-bypass Bypass the installation key requirement.
141
138
142
139
If you bypass this requirement, anyone can install your package. Either an --installation-key value or the
143
140
--installation-key-bypass flag is required.
144
141
```
145
142
146
- _ See code: [ src/commands/package/convert.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/convert.ts ) _
143
+ _ See code: [ src/commands/package/convert.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/convert.ts ) _
147
144
148
145
## ` sf package create `
149
146
@@ -222,7 +219,7 @@ FLAG DESCRIPTIONS
222
219
Org-Dependent Unlocked Packages" in the Salesforce DX Developer Guide.
223
220
```
224
221
225
- _ See code: [ src/commands/package/create.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/create.ts ) _
222
+ _ See code: [ src/commands/package/create.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/create.ts ) _
226
223
227
224
## ` sf package delete `
228
225
@@ -264,7 +261,7 @@ EXAMPLES
264
261
$ sf package delete --package 0Ho... --target-dev-hub [email protected]
265
262
```
266
263
267
- _ See code: [ src/commands/package/delete.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/delete.ts ) _
264
+ _ See code: [ src/commands/package/delete.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/delete.ts ) _
268
265
269
266
## ` sf package install `
270
267
@@ -363,7 +360,7 @@ FLAG DESCRIPTIONS
363
360
- Delete: Delete all removed components that can be safely deleted, and deprecate the other components.
364
361
```
365
362
366
- _ See code: [ src/commands/package/install.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/install.ts ) _
363
+ _ See code: [ src/commands/package/install.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/install.ts ) _
367
364
368
365
## ` sf package install report `
369
366
@@ -396,7 +393,7 @@ EXAMPLES
396
393
$ sf package install report --request-id 0Hf... --target-org [email protected]
397
394
```
398
395
399
- _ See code: [ src/commands/package/install/report.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/install/report.ts ) _
396
+ _ See code: [ src/commands/package/install/report.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/install/report.ts ) _
400
397
401
398
## ` sf package installed list `
402
399
@@ -428,7 +425,7 @@ EXAMPLES
428
425
$ sf package installed list --target-org [email protected]
429
426
```
430
427
431
- _ See code: [ src/commands/package/installed/list.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/installed/list.ts ) _
428
+ _ See code: [ src/commands/package/installed/list.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/installed/list.ts ) _
432
429
433
430
## ` sf package list `
434
431
@@ -466,7 +463,7 @@ EXAMPLES
466
463
$ sf package list --target-dev-hub [email protected] --verbose
467
464
```
468
465
469
- _ See code: [ src/commands/package/list.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/list.ts ) _
466
+ _ See code: [ src/commands/package/list.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/list.ts ) _
470
467
471
468
## ` sf package push-upgrade abort `
472
469
@@ -506,7 +503,7 @@ EXAMPLES
506
503
$ sf package push-upgrade abort --push-request-id 0DV... --target-dev-hub [email protected]
507
504
```
508
505
509
- _ See code: [ src/commands/package/push-upgrade/abort.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/push-upgrade/abort.ts ) _
506
+ _ See code: [ src/commands/package/push-upgrade/abort.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/push-upgrade/abort.ts ) _
510
507
511
508
## ` sf package push-upgrade list `
512
509
@@ -565,7 +562,7 @@ EXAMPLES
565
562
$ sf package push-upgrade list --package 033xyz –-status Failed
566
563
```
567
564
568
- _ See code: [ src/commands/package/push-upgrade/list.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/push-upgrade/list.ts ) _
565
+ _ See code: [ src/commands/package/push-upgrade/list.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/push-upgrade/list.ts ) _
569
566
570
567
## ` sf package push-upgrade report `
571
568
@@ -607,7 +604,7 @@ EXAMPLES
607
604
$ sf package push-upgrade report --push-request-id 0DV... --target-dev-hub [email protected]
608
605
```
609
606
610
- _ See code: [ src/commands/package/push-upgrade/report.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/push-upgrade/report.ts ) _
607
+ _ See code: [ src/commands/package/push-upgrade/report.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/push-upgrade/report.ts ) _
611
608
612
609
## ` sf package push-upgrade schedule `
613
610
@@ -689,7 +686,7 @@ FLAG DESCRIPTIONS
689
686
Overrides the value of the target-dev-hub configuration variable, if set.
690
687
```
691
688
692
- _ See code: [ src/commands/package/push-upgrade/schedule.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/push-upgrade/schedule.ts ) _
689
+ _ See code: [ src/commands/package/push-upgrade/schedule.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/push-upgrade/schedule.ts ) _
693
690
694
691
## ` sf package uninstall `
695
692
@@ -737,7 +734,7 @@ EXAMPLES
737
734
$ sf package uninstall --package "Undesirable Package Alias"
738
735
```
739
736
740
- _ See code: [ src/commands/package/uninstall.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/uninstall.ts ) _
737
+ _ See code: [ src/commands/package/uninstall.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/uninstall.ts ) _
741
738
742
739
## ` sf package uninstall report `
743
740
@@ -770,7 +767,7 @@ EXAMPLES
770
767
$ sf package uninstall report --request-id 06y... --target-org [email protected]
771
768
```
772
769
773
- _ See code: [ src/commands/package/uninstall/report.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/uninstall/report.ts ) _
770
+ _ See code: [ src/commands/package/uninstall/report.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/uninstall/report.ts ) _
774
771
775
772
## ` sf package update `
776
773
@@ -825,7 +822,7 @@ FLAG DESCRIPTIONS
825
822
associated with your package.
826
823
```
827
824
828
- _ See code: [ src/commands/package/update.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/update.ts ) _
825
+ _ See code: [ src/commands/package/update.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/update.ts ) _
829
826
830
827
## ` sf package version create `
831
828
@@ -1000,7 +997,7 @@ FLAG DESCRIPTIONS
1000
997
periods of no output from commands.
1001
998
```
1002
999
1003
- _ See code: [ src/commands/package/version/create.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/version/create.ts ) _
1000
+ _ See code: [ src/commands/package/version/create.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/version/create.ts ) _
1004
1001
1005
1002
## ` sf package version create list `
1006
1003
@@ -1061,7 +1058,7 @@ EXAMPLES
1061
1058
$ sf package version create list --created-last-days 0 --status Success
1062
1059
```
1063
1060
1064
- _ See code: [ src/commands/package/version/create/list.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/version/create/list.ts ) _
1061
+ _ See code: [ src/commands/package/version/create/list.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/version/create/list.ts ) _
1065
1062
1066
1063
## ` sf package version create report `
1067
1064
@@ -1104,7 +1101,7 @@ EXAMPLES
1104
1101
$ sf package version create report --package-create-request-id 08c... --target-dev-hub [email protected]
1105
1102
```
1106
1103
1107
- _ See code: [ src/commands/package/version/create/report.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/version/create/report.ts ) _
1104
+ _ See code: [ src/commands/package/version/create/report.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/version/create/report.ts ) _
1108
1105
1109
1106
## ` sf package version delete `
1110
1107
@@ -1145,7 +1142,7 @@ EXAMPLES
1145
1142
$ sf package version delete --package 04t... --target-org [email protected]
1146
1143
```
1147
1144
1148
- _ See code: [ src/commands/package/version/delete.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/version/delete.ts ) _
1145
+ _ See code: [ src/commands/package/version/delete.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/version/delete.ts ) _
1149
1146
1150
1147
## ` sf package version displayancestry `
1151
1148
@@ -1205,7 +1202,7 @@ FLAG DESCRIPTIONS
1205
1202
You can use the DOT code output in graph visualization software to create tree visualizations.
1206
1203
```
1207
1204
1208
- _ See code: [ src/commands/package/version/displayancestry.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/version/displayancestry.ts ) _
1205
+ _ See code: [ src/commands/package/version/displayancestry.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/version/displayancestry.ts ) _
1209
1206
1210
1207
## ` sf package version list `
1211
1208
@@ -1281,7 +1278,7 @@ EXAMPLES
1281
1278
$ sf package version list --packages exp-mgr,exp-mgr-util --released --modified-last-days 0
1282
1279
```
1283
1280
1284
- _ See code: [ src/commands/package/version/list.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/version/list.ts ) _
1281
+ _ See code: [ src/commands/package/version/list.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/version/list.ts ) _
1285
1282
1286
1283
## ` sf package version promote `
1287
1284
@@ -1325,7 +1322,7 @@ EXAMPLES
1325
1322
$ sf package version promote --package "Awesome Package Alias"
1326
1323
```
1327
1324
1328
- _ See code: [ src/commands/package/version/promote.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/version/promote.ts ) _
1325
+ _ See code: [ src/commands/package/version/promote.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/version/promote.ts ) _
1329
1326
1330
1327
## ` sf package version report `
1331
1328
@@ -1365,7 +1362,7 @@ EXAMPLES
1365
1362
$ sf package version report --package "Your Package Alias" --target-dev-hub [email protected]
1366
1363
```
1367
1364
1368
- _ See code: [ src/commands/package/version/report.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/version/report.ts ) _
1365
+ _ See code: [ src/commands/package/version/report.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/version/report.ts ) _
1369
1366
1370
1367
## ` sf package version update `
1371
1368
@@ -1418,7 +1415,7 @@ EXAMPLES
1418
1415
$ sf package version update --package 04t... --version-description "New Package Version Description"
1419
1416
```
1420
1417
1421
- _ See code: [ src/commands/package/version/update.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package/version/update.ts ) _
1418
+ _ See code: [ src/commands/package/version/update.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package/version/update.ts ) _
1422
1419
1423
1420
## ` sf package1 version create `
1424
1421
@@ -1485,7 +1482,7 @@ FLAG DESCRIPTIONS
1485
1482
subscribers.
1486
1483
```
1487
1484
1488
- _ See code: [ src/commands/package1/version/create.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package1/version/create.ts ) _
1485
+ _ See code: [ src/commands/package1/version/create.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package1/version/create.ts ) _
1489
1486
1490
1487
## ` sf package1 version create get `
1491
1488
@@ -1518,7 +1515,7 @@ EXAMPLES
1518
1515
$ sf package1 version create get --request-id 0HD... --target-org [email protected]
1519
1516
```
1520
1517
1521
- _ See code: [ src/commands/package1/version/create/get.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package1/version/create/get.ts ) _
1518
+ _ See code: [ src/commands/package1/version/create/get.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package1/version/create/get.ts ) _
1522
1519
1523
1520
## ` sf package1 version display `
1524
1521
@@ -1552,7 +1549,7 @@ EXAMPLES
1552
1549
$ sf package1 version display --package-version-id 04t... --target-org [email protected]
1553
1550
```
1554
1551
1555
- _ See code: [ src/commands/package1/version/display.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package1/version/display.ts ) _
1552
+ _ See code: [ src/commands/package1/version/display.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package1/version/display.ts ) _
1556
1553
1557
1554
## ` sf package1 version list `
1558
1555
@@ -1590,6 +1587,6 @@ FLAG DESCRIPTIONS
1590
1587
If not specified, shows all versions for all packages (managed and unmanaged) in the org.
1591
1588
```
1592
1589
1593
- _ See code: [ src/commands/package1/version/list.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.3 /src/commands/package1/version/list.ts ) _
1590
+ _ See code: [ src/commands/package1/version/list.ts] ( https://github.com/salesforcecli/plugin-packaging/blob/2.15.4 /src/commands/package1/version/list.ts ) _
1594
1591
1595
1592
<!-- commandsstop -->
0 commit comments