Return to documentation index

Title: Versioni di Janox e upgrade dei progetti

Contenuto:

- Versioni di Janox

- Conversione dei progetti

- Conversione delle tabelle di sistema

- Conversione di progetti: how to

Versioni di Janox

Il codice della versione di Janox è una stringa composta da tre numeri interi separati da un punto, nella forma "<g>.<v>.<r>", dove:

<g> Generazione: è un codice di macro-versione e viene cambiato in base a pure esigenze organizzative

<v> Versione: è il codice di compatibilità tra versioni e viene variato ogni volta che un nuovo rilascio di Janox richieda una conversione dei progetti esistenti

<r> Release: è un codice di built-in e serve a distinguere i vari rilasci di Janox che non necessitano di conversioni

Ogni volta che viene creato un uovo progetto, questo viene segnato con Generazione e Versione ("<g>.<v>"): questa informazione verrà usata per i successivi controlli di compatibilità.

Quando si prova ad eseguire un progetto Janox o ad aprirlo con l'Interfaccia di Sviluppo, la versione del progetto viene confrontata con la versione di Janox in questo modo:

Versione Janox < Versione progetto

Il progetto non può essere eseguito dalla runtime né aperto dall'Interfaccia di Sviluppo: viene emesso un errore per invitare l'utente a procurarsi una versione più recente di Janox. L'esecuzione viene terminata.

Versione Janox > Versione progetto

Il progetto è stato sviluppato per una versione più vecchia di Janox e necessita di essere convertito alla versione attuale. Viene emesso un errore per invitare l'utente a convertire il prgetto. L'esecuzione viene terminata. Dopo la conversione la runtime sarà in grado di eseguire il progetto e l'Interfaccia di Sviluppo potrà aprirlo.

Versione Janox = Versione progetto

Il proegetto viene correttamente eseguito dalla runtime di Janox e aperto dall'Interfaccia di Sviluppo.

Conversione dei progetti

Ogni volta che aggiornate la vostra versione di Janox (non per le singole release) dovrete convertire i vostri progetti esistenti alle nuove sintassi e strutture.

La conversione avviene in maniera totalmente automatica e può essere eseguita tramite l'Interfaccia di Sviluppo di Janox. Tutto quello che dovrete fare sarà semplicemente aprire il progetto in sviluppo: se sarà necessario vi verrà proposta la conversione.

NOTA: La conversione può aggiornare progetti da qualunque versione precedente ad una successiva ma le conversioni possono solo far avanzare (e non retrocedere) il codice di versione del progetto.

I progetti convertiti vengono automaticamente copiati in una cartella di backup, nel cui nome compare il vecchio codice di release. L'operazione dovrà essere ripetuta per ogni progetto da convertire.

Conversione delle tabelle di sistema

Janox utilizza alcune tabelle di database per uso interno: alcune di esse vengono inserite nel database SQLite della runtime stessa (janox/jxrnt/data/o2sys.sqlite), altre vengono create nei database dei progetti, secondo le indicazioni dei repository di progetto.

Le tabelle di Janox, col tempo, possono cambiare struttura, quindi nei database di sistema, al momento della creazione, viene indicata la versione. La conversione dei database di sistema non può essere eseguita contestualmente alla conversione del progetto perché uno stesso progetto, in tempi diversi, può accedere database diversi.

Per questo ad ogni accesso (login) la versione del database di sistema viene confrontata con la versione di Janox in questo modo:

Versione Janox < Versione progetto

La runtime di Janox non può usare il corrente database perché è già stato convertito ad una versione più recente. Viene emesso un errore per invitare l'utente a procurarsi una versione più recente di Janox o a cambiare database. L'esecuzione viene terminata.

Versione Janox > Versione progetto

Viene emesso un errore per invitare l'utente a convertire il database. L'esecuzione viene terminata. Dopo la conversione la runtime di Janox sarà in grado di eseguire il progetto con il corrente database.

Versione Janox = Versione progetto

Il proegetto viene correttamente eseguito dalla runtime di Janox.

Se è necessaria una conversione per il database di sistema e state accedendo al progetto con credenziali valide di DEVELOPER, allora potrete eseguire la conversione semplicemente premendo il pulsante "convert" che verrà mostrato con l'errore.

NOTA: La conversione può aggiornare i database di progetti da qualunque versione precedente ad una successiva ma le conversioni possono solo far avanzare (e non retrocedere) il codice di versione.

Conversione di progetti: how to

Quando installate una nuova versione di Janox, per convertire i progetti esistenti, potrete seguire questa semplice procedura:

1. Aprite il progetto esistente con l'Interfaccia di Sviluppo di Janox. Se una conversione è necessaria vi sarà richiesto di confermare l'upgrade del progetto. Confermate e procedete con la conversione.

2. Eseguite ad accedete al progetto con credenziali valide di DEVELOPER: se sarà necessaria una conversione dei database di sistema vi sarà richiesto di confermare la conversione. Eseguite una copia dei dati del progetto, confermate e procedete con la conversione, quindi verificate che tutto venga eseguito correttamente.

Ripetete questa procedura per ogni progetto da convertire.

Return to documentation index