|
| 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.20 |
| 10 | +ifdef::env-github,env-browser[:outfilesuffix:.adoc] |
| 11 | + |
| 12 | +The {release} release has both user-facing and internal enhancements, including fixes and updates to {proglang}, the {proglang} base library, and Candid. |
| 13 | + |
| 14 | +== New features and capabilities |
| 15 | + |
| 16 | +The most significant new features and capabilities include updates in the following functional areas: |
| 17 | + |
| 18 | +* <<DFX,DFX>> |
| 19 | +* <<Candid,Candid>> |
| 20 | +* <<Motoko,Motoko>> |
| 21 | + |
| 22 | +=== DFX |
| 23 | + |
| 24 | +* A new notification message that the DFINITY Canister SDK sends anonymous usage data to DFINITY Stiftung by |
| 25 | +default has been added to `+dfx+` commands. |
| 26 | +The notification message is only displayed once, the first time you run any `+dfx+` subcommand. |
| 27 | +For example, the first time you run `+dfx new+` to create a new project, the notification is displayed before any other project creation messages. |
| 28 | ++ |
| 29 | +The purpose of this notification is to inform you that `+dfx+` is configured to collect anonymous information about `+dfx+` command activity and errors. |
| 30 | +Collecting anonymous data is enabled by default in an effort to improve the developer experience based on usage patterns and behavior. |
| 31 | ++ |
| 32 | +If you want to prevent the collection of data about `+dfx+` usage, you can explicitly opt-out by setting the following environment |
| 33 | +variable: |
| 34 | ++ |
| 35 | +.... |
| 36 | +DFX_TELEMETRY_DISABLED=1 |
| 37 | +.... |
| 38 | ++ |
| 39 | +To find out more about the data collected and what your consent means, see the DFINITY Canister SDK link:https://sdk.dfinity.org/sdk-license-agreement.txt[Terms and Conditions]. |
| 40 | + |
| 41 | +* The `+dfx+` commands that support the `+--network+` option have been updated to support URLs when specifying the network value. |
| 42 | ++ |
| 43 | +Previously, the `+--network+` option required you to specify a network name that matched a network aliases configured in the project's `+dfx.json+` file. |
| 44 | + |
| 45 | +=== Candid |
| 46 | + |
| 47 | +The Candid web interface has been updated to provide easier navigation and a better user experience. |
| 48 | +The updates to the Candid web interface include the following new features and improvements: |
| 49 | + |
| 50 | +* A new Console drawer provides quick access to method output and a list of all available methods as links for fast navigation. |
| 51 | +* Canister methods and their related form elements are more clearly separated and annotated. |
| 52 | +* Method output is selectable and easier to toggle between text, UI, and JSON formats. |
| 53 | +* The layout is now responsive to provide an optimized display when viewing service using mobile devices or other media. |
| 54 | + |
| 55 | +=== Motoko |
| 56 | + |
| 57 | +* The {proglang} base documentation examples are now executable in the browser. |
| 58 | + |
| 59 | +* The {proglang} compiler supports specifying command-line arguments using `+--args <file>+` and `+--args0 <file>+`. |
| 60 | ++ |
| 61 | +The new options enable the compiler to read newline and NUL terminated arguments from a specified file name. |
| 62 | + |
| 63 | +== Issues fixed in this release |
| 64 | + |
| 65 | +This section covers any reported issues that have been fixed in this release. |
| 66 | + |
| 67 | +== Known issues and limitations |
| 68 | + |
| 69 | +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