Changes between Version 13 and Version 14 of TolPackageRulesAndComments

Timestamp:

Jun 22, 2010, 3:43:48 PM (15 years ago)

Author:

Víctor de Buen Remiro

Comment:

--

TolPackageRulesAndComments

@@ -67 +67 @@
    con #Embed los archivos auxiliares que necesite con nombre libre pero ubicación 
    paralela o en subdirectorios del raíz.
- * Los miembros obligatorios del NameBlock de un paquete son:
-  * Text _.autodoc.brief = "Descripción cortísima en una línea".
-  * Text _.autodoc.description = "Descripción detallada";
-  * Text _.autodoc.url = "http://.../";
-  * Set _.autodoc.keys = [["Palabras","Clave", ...]];
-  * Set _.autodoc.authors = [[ "fulanito@mail.tal", "menganito@mail.cual"]];
-  * Text _.autodoc.minTolVersion = {{{TolPackage::_.currentTolVersion}}};
-  * Real _.autodoc.version.high = 1;
-  * Real _.autodoc.version.low = 1;
-  * Set _.autodoc.dependencies = [["paquete1","paquete2", ...]];
-
+ * Los miembros obligatorios del NameBlock de un paquete son: [[BR]]
+   {{{
+  Text _.autodoc.brief = "Descripción cortísima en una línea".
+  Text _.autodoc.description = "Descripción detallada"; }}}
+  Text _.autodoc.url = "http://.../"; }}}
+  Set  _.autodoc.keys = [["Palabras","Clave", ...]]; }}}
+  Set  _.autodoc.authors = [[ "fulanito@mail.tal", "menganito@mail.cual"]]; }}}
+  Text _.autodoc.minTolVersion = {{{TolPackage::_.currentTolVersion}}}; 
+  Real _.autodoc.version.high = 1;
+  Real _.autodoc.version.low = 1;
+  Set  _.autodoc.dependencies = [["paquete1","paquete2", ...]];
+   }}}
+ * Cuando un paquete requiera para su ejecución de recursos ajenos a TOL será 
+   necesario añadir un nuevo miembro que será un conjunto de conjuntos de 
+   caminos a los directorios raíces de cada uno de los recursos. Los que sean 
+   independientes de la plataforma se pueden poner en un elemento 
+   {{{crossPlattform}}} y los que sí dependan en uno con el nombre de la 
+   plataforma. [[BR]]
+   {{{
+  Set _.autodoc.nonTolResources = { [[
+    Set crossPlattform = { [[ 
+       Text resource_1="./....", 
+       Text resource_2="./....", 
+       ... ]] },
+    Set win32_x86 =  { [[ 
+       Text resource_1="./....", 
+       Text resource_2="./....", 
+       ... ]] },
+    ...
+  ]] };
+   }}}
 === Nomenclatura y versionado ===
 
@@ -145 +165 @@
    tener un método [[BR]] {{{ Real StartActions(Real void) { ... }; }}} [[BR]] el 
    cual será llamado justo después de ser cargado por el #Require por vez primera.
+   En el caso de que el paquete contenga recursos ajenos a TOL, el método StartActions 
+   será quien se ocupe de terminar de inicializar lo que corresponda a esos recursos. 
+   Para ello sólo necesita saber el path local que se obtiene llamando a [[BR]]
+   {{{
+Text TolPackage::Client::LocalResourcePath(Text package.version, Text platForm, Text resource)
+   }}}
 
 === Dependencias ===
@@ -210 +236 @@
       contiene un subdirectorio por cada paquete con los códigos fuente 
       originales, la documentación, los tests y todo aquello que se usó en la 
-      construcción.
+      construcción. Funciona al mismo tiempo como un backup y como una forma de
+      enlazar URL's a lo que haga falta del paquete.
+    * [http://packages.tol-project.org/OfficialTolArchiveNetwork/resources resources]:
+      El servidor de creación de los paquetes se encargará de leer los recursos 
+      ajenos a TOL de {{{_.autodoc.nonTolResources}}}, comprimir los directorios 
+      enumerados y enviarlos al repositorio remoto dentro de este subdirectorio. 
+      También quedarán anotados en el archivo de índice en el campo de 
+      dependencias externas. El instalador del cliente se los bajará al mismo 
+      tiempo que el .oza los recursos comprimidos que correspondan a su plataforma, 
+      incluyendo los que son independientes de la plataforma, creando para ello 
+      un directorio propio del paquete y la plataforma [[BR]]
+      {{{
+  TolPackage::Client::_.localRoot+package.version+"/"+<plattform>+"/"
+      }}}
+      Luego descomprimirá ahí dentro cada uno de los recursos descargados de forma
+      que sean accesibles localmente.
+
  * Debería haber un comité o alguien responsable de probar todos los paquetes de
    un repositorio antes de publicar las actualizaciones de los paquetes para