diff --git a/modules/developers-guide/examples/define-actor-dfx.json b/modules/developers-guide/examples/define-actor-dfx.json index a277b04e4..de7fd422a 100644 --- a/modules/developers-guide/examples/define-actor-dfx.json +++ b/modules/developers-guide/examples/define-actor-dfx.json @@ -10,7 +10,7 @@ "packtool": "" } }, - "dfx": "0.6.11", + "dfx": "0.6.12", "networks": { "local": { "bind": "127.0.0.1:8000", diff --git a/modules/developers-guide/examples/multiple-actors/dfx.json b/modules/developers-guide/examples/multiple-actors/dfx.json index 4980656c3..eefad5042 100644 --- a/modules/developers-guide/examples/multiple-actors/dfx.json +++ b/modules/developers-guide/examples/multiple-actors/dfx.json @@ -18,7 +18,7 @@ "packtool": "" } }, - "dfx": "0.6.11", + "dfx": "0.6.12", "networks": { "local": { "bind": "127.0.0.1:8000", diff --git a/modules/developers-guide/examples/sample-0.6.2-dfx.json b/modules/developers-guide/examples/sample-0.6.2-dfx.json index 4d4fa6295..1e09deeac 100644 --- a/modules/developers-guide/examples/sample-0.6.2-dfx.json +++ b/modules/developers-guide/examples/sample-0.6.2-dfx.json @@ -23,7 +23,7 @@ "packtool": "" } }, - "dfx": "0.6.11", + "dfx": "0.6.12", "networks": { "local": { "bind": "127.0.0.1:8000", diff --git a/modules/developers-guide/examples/sample-dfx.json b/modules/developers-guide/examples/sample-dfx.json index 5937843f9..739d26839 100644 --- a/modules/developers-guide/examples/sample-dfx.json +++ b/modules/developers-guide/examples/sample-dfx.json @@ -24,7 +24,7 @@ } }, - "dfx": "0.6.11", + "dfx": "0.6.12", "networks": { "local": { "bind": "127.0.0.1:8000", diff --git a/modules/developers-guide/pages/install-upgrade-remove.adoc b/modules/developers-guide/pages/install-upgrade-remove.adoc index ec3e448cc..713137d52 100644 --- a/modules/developers-guide/pages/install-upgrade-remove.adoc +++ b/modules/developers-guide/pages/install-upgrade-remove.adoc @@ -56,7 +56,7 @@ The following table describes the development environment components that the in The `~/.cache/dfinity/versions` directory stores one or more versioned subdirectories of the {sdk-short-name}. Each versioned subdirectory contains the all of the directories and files required for a specific version of the {sdk-short-name}. -For example, if you list the contents of the `~/.cache/dfinity/versions/0.6.11` directory you would see the following core components: +For example, if you list the contents of the `~/.cache/dfinity/versions/0.6.12` directory you would see the following core components: .... total 338216 diff --git a/modules/quickstart/pages/dfx-deploy-quickstart.adoc b/modules/quickstart/pages/dfx-deploy-quickstart.adoc index 1584123af..712b4de70 100644 --- a/modules/quickstart/pages/dfx-deploy-quickstart.adoc +++ b/modules/quickstart/pages/dfx-deploy-quickstart.adoc @@ -67,7 +67,7 @@ The command displays version information for the developer command-line interfac + [source,bash] ---- -dfx 0.6.11 +dfx 0.6.12 ---- . Preview usage information for the developer command-line interface (`+dfx+`) commands by running the following command: + diff --git a/modules/quickstart/pages/quickstart.adoc b/modules/quickstart/pages/quickstart.adoc index ac99719f9..90450ce70 100644 --- a/modules/quickstart/pages/quickstart.adoc +++ b/modules/quickstart/pages/quickstart.adoc @@ -76,7 +76,7 @@ dfx --version The command displays version information for the `+dfx+` command-line executable similar to the following: + .... -dfx 0.6.11 +dfx 0.6.12 .... . Preview usage information for the other `+dfx+` command-line sub-commands by running the following command: + diff --git a/modules/release-notes/pages/sdk-release-notes.adoc b/modules/release-notes/pages/sdk-release-notes.adoc index 903604036..f902e1299 100644 --- a/modules/release-notes/pages/sdk-release-notes.adoc +++ b/modules/release-notes/pages/sdk-release-notes.adoc @@ -10,7 +10,7 @@ :page-layout: releasenotes :sdk-short-name: DFINITY Canister SDK :sdk-long-name: DFINITY Canister Software Development Kit (SDK) -:release: 0.6.11 +:release: 0.6.12 ifdef::env-github,env-browser[:outfilesuffix:.adoc] The {sdk-long-name} enables developers to develop applications for the {IC} using the {proglang} programing language. @@ -33,15 +33,56 @@ This {release} version of the software and programming language should not be us == Highlights of what's new in {release} -The {release} release includes both user-visible new features and internal enhancements and fixes. The most significant new features and capabilities include the following: +The {release} release includes both user-visible new features and internal enhancements and fixes. The most significant new features and fixes include the following: + +* You can now access the {IC} network running remotely without user name and password credentials using the new `+ic+` network alias. ++ +In previous releases, the network alias `+tungsten+` was pre-configured in the project `+dfx.json+` file. +With authorized credentials, you could then use this network alias to access to the {IC} network when running `+dfx+` commands by using the `+--network=tungsten+` option. ++ +In this release, the `+ic+` network alias is pre-configured in the project `+dfx.json+` file to replace the `+tungsten+` alias. +In addition, you are no longer required to provide a user name and password as credentials to authenticate your identity. +Instead, you can access the {IC} network when running `+dfx+` commands simply by using the new `+ic+` network alias. +For example, to register, build, and deploy an application on the {IC}, you can run the following command: ++ +.... +dfx deploy --network=ic +.... ++ +Note that the `+ic+` network alias is a reserved alias. +Although you can add other network providers to your `+dfx.json+` file, you cannot use the `+ic+` alias for those providers. +You can, however, use variations on the reserved name such as `+ic-pubs+` or `+ic-examplenet+`. + +* Error and status messages are decoded and displayed as human-readable text. ++ +Previously, some agent and HTTP error and status messages were returned in an encoded format. +With this release, these agent and HTTP status messages are properly decoded and displayed as human-readable plain text. + +* This release of {proglang} improves stability of +`Blob+` and `+Text+` iterators when garbage collection happens. + +* This release of {proglang} fixes some erroneous-reported type errors related to using `+break+` in the context of an unconditional `+loop+`. ++ +For example, {proglang} supports the following to break out of a loop without type errors: ++ +.... +label l : Int loop { break l(42) }; +.... + +For information about breaking changes that were introduced in previous releases, see <>. + +For information about known issues that were introduced in previous releases, see <>. + +=== Highlights of what's new in 0.6.11 + +The 0.6.11 release includes both user-visible new features and internal enhancements and fixes. The most significant new features and capabilities include the following: * You can now specify arguments on the command-line when you deploy a **single** canister using an actor class with the `+dfx deploy+` command. -* Improved handling of `+SIGINT+` and `+SIGTERM+` events ensures that Ctrl-C can now reliably shut down the {IC} network `+replica+` process when running the {IC} locally. +* Improved handling of `+SIGINT+` and `+SIGTERM+` events ensures that Ctrl-C can now reliably shut down the {IC} network `+replica+` process when running the {IC} locally. * Enable the `+dfx start+` and `+dfx bootstrap+` commands to start the {IC} using a randomly-selected webserver port. + -To use a randomly-selected port, you can specify `+0+` as the port when running `+dfx start+` or `+dfx bootstrap+` commands. +To use a randomly-selected port, you can specify `+0+` as the port when running `+dfx start+` or `+dfx bootstrap+` commands. For example: + .... @@ -170,7 +211,7 @@ This new support for multiple identities enables you to test role-based access c + ** Support for polymorphic equality that enables the `==` and `!=` operators to work on all shareable types. ** Improvements to catch clashing function and class declarations. -** Language support to enable canisters to take installation arguments. An actor **class** defines a canister that takes an argument on installation. +** Language support to enable canisters to take installation arguments. An actor **class** defines a canister that takes an argument on installation. ** Optimized backend handling for `Bool` data types. === Highlights of what's new in 0.6.6 @@ -198,7 +239,7 @@ The 0.6.3 release only included minor fixes and enhancements including the follo - The `+dfx start --clean+` command has been improved to no longer crash if you run the command in a project that is already in a clean state. + Without this fix, manually removing the directories the command is intended to delete would result in `+dfx+` exiting without restarting the {IC}. -- The parsing logic for the `+dfx canister call+` command has been improved to more consistently recognize arguments in Candid format and to return better error messages when argument formats are not recognized. +- The parsing logic for the `+dfx canister call+` command has been improved to more consistently recognize arguments in Candid format and to return better error messages when argument formats are not recognized. - The Welcome page displayed when you create a new project has been updated to reflect the current location of SDK and Motoko documentation. [[highlights]] @@ -261,7 +302,7 @@ The following sections describe the key features and enhancements that were intr + ** The `+motoko+` canister type uses the `+motoko+` (`+moc+`) compiler to build a canister. + -** The `+assets+` canister type uses `+npm run build+` by default to build files and uploads them to an asset canister. +** The `+assets+` canister type uses `+npm run build+` by default to build files and uploads them to an asset canister. + ** The `+custom+` canister type uses a custom builder that should output WebAssembly (WASM) and Candid (DID) files. - The `+dfx.json+` file includes network mapping for `+local+` and the {IC} network. The local network defaults to `+127.0.0.1:8000+`.