Come spiegare a un non programmatore di creare il codice sorgente di Visual Studio in modalità "Rilascio"?

Question

Come spiegare a un non programmatore di creare il codice sorgente di Visual Studio in modalità "Rilascio"?

#1 da (19 voti)
#2 da (5 voti)
#3 da (2 voti)

2

Sto scrivendo documentazione per alcuni software che ho scritto. Nello specifico, sto scrivendo una guida per l'installazione del software. Sto consegnando il codice sorgente al mio cliente, quindi mi aspetto che vorranno essere in grado di compilare dal sorgente.

Spiego di aprire la soluzione in Visual Studio 2010 e di fare clic con il tasto destro del mouse sul progetto e selezionare "Pubblica".

Non sembra essere un modo chiaro e diretto per spiegare che devono costruirlo in modalità "Rilascio" o quale sia il modo più semplice per spiegare come farlo.

Qual è il modo migliore per spiegarlo?

Modifica: In risposta ai commenti che mi chiedono di essere più specifici, nella mia configurazione di Visual Studio 2010, c'è un elenco a discesa accanto all'icona verde che avvia il debugger. Accanto non ha etichette. È così che sono abituato a cambiare l'impostazione da solo, ma non voglio scrivere nella mia documentazione, "Fai clic sull'elenco a discesa accanto al pulsante verde e seleziona" Rilascia ". Deve esserci un modo migliore Sono particolarmente preoccupato del fatto che, se sbaglio, ciò potrebbe comportare la modifica delle impostazioni a livello di progetto anziché il livello della soluzione.

documentation

posta Rice Flour Cookies 11.10.2013 - 22:44

fonte

3 risposte

Leggi altre domande sui tag documentation

Devo usare applet Java o JavaScript / PHP per rendere il mio sito più interattivo? [chiuso] Ridurre l'effetto ripple nel mio codice

score 19 · Answer 1

Vorrei solo aggiungere uno script da riga di comando (* .bat) al pacchetto, chiamando VS con comandi come

set VSPATH=C:\Program Files (x86)\Microsoft Visual Studio 10.0
set DEVENV="%VSPATH%\Common7\IDE\devenv.exe"
%DEVENV% YourProgramsSolutionFile.sln /build "Release" /out Build.log

Questo script può essere eseguito con un semplice doppio clic, che non dovrebbe essere troppo difficile da spiegare a nessun altro, programmatore o meno.

In realtà, trovo molto complicato forzare un non programmatore ad installare Visual Studio sulla sua macchina solo per fargli compilare il tuo programma. Quindi, quando vuoi consegnare un pacchetto a qualcun altro, perché non fornisci una routine di installazione per un binario già compilato in aggiunta al codice sorgente?

Ecco un articolo correlato che potresti trovare interessante: link

score 5 · Answer 2

Aggiungerei una nota "build in Release mode" al documento e supponiamo che il lettore (sia il client o uno sviluppatore assunto dal contraente) sia abbastanza competente da trovare il pulsante giusto da premere.

C'è un livello di abilità minimo richiesto per fare anche modifiche al codice banali e lo includerei come uno di questi. In altre parole, se il tuo lettore ha bisogno di istruzioni su come creare in modalità Release, quali sono le probabilità che siano qualificati per non violare il codice attraverso l'ignoranza?

È perfettamente logico che il cliente richieda il codice sorgente - lo ha pagato. Se non hanno le capacità per apportare modifiche da soli, possono assumerlo a qualcun altro.

FWIW, mi considero in questa categoria. In alcuni ambienti posso sicuramente creare codice. In altri, so meglio che fare qualcosa di più che guardare oltre la spalla di qualcuno.

score 2 · Answer 3

Dato che questo è per un client non tecnico, vorrei chiedere: Perché stai richiedendo loro di compilare dal sorgente?

Invece, se vuoi il codice sorgente, fai quanto segue:

Crea una versione del tuo software per loro e consegna i file binari eseguibili
Consegna anche il codice sorgente a loro

Questo è davvero il miglior meccanismo con cui possono ricevere il tuo software. Se hanno bisogno di eseguirlo su più piattaforme, questo è un motivo in più per non dover compilare la tua fonte. Al contrario, distribuisci binari precompilati per tutte le piattaforme di destinazione.

È ancora possibile fornire il codice sorgente offrendo un'esperienza utente iniziale molto migliore della distribuzione di binari predefiniti. È molto preferibile passare attraverso tutta la documentazione per costruirlo da sé, indipendentemente da quanto bene sia scritta la documentazione.