[Guida] CSharp

[Rafbor]

Salve,
vi propongo un aggiornamento di questa vecchia pagina https://wiki.ubuntu-it.org/Programmazione/CSharp.

La pagina di prova si trova qui: https://wiki.ubuntu-it.org/rafbor/TestCSharp
Ho promosso l'uso della piattaforma .NET con VSCode, lasciando da parte Mono e MonoDevelop che sono ormai superati, almeno su Ubuntu.

Tuttavia, poiché l'italiano non è la mia lingua madre, ho dovuto usare un traduttore per alcune parole e giri di parole, quindi grazie a chiunque correggerà i miei errori.
È la prima volta che partecipo alla documentazione, quindi fatemi sapere se quello che ho fatto vi soddisfa e come devo procedere.

[korda]

Uso e abuso di questa guida: la seguirò da vicino PowerShell e VBScript mi stanno davvero troppo stretti ultimamente.

[xavier77]

Salve,
vi propongo un aggiornamento di questa vecchia pagina https://wiki.ubuntu-it.org/Programmazione/CSharp.

La pagina di prova si trova qui: https://wiki.ubuntu-it.org/rafbor/TestCSharp
Ho promosso l'uso della piattaforma .NET con VSCode, lasciando da parte Mono e MonoDevelop che sono ormai superati, almeno su Ubuntu.

Tuttavia, poiché l'italiano non è la mia lingua madre, ho dovuto usare un traduttore per alcune parole e giri di parole, quindi grazie a chiunque correggerà i miei errori.
È la prima volta che partecipo alla documentazione, quindi fatemi sapere se quello che ho fatto vi soddisfa e come devo procedere.

Grazie Rafbor!
A prima vista vedo che hai fatto tutto benissimo, anche considerando che è la prima volta che ti cimenti in un aggiornamento di una guida.
Non dimenticare la prossima volta la macro per la pagina di prova:

Codice: Seleziona tutto

<<Include(NuoviStrumentiWiki/PaginaDiProva)>>

Inizio a revisionare.

[wilecoyote]

) Salve, grazie @Rafbor per aver indicato l'uso dell'editor VisualStudioCode.

Se sei pratico del suo uso e puoi dare qualche contributo per migliorare la sua wiki, postalo/i qua [Guida] VisualStudioCode.

:: Ciao

[Rafbor]

@xavier77 : grazie !
Probabilmente ci vorranno alcuni giorni prima che la nuova versione venga messa online, per vedere se qualcuno trova qualcosa da cambiare.
Spetta a me fare l'aggiornamento la revisione o se ne occuperà un amministratore ?

@wilecoyote : ci darò uno sguardo

[wilecoyote]

) Salve, l'aggiornamento spetta a chiunque ha qualcosa d'aggiungere/integrare/modificare/correggere, l'importante è che lo comunichi preventivamente qui nella discussione.

La revisione spetta ai membri del GruppoDoc, che sono gli amministratori del wiki.

:: Ciao

[xavier77]

@Rafbor
Allora, ho fatto le modifiche applicando gli standard attuali del wiki (tieni conto che la guida da cui sei partito era molto vecchia!).
Vedi se va bene

Alcune cose al volo:

• Complimenti! come prima guida sei stato molto bravo, nel senso che hai capito subito come vanno impostate le guide (entrando quindi "nello spirito" del wiki). Per approfondire (se hai tempo e voglia): GuidaWiki/Standard
• Ricontrolla la pagina di prova, tenendo conto che non uso .NET e VisualStudioCode, quindi potrei aver "rovinato" qualcosa (ad esempio la frase «Per impostazione predefinita il nome della cartella diventerà il nome del progetto e il nome dello spazio dei nomi» non mi è molto chiara).
• Ho inserito una verifica "fittizia" con Ubuntu 22.04, ma puoi aggiungere tutte le altre versioni di Ubuntu con cui la guida si può considerare valida.
• Ho visto che nella guida suggerisci JetBrains Rider, che è proprietario. Non è un problema, però come politica del wiki si preferisce mettere in evidenza programmi FOSS.

Fai sapere.
Ricordo che chiunque altro può fare eventuali altre segnalazioni e suggerimenti.

[Rafbor]

@xavier77 grazie per le modifiche, mi sta bene.

• Per "il nome dello spazio dei nomi", colpa al traduttore, ho modificato lasciando il termine originale "namespace".
• Ho aggiunto la versione 20.04 che uso.
• Nel paragrafo Esempi, ho corretto il link alla pagina degli esempi mettendo il percorso completo https://wiki.ubuntu-it.org/Programmazio ... rp/Listati (il percorso era relativo nella pagina originale e non funzionava nella pagina di prova)
• Ho modificato la riga "Per installare l'SDK che include il runtime per lo sviluppo, oppure solo il runtime per eseguire l'app" perchè non è chiaro, l'SDK è necessario per sviluppare, ma contiene pure il runtime

Per il momento, per me va bene così. Tra un po' aggiornerò per puntare alla versione di .NET 7 che è stata appena rilasciata ma che non ho ancora testato.

[wilecoyote]

) Salve, ho wikizzato la procedura d'installazione dei pacchetti, messo 3 note nell'intro, impostato come verificare quanto installato, eliminando tutto il dopo, il tutto provato sul campo e dattilografato su 1 pagina di prova ça va sans dire…

Link alla pagina di prova wilecoyote/CSharp.

Ora su quanto ho commesso potete scatenare il cahiers de doléances…

:: Ciao

[xavier77]

@xavier77 grazie per le modifiche, mi sta bene.

• Per "il nome dello spazio dei nomi", colpa al traduttore, ho modificato lasciando il termine originale "namespace".
• Ho aggiunto la versione 20.04 che uso.
• Nel paragrafo Esempi, ho corretto il link alla pagina degli esempi mettendo il percorso completo https://wiki.ubuntu-it.org/Programmazio ... rp/Listati (il percorso era relativo nella pagina originale e non funzionava nella pagina di prova)
• Ho modificato la riga "Per installare l'SDK che include il runtime per lo sviluppo, oppure solo il runtime per eseguire l'app" perchè non è chiaro, l'SDK è necessario per sviluppare, ma contiene pure il runtime

Per il momento, per me va bene così. Tra un po' aggiornerò per puntare alla versione di .NET 7 che è stata appena rilasciata ma che non ho ancora testato.

OK, anche per future integrazioni per la versione 7.
Grazie
@Rafbor
Ho rimesso il link alla pagina dei listati (adesso il link è rotto, ma sarà attivo quando la tua pagina di prova sarà copiata nella guida attuale ).

) Salve, ho wikizzato la procedura d'installazione dei pacchetti, messo 3 note nell'intro, impostato come verificare quanto installato, eliminando tutto il dopo, il tutto provato sul campo e dattilografato su 1 pagina di prova ça va sans dire…

Link alla pagina di prova wilecoyote/CSharp.

Ma perché fare il doppione della guida Microsoft????????????

[Rafbor]

Ma perché fare il doppione della guida Microsoft????????????

Mettetevi d'accordo
E vero che la guida di Microsoft ha il merito di essere sempre aggiornata, almeno ad ogni lancio di una nuova versione di Ubuntu. Se ricopiamo tutto nel wiki, dovremo anche aggiornarlo ogni 6 mesi.

Ho apportato alcune modifiche per una maggiore precisione:

• per l'installazione
  il Runtime serve per eseguire applicazioni (non per eseguire il codice)
  l' SDK è necessario per sviluppare e è comprensivo del Runtime
• Per creare una GUI, l'estensione C# non è un prerequisito, solo il framework UI lo è.

Grazie

Edit: il link alla pagina di Esempi non funziona sulla pagina di test, l'avevo modificato mettendo il percorso completo non relativo, ma è di nuovo come prima. Qualcuno lo ha modificato ?

[wilecoyote]

) Salve,

Ma perché fare il doppione della guida Microsoft????????????

Non è un doppione, questi l'ha fatti in serie Microsoft aggiungendo pure degli errori, ma una semplificazione per utonti.

I repository li chiama feed, usa apt-get invece del consigliato/raccomandato apt, ripete serialmente quasi tutti i comandi, tranne il:

Codice: Seleziona tutto

wget https://packages.microsoft.com/config/ubuntu/$(lsb_release -sr)/packages-microsoft-prod.deb -O packages-microsoft-prod.deb

Che ho modificato sostituendo il numero, variante, di release colla variabile $(lsb_release -sr), così di renderlo universalistico ed a prova d'utonto.

Infine ho aggiunto la possibilità d'installare l'applicazione dai repository ufficiali, non tutti apprezzano l'aggiunta di repository terzi.

Faccio pure altresì notare che questi passaggi non vengono aggiornati ogni 6 mesi, e che prolissa e ripetitiva com'è la pagina linkata si presta a sbadatamente errare qualche comando.

@Rafbor grazie pella correzione dell'eseguire il codice in eseguire le applicazioni.

:: Ciao

P.S. appena notato che il .NET 7 è in arrivo nei repository ufficiali http://ubuntu.mirror.garr.it/ubuntu/poo ... d/dotnet7/ , cominciato il caricamento giusto 24 ore fà.

[xavier77]

OK se la versione 7 è in rilascio prendiamoci tutto il tempo che serve, così ne approfittiamo per completare la pagina di prova.

@wilecoyote
Io non consulto periodicamente questa guida Microsoft. Però seppur non segua (ovviamente) gli standard del nostro wiki, mi sembra scritta in maniera molto comprensibile.
In sintesi:

• il fatto che usino apt-get mi sembra secondario e indifferente per motivi di sicurezza ecc.
• per il discorso di nomenclatura di feed/repository basta precisarlo.
• per il comando con wget e il discorso degli "utonti", pensavo che dopo anni avessi capito che per le guide per argomenti "avanzati" (e questo lo è) ci può essere qualche "deroga" (si suppone che chi si occupi di sviluppo software conosca molti concetti principali, i comandi di base ecc.).
• ....ma soprattutto ci evita di dover aggiornare costantemente la pagina (e se n'è accorto perfino Rafbor che è alla sua prima guida, ma non tu!).

@Rafbor
Grazie per le aggiunte!
Ripeto: il link alla pagina Programmazione/CSharp/Listati è normale che non funzioni.
Quando faremo il copia/incolla del testo da rafbor/TestCSharp a Programmazione/CSharp tornerà a funzionare

[Rafbor]

Ripeto: il link alla pagina Programmazione/CSharp/Listati è normale che non funzioni.
Quando faremo il copia/incolla del testo da rafbor/TestCSharp a Programmazione/CSharp tornerà a funzionare

Scusami, avevo letto troppo in fretta. Bene cosi.

Ho cancellato il parametro framework net6.0 dal commando per creare un applicazione console senza IDE, in modo che non sia più mirato a una versione specifica, quindi il comando funziona con la versione del SDK che è installata:

Codice: Seleziona tutto

dotnet new console --use-program-main

Edit: Nel paragrafo Creazione di un'applicazione con GUI in VisualStudioCode ho aggiunto un riga di comando per controllare che il template sia bene installato:

2. Controllare che il template sia presente con il seguente comando:

Codice: Seleziona tutto

dotnet new --list | grep gtkapp

Se tutto è corretto, l'output deve essere il seguente:

Codice: Seleziona tutto

Gtk Application             gtkapp          [C#]        Gtk/GUI App

[xavier77]

Quando la pagina di prova è pronta fai sapere.

[Rafbor]

Per me va bene cosi. Nel paragrafo Installazione di .NET ci sarà solo la nota da aggiornare quando la guida di Microsoft sarà aggiornata. Potrà avvenire in un secondo tempo.

Però, @wilecoyote ha fatto del lavoro per riscrivere la parte di installazione di .NET, abbiamo bisogno del suo parere.

[xavier77]

Per me va bene cosi. Nel paragrafo Installazione di .NET ci sarà solo la nota da aggiornare quando la guida di Microsoft sarà aggiornata. Potrà avvenire in un secondo tempo.

Però, @wilecoyote ha fatto del lavoro per riscrivere la parte di installazione di .NET, abbiamo bisogno del suo parere.

OK, ma le sue aggiunte sono sostanzialmente un "doppione" della guida Microsoft. Scritte meglio, forse, ma sempre doppione.
Nell'ottica futura, ci costringe a dover aggiornare costantemente la guida.
Se però volete si può inserire qualcosa da quella sua pagina di prova (ad esempio le note?).
Fate sapere.

[Rafbor]

Sarebbe ancora meglio se eliminassimo tutte le note di questo paragrafo, così da non doverle aggiornare.
Spetterà a Microsoft fare gli aggiornamenti.

[wilecoyote]

Salve,

Per me va bene cosi. Nel paragrafo Installazione di .NET ci sarà solo la nota da aggiornare quando la guida di Microsoft sarà aggiornata. Potrà avvenire in un secondo tempo.

Però, @wilecoyote ha fatto del lavoro per riscrivere la parte di installazione di .NET, abbiamo bisogno del suo parere.

OK, ma le sue aggiunte sono sostanzialmente un "doppione" della guida Microsoft. Scritte meglio, forse, ma sempre doppione.
Nell'ottica futura, ci costringe a dover aggiornare costantemente la guida.
Se però volete si può inserire qualcosa da quella sua pagina di prova (ad esempio le note?).
Fate sapere.

Grazie del riconoscimento @Rafbor.

Sul dattilografato meglio la procedura d'installazione dissento, l'ho solo resa coerente colla struttura che abbiamo unificato pell'aggiunta di repositori terzi, come da wiki Repository/GestioneRepositoryTerzeParti.

Sulla necessità dell'aggiornamento l'ho già dattilografata la questione, al più i pacchetti li sposteranno nello stesso repository di Microsoft Edge e VisualStudioCode, semplificandoci il lavoro, ove già sono presenti le directory necessarie.

C'è però un aspetto che non avevo mai considerato, le wiki sono stampabili tramite Altre azioni → Versione stampabile, cosa non sempre fattibile, intendo il risultato grafico, con le pagine esterne come quella di Microsoft.

L'ho scoperto poiché m'hanno chiesto se la wiki Server/Xampp è ancora valida, l'usano come riferimento per esercizio di server in locale al 3° anno di perito informatico ed è comodo averla stampata su un foglio.

:: Ciao

P.S. mi lancio sulla wiki oggetto della richiesta di verifica…

[xavier77]

Intanto ho fatto il copia/incolla dalla pagina di prova, perché la pagina necessitava di essere aggiornata.
Eventuali integrazioni, come sempre, possono essere aggiunte in seguito.

Grazie a wilecoyote e (soprattutto) a Rafbor per l'ottimo lavoro.

@Rafbor poi fai sapere se hai bisogno di rinominare o eliminare la pagina di prova.