salta alla navigazione

Visual Studio: documentare il proprio codice sorgente 26 Maggio 2010

Inviato da LukePet in : Chicche, Documenti, Guide, Informatica, Prodotti, Software, Sviluppo, Tecnologia, Tutorial, Windows , 1 commento finora

Ecco un altro post che attraversa il versante più “tecnico” dei contenuti di questo blog. Dopo averne già parlato poco tempo fa, torno ad affrontare l’argomento Visual Studio…e per la precisione: “Visual Studio & documentazione del codice”.

Qualche settimana fa mi sono deciso a produrre un po’ di documentazione tecnica in riferimento ad un progetto che sto portando avanti dove lavoro, così mi sono messo a ricercare una soluzione che mi soddisfacesse. Dopo qualche test sono riuscito a trovare una configurazione ideale per tenere allineata la documentazione del mio codice sorgente. Ora, visto che in rete (aldilà di qualche discussione) non ho trovato grossi tutorials a riguardo, riporto in questo post tutte le linee guida che ho seguito. Magari può tornare utile a qualcuno.

Punto 1° – Commentare sempre il codice!

Avere del codice ben commentato è fondamentale, se poi i commenti sono ben strutturati sarà possibile integrarli nella propria documentazione senza problemi. Insomma, abituatevi a fare una cosa come questa:
/// <summary>
/// This is MyFunction
/// </summary>
/// <param name="param1">First parameter</param>
/// <param name="param2">Second parameter</param>
/// <returns>My return value</returns>
public int MyFunction(string param1, double param2)
{
}

per avere un’idea più chiara dei tags che potete sfruttare nella scrittura dei vostri commenti buttate un occhio qua: Recommended Tags for Documentation Comments.

Punto 2° – Impostare le proprietà del progetto

Per ogni class library della vostra solution dovete abilitare la generazione del file XML di documentazione; per farlo andate nella finestra delle proprietà e spuntate la voce “XML documentation file”, come mostrato qui sotto: Continua a leggere…

Visual Studio: suggerimenti per l’uso 28 Aprile 2010

Inviato da LukePet in : Chicche, Documenti, Guide, Informatica, Prodotti, Software, Sviluppo, Tecnologia, Windows , aggiungi un commento

Ci sono due motivi per cui scrivo questo post; il primo motivo è per dare qualche utile consiglio a chi utilizza da poco l’IDE di casa Microsoft, l’altro motivo è per un mio personale esercizio mnemonico…questo post rientrerà diretto nel blocchetto degli appunti telematici.

Sono oramai più di due anni che ho iniziato a sviluppare in ambiente Microsoft e Visual Studio è stato il compagno di viaggio di ogni quotidiana istruzione di codice. Come ogni IDE che si rispetti, Visual Studio offre un’infinità di funzionalità/settaggi che possono semplificarci la vita…alcune di queste precauzioni mi stanno particolarmente a cuore ed ho deciso di appuntarle per bene su questo blog.

Le cose che scrivo si trovano già sparse nel web a quantità industriali, io mi limiterò a sintetizzare e segnalare qualche piccola “chicca” in grado di rendere più piacevole e “comoda” l’attività di scrittura del codice.

Punto primo: le opzioni.

Vi consiglio di spendere qualche minuto per spulciare le opzioni di configurazione che Visual Studio mette a disposizione, andando su Tools -> Options troverete una valanga di impostazioni da poter configurare. In particolar modo, nella sezione “Text Editor” potete scegliere la formattazione che più vi aggrada per ogni specifico linguaggio.

Personalmente, quando scrivo in C# o VB, non posso fare a meno di abilitare il display delle “Line numbers”; mentre ho da poco trovato delle comode configurazioni anche per la scrittura dei file XAML, le impostazioni che ho scelto sono le seguenti:

Punto secondo: le estensioni.

Ne esistono parecchie ma per il momento segnalo solo i PowerCommands (http://code.msdn.microsoft.com/PowerCommands). Installando questa estensione verranno aggiunte delle piccole ma utilissime nuove funzionalità al menu principale.

In particolar modo segnalo questi due nuovi comandi:

  • “Remove and Sort Usings”
    (gustosa funzionalità per chi sviluppa in C#; scansiona tutti i file della Solution e, oltre ad ordinarli, rimuove tutti i riferimenti “using” superflui)
  • “Collapse Project”
    (questa è per persone pignole come me; che ci volete fare, io non riesco proprio a chiudere Visual Studio se prima non ho fatto il collapse di tutti i progetti nella soluzione)

Punto terzo (ultimo ed il più importante): le shortcuts!

Ed è qui che arriva l’esercizio mnemonico; faccio un breve elenco di tutte le shortcuts più importanti che ho visto in azione e che piano piano ho imparato ad usare assiduamente. Eccole qua: Continua a leggere…

LG BD390…il mio piccolo centro multimediale 10 Febbraio 2010

Inviato da LukePet in : Acquistoni, Multimedia, Tecnologia , 4 commenti

Arriva il secondo post di approfondimento del capitolo “home cinema”; a questo giro esprimo il mio gran compiacimento per il lettore blu-ray che mi sono regalato…l’LG BD390.

Non è che abbia particolari cose da dire, più che altro posso dare delle conferme.
lg-video-BD390-3-4view-large
Avevo sentito parlare molto bene di questo lettore sia nei forum, sia in diverse recensioni che avevo letto:

e dopo diverse settimane di prove possono affermare che l’LG ha soddisfatto in pieno tutte le mie aspettative.

Prima di tutto, come di consueto, segnalo il link alla discussione dedicata su AVMagazine: http://www.avmagazine.it/forum/showthread.php?t=137074.

Ed ora vi posto qualche breve impressione…

Appena ho avuto il lettore tra le mani ho subito aggiornato il firmware all’ultima versione disponibile (lo so, sono malato, se non aggiorno immediatamente tutto non sono contento)…e già il fatto di aggiornare il software via wi-fi, senza dover ricorrere all’utilizzo di pennette e cd, è stata una gran cosa.

Poi mi sono sbizzarrito ad iniettare contenuti multimediali da ogni sorgente: dischi blu-ray, hard disk esterno, DNLA, streaming wi-fi…video, immagini, musica…insomma di tutto; l’impressione è stata molto positiva.

I video stessi di YouTube visti dalla tv hanno un altro sapore, anche se  è un po’ noioso il fatto di dover digitare i termini di ricerca lettera-lettera…fortunatamente c’è un’ottima funzione di completamento automatico che viene in soccorso; resto comunque dell’idea che, se per digitare le parole, si fosse adottata la logica T9 applicata al tastierino numerico del telecomando, la cosa sarebbe stata più pratica (molto cellulare-style).

Nulla da obbiettare sulla riproduzione video…ho provato diversi formati e senza alcun problema; solo su alcuni DivX ho notato un riproduzione un po’ “a scatti”, ma il tutto era viziato dalla qualità stessa del filmato (si tratta comunque di una cosa migliorabile).

Tutto quello che avevo letto su questo lettore ha quindi avuto conferma sotto i miei occhi…se devo proprio trovare un neo posso dire, che se il telecomando fosse stato retroilluminato come quello delle tv Samsung, sarebbe stato meglio…ma non si può avere tutto dalla vita.

Per il resto, mi do’ una pacca sulla spalla per l’acquisto fatto ;)

“Regolo” e mi stupisco di me stesso…piccola grande chicca targata DDAY 9 Febbraio 2010

Inviato da LukePet in : Chicche, Multimedia, Tecnologia , 1 commento finora

DDay (www.dday.it) ha messo a disposizione di noi “smanettoni” uno strumento veramente utile. Trattasi di “Regolo“, un tool che vi guida nella regolazione della vostra TV.

Vi riporto un estratto del comunicato di presentazione di “Regolo”, preso direttamente dal sito:

“Le frequenti e abbondanti richieste di consigli per la calibrazione della TV ci hanno portato a realizzare un piccolo disco, Regolo, al cui interno si trova tutto ciò che serve per calibrare la propria televisione o il proprio proiettore. Regolo è stato realizzato per chi non possiede né un colorimetro né un software di calibrazione, ma vuole ugualmente trarre il meglio dalla propria TV. Regolo è disponibile in diverse versioni, sia in alta che in bassa definizione.”

Per ulteriori dettagli e per scaricare l’immagine ISO del disco, vi basta visitate il seguente link:
http://www.dday.it/…/Ecco-Regolo-il-disco-per-calibrare-il-tuo-TV

Inutile dire che, visti i miei recenti impallinamenti pro-homecinema, l’ho subito testato sul mio piccolo impianto.

I settaggi che avevo postato nell’articolo samsung-ue40b6000-settaggi-a-gogo si sono rivelati decisamente all’altezza (e son soddisfazioni)…gli unici accorgimenti che ho dovuto prendere hanno riguardato un lieve aumento del contrasto (che ho ritoccato agendo sui settaggi del player blu-ray) ed una leggera diminuzione della nitidezza. Per il resto le impostazioni che avevo delineato hanno a grandi linee superato tutti i test che “regolo” presenta.

Naturalmente DDay ha pubblicato anche una guida di riferimento per l’analisi dei test, la trovate qui:
http://www.dday.it/redazione/904/Guida-come-calibrare-al-meglio-il-proprio-televisore.html.

E’ il momento di smanettare…buone regolazioni a tutti.

Samsung UE40B6000…settaggi a gogò 11 Gennaio 2010

Inviato da LukePet in : Acquistoni, Documenti, Software, Tecnologia , 430 commenti

Ecco il primo dei post di approfondimento legati ad i miei ultimi tecno-acquisti (il-mio-primo-piccolo-vero-home-cinema); parliamo del TV LCD con retroilluminazione a led che mi sono regalato per Natale, il Samsung UE40B6000.

Come ho già avuto modo di dire, prima di procedere all’acquisto mi sono fatto una piccola cultura spulciando e leggendo intere pagine di discussioni sui forum dedicati all’audio ed al video. E dopo attente valutazioni, legate anche alle mie esigenze, la scelta è ricaduta sulla tv di casa Samsung.

Ora quindi per chi, come me, è in possesso di questo televisore condivido qualche utile risorsa.

Punto primo. Reperire informazioni.

Per qualsiasi dubbio, richieste o domande riguardo alla serie 6 dei Samsung a led vi invito ad appuntarvi il link alla discussione ufficiale del forum di AVMagazine:
http://www.avmagazine.it/forum/showthread.php?t=146138.

Punto secondo. Aggiornamento software.

Come molti sapranno è possibile aggiornare il software della tv scaricando il file di update dal sito della Samsung ed eseguendolo via USB. Per scaricare il file di aggiornamento però non andate sul sito italiano ma recuperatelo dal “download center” del sito internazionale. Da lì trovate gli aggiornamenti per tutti i modelli di casa Samsung.

Se prendiamo, ad esempio, la serie 6 di Samsung a led, è possibile vedere come esistano due modelli di riferimento il B6000VW ed il B6000VP…il mio, per esempio, è un UE40B6000VP.

Vi basta andare su sito http://www.samsung.com/it/support/download/supportDownloadMain.do, selezionare il vostro modello e scaricare il file e le istruzioni di aggiornamento. Attualmente (in data 11/01/2010) l’ultima versione disponibile per la serie “VP” è la “2007”…ma penso sia probabile che usciranno versioni successive.

Testato e tutto regolare…anche se non mi sembra sia cambiato niente.

Punto terzo. Settaggi.

Leggendo i vari forum è possibile visionare i diversi settaggi condivisi dagli utenti. Io ne ho preso nota ed ho fatto le mie prove…sono partito da quelli proposti, ma poi ho un pò ritoccato il tutto in funzione del mio gusto personale ed ho raggiunto un profilo che sembra soddisfarmi appieno.

Mi sono concentrato principalmente sul segnale che arriva via HDMI (collegato ad un lettore Blu-Ray); quindi, quelle che vi propongo adesso sono le impostazioni che uso quando guardo i film in alta definizione. Eccole:

Settaggi01
Continua a leggere…

Il mio primo, piccolo, vero home cinema 23 Dicembre 2009

Inviato da LukePet in : Acquistoni, Multimedia, Recensioni, Siti, Tecnologia , 7 commenti

Sono diversi giorni (settimane) che latito dal blog e non sono stati di certo giorni in cui ho oziato. Ho dovuto dedicare tutto il tempo e la concentrazione residua ad un nuovo “progetto”  tecno-domestico; come si può facilmente comprendere dal titolo del post, sono riuscito finalmente a realizzare il mio primo home cinema…e vi assicuro che non è stata proprio una passeggiata.

La fissa per l’home cinema me la portavo dietro da diversi anni oramai…ogni tanto tornava, mi tormentava un pò e poi se ne andava. Oscar Wilde ha detto “L’unico modo per liberarsi da una tentazione è cedervi” e a questo giro gli ho dato ascolto. Ho ceduto.

Come di consueto, quando mi trovo a fare un acquisto nella sfera tecnologica, c’è una fase preliminare di preparazione, in cui esploro ogni angolo del web alla ricerca di pareri, recensioni, immagini, video…qualsiasi tipo di informazione. E’ stata quindi l’occasione per farmi una cultura su tutto ciò che gravita intorno alla parola “home cinema”: tv, lettori, home theatre, bluray, alta definizione, digitale, etc. etc.

In tutto ciò, vi segnalo alcuni link che sono stati alquanto preziosi:

Questa fase di “preparazione” alla fin fine è durata alcune settimane e devo dire che mi sono fatto una vera cultura in merito…e poi è scattato il momento delle scelte.

1° Acquisto) Televisione

La scelta è ricaduta sul Samsung UE40B6000 (lcd con retroilluminazione a led). Ho puntato sulla serie 6 per risparmiare qualche euro che ho poi reinvestito nell’acquisto del lettore BluRay. La serie 6 dei Samsung a led, a differenza della 7 e della 8, non integra le funzionalità per la gestione delle informazioni da Internet, per la lettura dei video da USB e non ha i 200Hz…caratteristiche gran parte recuperate con l’acquisto del lettore BluRay. Ciò che mi interessava era esclusivamente la qualità visiva e devo dire che dai 40 pollici del pannello Samsung fuoriescono colori ed immagini eccezionali…ed una nota di merito va anche al design che si lascia decisamente apprezzare.

Per ulteriori approfondimenti cliccate qui:
http://www.samsung.com/it/consumer/tv-audio-video/tv/led-tv/UE40B6000VWXXC

2° Acquisto) Lettore BluRay Continua a leggere…

TomTom XL IQ Routes™ Edition Europe…finalmente ho finito di stampare le cartine 28 Settembre 2009

Inviato da LukePet in : Acquistoni, Recensioni, Tecnologia , 1 commento finora

Avevo in mente da un bel pò di comprarmi un navigatore satellitare ma non mi ero ancora deciso a farlo.

In realtà non sono uno che ha grosse esigenze di spostamento (almeno non con continuità), ma saltuariamente qualche trasferta mi capita di farla…e quando succede cerco di pianificare il percorso ed i tempi di percorrenza nel minimo dettaglio. Tutto ciò, unito al mio scarso senso di orientamento, ha fatto lievitare l’esigenza di dotarmi un “benedetto” sistema GPS (mica per niente, ma ero stanco di stampare sempre i percorsi da ViaMichelin!).

Come solito, lo step preliminare all’acquisto, ha visto una breve fase di documentazione sul tema…lettura di recensioni, pareri sui forum, etc. etc. Alla fine, non essendo un grosso esperto del settore e non avendo grosse esigenze a riguardo, ho deciso di buttarmi sul sicuro ed optare per l’acquisto di un sistema di navigazione targato TomTom.

E così mi sono ritrovato tra le mani un TomTom XL IQ Routes™ Edition Europe.
tomtom-xl-iq-routes.2592223

Un prodotto entry-level dalle funzionalità essenziali ed affidabili. Schermo da 4,3″, mappe europee, supporto semplice ed efficace…non chiedevo altro; non c’è il bluetooth ed il riconoscimento vocale, ma non è che ne sentissi molto l’esigenza. Per il resto tutto sembra funzionare a puntino…già l’ho testato in una trasferta di 150 Km e si è comportato egregiamente.

Non sto qui a dirvi altro…se qualcuno fosse interessato, mi limito a segnalare una serie di link di approfondimento sul prodotto. Eccoli:

Percorso completo…buon acquisto.

Twitter: ecco qualche profilo interessante da seguire 29 Luglio 2009

Inviato da LukePet in : Chicche, Internet, Servizi, Tecnologia, Web , 1 commento finora

Spiegare cos’è Twitter a chi non ne ha idea non è proprio un’impresa facile; io lo vedo come uno strumento che riesce a fondere tutta una serie di filoni consolidandoli dal punto di vista della rapidità e della sinteticità comunicativa. Il concetto di feed, il concetto di sms, il concetto di condivisione…tutto rientra nella filosofia Twitter. Sono dentro a questo “mondo” da circa sei mesi e mi ritrovo con 150 profili (neanche così tanti) che seguo quotidianamente: persone, siti, associazioni…ogni profilo vive di una propria entità.
twitter1
Questo network, su cui inizialmente avevo avuto uno scettico approccio, si sta scoprendo sempre più affascinante; scrivo questo post per mettere in evidenza qualche profilo stuzzicante da seguire…ho dato una rapida spulciata ai miei following e ne ho selezionati alcuni, eccoli:

INFORMATICA:

MUSICA: Continua a leggere…

Startup 2.0…ha vinto Colnect 28 Aprile 2009

Inviato da LukePet in : Chicche, Informatica, Internet, Prodotti, Servizi, Siti, Software, Sviluppo, Tecnologia, Web , aggiungi un commento

Come avevo scritto in un post di qualche giorno fa (chicche-startup-20-i-finalisti), Venerdì scorso si è svolta a Bilbao la finale dello Startup 2.0 2009.

La classifica finale è stata la seguente:

1) Colnect (http://colnect.com)
2) Genoom (http://www.genoom.com)
3) Twidox (http://www.twidox.com)

Il portale per collezionisti “Colnect” si è aggiudicato il primo posto, secondo classificato “Genoom” (rete basata su collegamenti genealogici) ed in terza posizione è salito “Twidox” (portale per la condivisione e la ricerca di documenti).

Avendo un passato da collezionista (sottobicchieri, bustine di zucchero, monete e banconote…collezionavo di tutto) mi fa anche piacere che abbia vinto Colnect, diciamo che è una vittoria che premia gli appassionati.

Il sito a dire il vero non è fatto proprio benissimo, ma leggendo dal blog ufficiale la sintesi della motivazione che ha portato alla premiazione di Colnect (“The jury valued strongly its capacity to generate a community and real traffic.”) si capisce come i criteri di valutazione dei progetti non siano stati esclusivamente orientati alla tecnologia. Il peso maggiore lo hanno avuto le idee.

Spero che, grazie anche ai fondi ricevuti, questi servizi continueranno a migliorare.

Complimenti a tutti.