|
| 1 | += Highlights of what's new in {release} |
| 2 | +:description: DFINITY Canister Software Development Kit Release Notes |
| 3 | +:proglang: Motoko |
| 4 | +:platform: Internet Computer platform |
| 5 | +:IC: Internet Computer |
| 6 | +:company-id: DFINITY |
| 7 | +:sdk-short-name: DFINITY Canister SDK |
| 8 | +:sdk-long-name: DFINITY Canister Software Development Kit (SDK) |
| 9 | +:release: 0.6.25 |
| 10 | +ifdef::env-github,env-browser[:outfilesuffix:.adoc] |
| 11 | + |
| 12 | +The {release} release primarily consists of changes to support new features that are not yet complete, including fixes and updates to DFX commands, {proglang}, the {proglang} base library, and Candid. |
| 13 | + |
| 14 | +== New features and capabilities |
| 15 | + |
| 16 | +The most significant new features and capabilities include the following updates: |
| 17 | + |
| 18 | +* This release introduces environment variables for specifying canister identifiers. |
| 19 | ++ |
| 20 | +You can now use the `CANISTER_ID_{canister.name}` and `CANISTER_CANDID_PATH_{canister.name}` |
| 21 | +environment variables to reference canister identifiers and the path to the canister Candid description (`.did` file) during the build process. |
| 22 | +These environment variables enable you to construct the JavaScript for front-end assets using the correct canister identifiers. |
| 23 | ++ |
| 24 | +The environment variables are intended to replace the `+import+` syntax for dependent canisters described in link:../developers-guide/webpack-config{outfilesuffix}[Entry and output configuration] which is being deprecated and will be removed in a future release. |
| 25 | + |
| 26 | +* A new `+deploy identity import+` subcommand enables you to import a security certificate to create an identity. |
| 27 | ++ |
| 28 | +For example, if you use a hardware wallet or a key generation utility to generate a PEM file for authenticating your identity, you can now import that PEM file into `+dfx+` to create a new identity. |
| 29 | +After importing the PEM file, you can run the `dfx identity use` command t set that identity as your default context. |
| 30 | ++ |
| 31 | +For example, to import the `my-external-id.pem` and create an identity named `alice`, you would run the following command: |
| 32 | ++ |
| 33 | +.... |
| 34 | +dfx identity import alice my-external-id.pem |
| 35 | +.... |
| 36 | ++ |
| 37 | +After running this command, you would run the following command to begin using the new identity: |
| 38 | ++ |
| 39 | +.... |
| 40 | +dfx identity use alice |
| 41 | +.... |
| 42 | + |
| 43 | +== Issues fixed in this release |
| 44 | + |
| 45 | +This section covers any reported issues that have been fixed in this release. |
| 46 | + |
| 47 | +== Known issues and limitations |
| 48 | + |
| 49 | +This section covers any known issues or limitations that might affect how you work with the {sdk-short-name} in specific environments or scenarios. |
0 commit comments