Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Uninstall OpenMI 1.2 or any other previous OpenMI releases on your computer.

  2. Download the OATC SDK from http://sourceforge.net/projects/openmi/Image Removed.

  3. Unzip the files.

  4. If you do not already have NUnit installed, it is recommended to install it. recommended that you install it from http://nunit.org/Image Removed.

  5. Open the Oatc.OpenMI.Sdk.sln solution and rebuild all.

  6. Add your existing wrapper project to the Oatc.OpenMI.Sdk.sln (also add unit test project, if you have that).

  7. In your wrapper project (and unit test project if you have that) remove the reference to org.OpenMI.Standard and subsequently add a reference to the OpenMI.Standard.dll using the browse Browse tab in the add reference Add Rference dialog in Visual Studio. The OpenMI.Standard.dll is located in <yourUnzipfolder>\OpenMI.Standard\src\csharp\bin.

  8. In your wrapper project (and unit test project if you have that) references to org.OpenMI.Backbone, org.OpenMI.DevelopmentSupport , organd org.OpenMI.Utilities.Wrapper, org.OpenMI.Utilities.Spatial, org.OpenMI.Utilities.Buffer should be replaced by references to the projects Oatc.OpenMI.Sdk.Backbone, Oatc.OpenMI.Sdk.DevelopmentSupport, Oatc.OpenMI.Sdk.Wrapper, Oatc.OpenMI.Sdk.Spatial , and Oatc.OpenMI.Sdk.Buffer, respectively. All "'using statements" ' in your source code should be changes accordantlychanged accordingly.

  9. If you are using fully-qualified class names for classes from the Sdk SDK or the OpenMI.Standard, these should also be changed (use search and replace). E.g. if  For example, if you have a class declared as org.OpenMI.Utilities.Wrapper.LinkableEngine this should be changed to Oatc.OpenMI.Sdk.Wrapper.LinkableEngine. Note that when changing fully-qualified references to interfaces in the OpenMI.Standard you may have to use the "'global" keyword. E.g. org.' keyword; for example, org.OpenMI.Standard.IDimension is changed to global::OpenMI.Standard.IDimension.

  10. Rebuild all.

  11. If you are using unit test, run these now.

  12. Create a an OpenMICompliancyInfo xml file for your component. This file must be verifiable with the schema: http://www.openmi.org/schemas/OpenMICompliancyInfo.xsdImage Removed. You can find an example of such file for the simple river example, which is included in the SDK release (see <yourUnzipFolder>\Oatc\src\csharp\Examples\ModelComponents\SimpleRiver.simpleRiver.xml).

  13. Mail the OpenMICompliancyInfo xml file to Association@openmi.org, with a request for having your request to have your component officially accepted as OpenMI-compliant.

    Note that the steps explained above is steps above are just one possible way to upgrade your code. You may want to organize things differently and you may have nice tools that will help you refactoring refactor your code, which will make your work even easier.

    With the OpenMI 1.4 release you will, as a model provider, have to provide all required assembly files (also the OpenMI.Standard.dll and Oatc.OpenMI.Sdk..dllSdkdll's). For this reason it is recommended (but not required) that you change the Oatc.OpenMI.Sdk . namespaces to e.g. , for example, <MyCompany>.OpenMI.Sdk.*. You may or may not chose choose to install your assemblies into the GAC. If you choose for the latter you must sign all the assemblies with you your own signature file.