AMAPstudio

User Tools


Differences

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

Link to this comparison view

Next revision
Previous revision
documentation:freezelibrary [2018/03/13 11:05]
beudez created
documentation:freezelibrary [2019/09/04 14:37]
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):
 <​code>​sh ant freeze -Dlibrary.name=capsis.lib.castanea -Dsuffix=2018</​code>​ <​code>​sh ant freeze -Dlibrary.name=capsis.lib.castanea -Dsuffix=2018</​code>​
  
 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