AMAPstudio

User Tools


Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
Last revision Both sides next revision
documentation:freezelibrary [2018/03/13 11:05]
beudez created
documentation:freezelibrary [2018/03/22 13:19]
beudez
Line 1: Line 1:
 ====== How to freeze a library ====== ====== How to freeze a library ======
  
-It is possible using the **freeze** target of the Ant's //​build.xml//​ file to freeze an existing library located in the //​capsis4/​src//​ directory in order to make a version of this library. A specific name composed of the library'​s name to which the user adds a suffix is used to generate in //​capsis4/​ext//​ directory a //.jar// file encapsulating the new renamed and compiled library. The initial library located in //​capsis4/​src//​ directory can continue to be developed independently of the frozen library.+It is possible using the **freeze** target of the Ant's //​build.xml//​ file to freeze an existing library located in the //​capsis4/​src//​ directory in order to make a version of this library. A specific name composed of the library'​s name and a suffix is used to generate in //​capsis4/​ext//​ directory a //.jar// file encapsulating the new renamed and compiled library. The initial library located in //​capsis4/​src//​ directory can continue to be developed independently of the frozen library.
  
-**Notes:**\\+Notes:\\
 - only works with a library located in //​capsis4/​src//;​\\ - only works with a library located in //​capsis4/​src//;​\\
-- it is not possible to correct ​add functionalities to a frozen library.+- it is not possible to correct ​or add functionalities to a frozen library.
  
-In order to freeze a library, you have to type the following command from the //capsis4/// directory:+In order to freeze a library, you have to type the following command from the //capsis4// directory:
  
 On Linux/​MacOS:​ On Linux/​MacOS:​
-<​code>​sh ant freeze -Dlibrary.name=full.library.name -Dsuffix=suffix</​code>​+<​code>​sh ant freeze -Dlibrary.name=library.package.name -Dsuffix=suffix</​code>​
  
 On Windows: On Windows:
-<​code>​ant freeze -Dlibrary.name=full.library.name -Dsuffix=suffix</​code>​+<​code>​ant freeze -Dlibrary.name=library.package.name -Dsuffix=suffix</​code>​
  
-where //full.library.name//​ is the full name of the library ​(including its package) and //suffix// is the suffix you want to add to the library'​s name.+where //library.package.name// is the name of the library'​s ​package ​(from //​capsis4/​src//​ directory) and //suffix// is the suffix you want to add to the library'​s name.
  
 For example, the following command (on Linux/​MacOS):​ For example, the following command (on Linux/​MacOS):​
Line 21: Line 21:
  
 will create in the //​capsis4/​ext//​ directory the //​capsis-lib-castanea2018.jar//​ file containing:​\\ will create in the //​capsis4/​ext//​ directory the //​capsis-lib-castanea2018.jar//​ file containing:​\\
-- all directories and files (.java, .properties,​ ...) from the //​capsis4/​src/​capsis/​lib/​castanea//​ directory adapted to the new renamed library (source files belong to the //​capsis.lib.castanea2018//​ package);\\+- all directories and files (.java, .properties,​ ...) from the //​capsis4/​src/​capsis/​lib/​castanea//​ directory adapted to the new renamed library (//​capsis.lib.castanea2018//​ package);\\
 - the corresponding compiled //.class// files. - the corresponding compiled //.class// files.
  
 The **freeze** target can be used before using the **redirect** target. Indeed, a module located in //​capsis4/​src//​ which depends on a library can be redirected to a frozen library (created with the **freeze** target) using the **redirect** target of the Ant's //​build.xml//​ file (see [[redirectModuleToLibrary|How to redirect a module to a library]]). The **freeze** target can be used before using the **redirect** target. Indeed, a module located in //​capsis4/​src//​ which depends on a library can be redirected to a frozen library (created with the **freeze** target) using the **redirect** target of the Ant's //​build.xml//​ file (see [[redirectModuleToLibrary|How to redirect a module to a library]]).
documentation/freezelibrary.txt ยท Last modified: 2019/09/04 14:37 by beudez