Adds upgrade notes for v1 to v2. Minor tweaks (e.g. ToC).

This commit is contained in:
Joel Dudley 2017-11-22 17:33:40 +00:00 committed by GitHub
parent f314bf4849
commit 7bde9ecefd
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -1,11 +1,14 @@
Upgrade notes Upgrade notes
============= =============
These notes provide helpful instructions to upgrade your Corda Applications (CorDapps) from previous versions, starting These notes provide instructions for upgrading your CorDapps from previous versions, starting with the upgrade from our
from our first public Beta (:ref:`Milestone 12 <changelog_m12>`), to :ref:`V1.0 <changelog_v1>` first public Beta (:ref:`Milestone 12 <changelog_m12>`), to :ref:`V1.0 <changelog_v1>`.
General .. contents::
------- :depth: 3
General rules
-------------
Always remember to update the version identifiers in your project gradle file: Always remember to update the version identifiers in your project gradle file:
.. sourcecode:: shell .. sourcecode:: shell
@ -29,7 +32,7 @@ UNRELEASED
---------- ----------
Testing Testing
^^^^^^^ ~~~~~~~
* The registration mechanism for CorDapps in ``MockNetwork`` unit tests has changed. * The registration mechanism for CorDapps in ``MockNetwork`` unit tests has changed.
@ -38,9 +41,23 @@ Testing
package names of the CorDapps containing the contract verification code you wish to load. package names of the CorDapps containing the contract verification code you wish to load.
The ``unsetCordappPackages`` method is now redundant and has been removed. The ``unsetCordappPackages`` method is now redundant and has been removed.
:ref:`Milestone 14 <changelog_m14>` V1.0 to V2.0
------------ ------------
You only need to update the ``corda_release_version`` identifier in your project gradle file. The
corda_gradle_plugins_version should remain at 1.0.0:
.. sourcecode:: shell
ext.corda_release_version = '2.0.0'
ext.corda_gradle_plugins_version = '1.0.0'
Public Beta (M12) to V1.0
-------------------------
:ref:`From Milestone 14 <changelog_m14>`
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Build Build
^^^^^ ^^^^^
@ -151,7 +168,7 @@ Flow framework
Note that ``SwapIdentitiesFlow`` must be imported from the *confidential-identities** package ''net.corda.confidential'' Note that ``SwapIdentitiesFlow`` must be imported from the *confidential-identities** package ''net.corda.confidential''
Node services (ServiceHub) Node services (ServiceHub)
^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^
* VaultQueryService: unresolved reference to `vaultQueryService`. * VaultQueryService: unresolved reference to `vaultQueryService`.
@ -243,8 +260,8 @@ Gotchas
The 3rd parameter to ``CashIssueFlow`` should be the ** notary ** (not the ** node identity **) The 3rd parameter to ``CashIssueFlow`` should be the ** notary ** (not the ** node identity **)
:ref:`Milestone 13 <changelog_m13>` :ref:`From Milestone 13 <changelog_m13>`
------------ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Core data structures Core data structures
^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^
@ -266,7 +283,7 @@ Core data structures
* No longer need to override Contract ``contract()`` function. * No longer need to override Contract ``contract()`` function.
Node services (ServiceHub) Node services (ServiceHub)
^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^
* ServiceHub API method changes. * ServiceHub API method changes.
@ -311,8 +328,8 @@ Testing
``CordaX500Name``, instead of using ``getX509Name`` ``CordaX500Name``, instead of using ``getX509Name``
:ref:`Milestone 12 <changelog_m12>` (First Public Beta) :ref:`From Milestone 12 (First Public Beta) <changelog_m12>`
----------------------------------- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Core data structures Core data structures
^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^
@ -338,7 +355,7 @@ Build
compile "net.corda:rpc:$corda_release_version" -> compile "net.corda:corda-rpc:$corda_release_version" compile "net.corda:rpc:$corda_release_version" -> compile "net.corda:corda-rpc:$corda_release_version"
Node services (ServiceHub) Node services (ServiceHub)
^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^
* ServiceHub API changes. * ServiceHub API changes.