HowToRelease

This page explains how to create a release of ZamiaCAD plugin using the repositories.

• 1. Create a Product:
• 2. Create Feature Project
• 3. Create Update Site
• 4. Upload

1. Create a Product:

In Eclipse

• Install delta pack as http://ugosan.org/eclipse-rcp-delta-pack/ prescribes. Basically you go to Window > Prefereces > Plugin Development > Target Platform and Edit the Running Platform by adding Installation > unzipped Delta Pack folder. The Delta Pack can be found by googling. It is important that it has the version matching your Eclipse. That is, if you have Eclipse 4.3.1, look for Delta Pack 4.3.1

• Fix Bundle-Version in manifest files of zamiacad and plugin projects

• Fix version in plugin.xml and zamiacad.product and

In Eclipse editor, zamiacad.product must have

• Overview tab:

  • ID: org.zamia.plugin.product
  • Version: <as appropriate="">
  • Name: zamiaCAD

  • The product includes native launcher artifacts: Yes

  • Product: org.zamia.plugin.product

  • Application: org.eclipse.ui.ide.workbench
  • The product configuration is based on: plug-ins

• Dependencies tab:

  • Remove all
  • Add...:
    • zamia plugins (2x) => type *zamia
    • emf.common => type *emf.com
    • equinox.launcher => type equlau
    • ide.application => type *ide.ap
  • Include optional dependencies when computing required plug-ins: Yes
  • Add Required Plug-ins

• Overview tab:

  • Exporting => Eclipse Product export wizard
    • Export for multiple platforms: Yes
  • etc.

2. Create Feature Project

There must be a project, created through Eclipse > New Project > Plug-in Development > Feature Project.

Open feature.xml:

• Overview tab:

  • ID: zamiaCAD
  • Version: <as appropriate="">
  • Name: zamiaCAD

• Plug-ins tab:

  • Remove old zamia plug-ins
  • Add 2 new zamia plug-ins
  • Set correct version of plug-ins and download/installation sizes in kB
  • Save file

3. Create Update Site

There must be a project, created through Eclipse > New Project > Plug-in Development > Update Site Project.

Steps to set up the Update Site:

• Delete all files but site.xml from the project dir

• Inside site.xml:

  • Find 'zamiaCAD (x.y.z)' feature under CAD category and remove this feature (while leaving the category where it is)
  • Select CAD category and press 'Add feature...' => find zamiaCAD feature
  • Save file
  • Build All (Site Map tab). This produces export files right in the update site project.

4. Upload

Generated files are uploaded using FRS, https://sourceforge.net/apps/trac/sourceforge/wiki/Release%20files%20for%20download.

• The product has created the versions of eclipse with built-in zamiacad plugin, for every platform. We zip and upload all 6 exported folders. Here is a bash command, exercised in cygwin from the export folder, which does everything

  for D in $(find -name '*x86*' -mindepth 1 -maxdepth 1 -type d | sed 's/^.\///') ; do 
    f=zamiaCAD-<version>-`echo $D | sed 's/.win32.x86//'`.zip
    zip -r $f $D
    scp $f valtih1978,zamiacad@frs.sourceforge.net:/home/frs/project/zamiacad/${D%_*}/$f
  done
  

Just plug your zamiacad_version/username instead of example 0.11.3/valtih1978 placeholders. New files should appear at http://sourceforge.net/projects/zamiacad/files

• Update site is uploaded at frs.sourceforge.net:/home/project-web/zamiacad/htdocs/update-site. You may use sftp,

  sftp valtih1978,zamiacad@frs.sourceforge.net
  

• Make sure everything works fine now:

  • Download eclipse product with plug-in installed from http://sourceforge.net/projects/zamiacad/files/
  • Download a fresh copy of Eclipse (e.g. Classic version) and 'install new software' from http://zamiacad.sourceforge.net/update-site/
  • Play with zamiaCAD in both cases

• Announce a news in http://sourceforge.net/projects/zamiacad/files/README_changelog and http://zamiacad.sourceforge.net/web.