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

This commit is contained in:
joeldudleyr3 2017-11-21 10:05:03 +00:00
parent f91995b78d
commit b5f5f3f975

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
@ -25,10 +28,23 @@ versions you are currently using are still in force.
We also strongly recommend cross referencing with the :doc:`changelog` to confirm changes. We also strongly recommend cross referencing with the :doc:`changelog` to confirm changes.
:ref:`Milestone 14 <changelog_m14>` V1.0 to V2.0
------------ ------------
Build You only need to update the version identifiers in your project gradle file:
.. sourcecode:: shell
ext.corda_release_version = '2.0.0'
ext.corda_gradle_plugins_version = '2.0.0'
Public Beta (M12) to V1.0
-------------------------
:ref:`From Milestone 14 <changelog_m14>`
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Build
^^^^^ ^^^^^
* MockNetwork has moved. * MockNetwork has moved.
@ -138,7 +154,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`.
@ -230,8 +246,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
^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^
@ -253,7 +269,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.
@ -298,8 +314,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
^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^
@ -325,7 +341,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.