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 finoraEcco 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 commentoCi 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…
Firefox: Greasemonkey…altri utili scripts 17 Marzo 2010
Inviato da LukePet in : Chicche, Firefox, Informatica, Internet, Siti, Software, Web , 1 commento finoraGreasemonkey, parte seconda.
Tempo fa avevo scritto un post in cui segnalavo alcuni script che avevo utilizzato con Greasemonkey: firefox-greasemonkey-script-e-tante-belle-sorprese.
Per chi ancora non lo sapesse Greasemonkey è una popolare estensione per Firefox che consente di gestire piccoli ed utili script in grado di personalizzare la visualizzazione delle pagine web visitate ed introdurre qualche utile nuova funzionalità.
Molti di questi script sono reperibili all’indirizzo userscripts.org ed in questo post vorrei segnalarne alcuni che utilizzo ormai assiduamente.
- Facebook Fixer (http://userscripts.org/scripts/show/8861)
Uno script veramente ben fatto che integra una serie di piccole funzionalità aggiuntive tra le pagine di Facebook, tra le tante trovo particolarmente utile la possibilità di visualizzare le immagini solamente fermandocisi sopra con il puntatore del mouse. - Facebook Friends Checker (http://userscripts.org/scripts/show/40027)
Altro script “facebookkiano” che notifica quando uno dei vostri contatti non è più tra i vostri amici…per la serie: voglio sapere tutto! - Flickr AllSizes+ (http://userscripts.org/scripts/show/6178)
Questo invece è per Flickr…un comodo script per visualizzare e scaricare le foto nei diversi formati disponibili. - YouTube HD Ultimate (http://userscripts.org/scripts/show/31864)
E non poteva mancare YouTube…con questo script sarà possibile gestire tutta una serie di piccoli settaggi che miglioreranno il “comfort” nella visualizzazione dei vari video.
Visto che ci sono posto anche le impostazioni che personalmente ho settato per YouTube HD Ultimate, eccole qua: Continua a leggere…
Editing di file Mkv…merge, demux, mux, delay e quant’altro 4 Febbraio 2010
Inviato da LukePet in : Chicche, Informatica, Linux, Multimedia, Prodotti, Software, Soluzioni, Windows , aggiungi un commentoChicca volante.
Se vi capitasse di avere a che fare con qualche file MKV dall’audio leggermente sfasato ed aveste bisogno di un tool in grado di fare, in modo rapido e semplice, il demux/mux della traccia video e di quella audio (con le opportune modifiche al delay settate), allora il mio caldo consiglio è di utilizzare MKVToolnix.
E’ ciò di cui avevo bisogno stasera e questo bel programmino è stata la mia salvezza. Il software è quasi banale da usare, caricate il file, settate tutte le vostre cosine e poi lo salvate in un nuovo file. Fatto.
Questo è il link per scaricarlo: http://www.bunkus.org/videotools/mkvtoolnix/index.html.
Dato che ci sono, posto pure un’altra piccola nozione utile da conoscere quando si ha a che fare con i ritardi dell’audio e/o dei sottotitoli. Se utilizzate VLC (www.videolan.org/vlc) come player potete agire in tempo reale sui delay del file che state riproducendo, vi basta conoscere le giuste short-key:
- premendo h aumenterete il ritardo dei sottotitoli
- premendo g ridurrete il ritardo dei sottotitoli
- premendo k aumenterete il ritardo della traccia audio
- premendo j ridurrete il ritardo della traccia audio
Chiaramente tutto ciò non vale solo per i file mkv, ma per ogni tipo di file video che state riproducendo…e questo potrebbe evitarvi di dover rielaborare il file sfasato.
Penso di aver detto tutto…buona notte.
Samsung UE40B6000…settaggi a gogò 11 Gennaio 2010
Inviato da LukePet in : Acquistoni, Documenti, Software, Tecnologia , 430 commentiEcco 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:
Firefox: FF & Facebook Chat…pace fatta 8 Gennaio 2010
Inviato da LukePet in : Chicche, Firefox, Informatica, Internet, Siti, Software, Soluzioni, Web , 2 commentiChicca volante.
Fino a qualche giorno fa ho convissuto con un innocuo, ma fastidiosissimo, problema con la chat di Facebook.
Ogni volta che ricevevo un messaggio con la pagina di Facebook aperta in Firefox mi imbattevo in una incomprensibile notifica che richiedeva l’installazione del plugin Apple QuickTime. Una stranezza su cui ho sorvolato per parecchio tempo ma che sotto sotto mi dava sempre più fastidio.
All’inizio ho erroneamente dato la colpa a Digsby (passo-a-digsby), che alla fine non c’entrava niente…poi, all’ennesima notifica di installazione del plugin “misterioso”, ho deciso di affrontare la questione di petto ed ho dedicato 5 minuti del mio prezioso (si fa per dire) tempo alla ricerca di una soluzione.
E’ venuto fuori che non sono stato il solo ad aver avuto questa noia e, tra le varie discussioni spulciate, la soluzione (in realtà più “workaround” che una soluzione) emersa si è dimostrata di una semplicità impensabile. Ebbene, per non aver più a che fare con quella seccante notifica visualizzata ad ogni messaggio che arriva dalla chat di Facebook non bisogna far altro che disabilitare l’opzione “Attiva suono per i nuovi messaggi”. Non chiedetemi perchè, ma è così.
Ora lo sapete, quindi se capitasse anche a voi…sapete come agire!
Filtrare file e directory nei trasferimenti con FileZilla 4 Novembre 2009
Inviato da LukePet in : Chicche, Guide, Informatica, Internet, Linux, Software, Soluzioni, Windows , 6 commentiAltra chicca volante…
E’ una cosa che ho scoperto e sperimentato pochi giorni fa, una sciocchezza di quelle che si ignorano con insana sufficienza e poi quando si svelano ti mettono un pizzico di beata soddisfazione.
In pratica ho scoperto che durante i trasferimenti via FTP con FileZilla c’è la possibilità di impostare dei filtri per evitare che vengano presi in considerazione file e cartelle non necessarie…e questa feature (ndr. disponibile dalla versione 3 del client) mi è stata parecchio utile. Dovevo tirare giù un sito evitando che venissero considerati tutti i files residenti nella directory di cache, mi è venuto così il sospetto che ci fosse un qualche modo per gestire questa esigenza…e non mi sbagliavo.
E’ bastato esplorare con un pò più di attenzione la toolbar di FileZilla per scoprire che esiste un settaggio apposito per filtrare i trasferimenti.
Ora, senza che mi stia a dilungare in superflue spiegazioni, vi posto un contributo visivo che più essenziale non si può:
(cliccate sull’immagine per vederla ingrandita)
Più chiaro di così non potevo essere…passo e chiudo.
Mockuppare…Balsamiq vs. MockFlow 27 Ottobre 2009
Inviato da LukePet in : Chicche, Informatica, Internet, Servizi, Software, Sviluppo , aggiungi un commentoIl bello della condivisione delle conoscenze è che puoi dare tanto agli altri e prendere altrettanto tanto da loro. Succede così che grazie alla segnalazione di un collega di lavoro e ad un messaggio di un amico che segui su Twitter vieni a conoscenza di alcuni strumenti che si lasciano subito apprezzare per la loro immensa utilità.
Questa riflessione nasce proprio da quel flusso di parole, interazioni e condivisione che mi ha portato a sperimentare l’utilizzo dei mockup software.
Si tratta di programmi che aiutano la fase di progettazione delle interfacce grafiche, permettendo di disegnare in maniera rapida i modelli dimostrativi di un’applicazione; le schermate applicative vengono create attraverso uno specifico editor che integra una libreria di oggetti preimpostati e configurabili, attraverso i quali comporre il modello della user interface…e tutto ciò aiuta non poco le varie fasi di analisi e progettazione che portano alla realizzazione di una soluzione software.
Di tool di questo genere ne esistono diversi, io ho avuto modo di provarne due ed ora vi posto le mie impressioni; le due soluzioni su cui ho messo le mani sono Balsamiq Mockups (www.balsamiq.com) e MockFlow (www.mockflow.com).
Per avere un metro di giudizio preciso e riuscire a paragonare bene i due software, ho fatto un piccolo esperimento. In pratica, ho disegnato la stessa interfaccia prima con Balsamiq e poi con MockFlow, mettendole a confronto per valutarne la resa complessiva. Qui sotto trovate ciò che ne è venuto fuori:
Il test con Balsamiq è stato condotto utilizzando la versione desktop dell’applicativo (concessa con licenza di prova), mentre con MockFlow ho utilizzato la versione free online.
Impressioni? Continua a leggere…
Memorizzare la posizione delle icone sul Desktop 6 Ottobre 2009
Inviato da LukePet in : Chicche, Informatica, Prodotti, Software, Soluzioni, Windows , 1 commento finoraChicca volante.
Probabilmente questa utility la trovate recensita in molti altri blog ma, visto che in questi giorni si è dimostrata un vero toccasana per combattere le mie “noie da pc”, la metto in evidenza anche qui.
In pratica per alcuni motivi (che non sto qui a spiegarvi) ultimamente mi capita di utilizzare la mia postazione di lavoro in desktop remoto da altre macchine…i vari cambi di risoluzione a cui sottopongo di volta in volta il desktop finisco sempre per incasinarmi tutte le icone che minuziosamente e con molto amore avevo disposto.
Una volta…ok. Seconda volta…e vabbè, lasciamo passare. Terza volta…adesso basta!
Stanco di questo fastidioso inconveniente mi sono messo rapidamente alla ricerca di una utility che mi venisse in soccorso…ed ho trovato un fedele alleato in DesktopOK.
Niente di più banale…si tratta di un semplicissimo e leggero programmino che consente agevolmente di salvare le posizioni delle icone, per poi ripristinarle quando ce ne sarà bisogno.
Efficiente ed efficace, se mai vi servisse lo trovate a questo indirizzo: http://www.softwareok.com/?seite=Software/DesktopOK.
