[Fwd: Re: translations to Polish - quick start page]

Roman Gryzowski <[email protected]> Thu, 11 May 2006 14:47:13 +0200
Newsgroups gmane.comp.java.netbeans.webteam
Message-ID <[email protected]>
Hi,
Please find attached Polish translation of the quick start guide.
Cheers
Roman

Dnia 26-04-2006, śro o godzinie 17:08 +0200, Jack Catchpoole napisał(a):
> Grzegorz Borkowski wrote:
> > I don't have much time at this moment, but if you need it, I may
help
> > somehow. Just let me know what is to do.
> 
> Thank you both!  Just forward your work on to webmaster@ when you're 
> ready, I'll put it straight up.  Any problems just let me know.
> 
> Thanks for your help! :-)
>
(unnamed) (message/rfc822, 17.2 KB) - not displayed
quickstart_pl.html (text/html, 15.9 KB)
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
           
 
 <head>
<script src="/branding/scripts/tigris.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="http://www.netbeans.org/netbeans.css">
 
                                                 <title>
       NetBeans IDE 5.0 Przewodnik Szybkiego Startu
   </title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" >
<meta http-equiv="Content-Style-Type" content="text/css" >
<meta name="SourceCastVersion" content="2.6.2.4.10" >
<link rel="shortcut icon" href="http://www.netbeans.org/favicon.ico" type="image/x-icon" >

<meta name="keywords" content="NetBeans, IDE, Platform, free, open source, developer" >


<link rel="stylesheet" type="text/css" href="../../netbeans.css">
<meta name="author" content="John Jullion-Ceccarelli"/>
<meta name="description" content="A short guide to creating, running, and debugging a simple application in NetBeans 4.1."/>


<script language="JavaScript" type="text/javascript">
<!--
function get_sc_login() {
  var sclogin = "guest";
  return (sclogin);
}
var username=get_sc_login();
//-->
</script>
</head>
 
 
<body onload="loginfocus()" class="composite">
 
 
  
 
 
 
 <!-- begin TopTabs -->

<!-- end TopTabs -->
 
 
 
 
 <!-- start NavCol -->


<!-- end NavCol -->
 
 

 

<!-- Servlet-Specific template -->
 
 
 

        
                 
          
  

 
 



<!--      Copyright (c) 2005 Sun Microsystems, Inc. All rights reserved. -->
<!--     Use is subject to license terms.-->


<h1>NetBeans IDE 5.0 Przewodnik Szybkiego Startu</h1>
<div class="feedback-box"><a href="/about/contact_form.html?to=3&amp;subject=Feedback:%20NetBeans%20IDE%205.0%20Quick%20Start%20Guide">Oceń artykuł</a></div>
<p>Poniższy krótki instruktaż przedstawia kilka podstawowych kroków tworzenia aplikacji J2SE w NetBens IDE 5.0. Utworzymy projekt MyLib z klasą pomocniczą, następnie projekt MyApp z klasą główną implementującą metodę klasy pomocniczej. Poniższy dokument został napisany jako zwięzłe wprowadzenie mające umożliwić jak najszybsze rozpoczęcie pracy z IDE. Aby uzyskać więcej informacji o pracy z IDE, przejdź do strony <a href="http://www.netbeans.org/kb/50/index.html">Wsparcia i Dokumentacji</a> witryny NetBeans.</p>
<p> <span align="center"><b>Przykładowe Projekty</b></span>
<div class='indent'> <font class='smalltext'>Chcesz tylko przyjrzeć się jakimś gotowym projektom? W IDE, wybierz File &gt; New Project, przejrzyj zawartość folderu Samples. IDE zawiera zarówno przykłady aplikacji webowych jak i enterprise, ale również projekty <font class='smalltext'>ogólne</font> mające pomóc użytkownikom przy zapoznawaniu się z możliwościami IDE.</font> </div>
<br>
<!-- =============================================================================== -->
<h2>Tworzenie Projektu<a name="setup"></a></h2>

<p>Na początku utworzymy nową bibliotekę klas Java dla klas pomocniczych, których użyjemy później. Następnie należy utworzyć nową aplikację Java, która będzie stanowić projekt główny. Kiedy projekt MyApp będzie już gotowy dodamy do jego classpath klasy z MyLib. </p>
<div class="indent">
  <h3 class="tutorial">Tworzenie Nowej Biblioteki Klas Java</h3>
  <!--<p><b>Aby utworzyć nową biblitekę klas zawierającą klasy pomocnicze: </b></p>-->
  <ol>
    <li>Wybierz File &gt;  New Project (Ctrl-Shift-N). W Categories wybierz General. W Projects wybierz Java Class Library i naciśnij Next.
</li>
    <li>W polu Project Name wpisz <tt>MyLib</tt>. Ustaw położenie projektu na dowolny katalog na twoim komputerze. Od tego momentu będziemy odwoływać się do tego katalogu jako <tt><i>NetBeans_projects</i></tt>.
      <p><b>Uwaga:</b> Podana ścieżka powinna wyglądać tak: <code>/<tt><i>NetBeans_projects</i></tt>/MyLib/</code>

    </li>
    <li>Naciśnij Finish. Projekt MyLib zostanie otwarty w oknach zarówno Projects jak i Files.
</li>
  </ol>
  <h3 class="tutorial">Tworzenie Nowej Aplikacji Java</h3>
  <!--<p><b>Aby utworzyć nowy główny projekt aplikacji Java:</b></p>-->
  <ol>
    <li>Wybierz File &gt; New Project. Pod Categories, wybierz General. Pod Projects, wybierz Java Application i nacińśij Next.
</li>

    <li>W polu Project Name wpisz <tt>MyApp</tt>. Upenij się, że lokalizacja projektu to <tt><i>NetBeans_projects</i></tt>. </li> 

    <li>Wprowadź <tt>acrostic.Main</tt> jako klasę główną.
</li>
    <li>Upewnij się, że pola Set as Main Project oraz Create Main Class są zaznaczone.
 </li>

    <li>Naciśnij Finish. Projekt MyApp pojawi się w oknie Project a <code>Main.java</code> otworzy się w oknie Edytora Kodu Źródłowego(Source Editor).
</li>
  </ol>
  <h3 class="tutorial">Konfiguracja Classpath Kompilacji</h3>
  <!--<p><b>Aby dodać klasy pomocnicze biblioteki do classpath:
</b></p>-->
  <ol>
    <li>W oknie Projects, kliknij prawym klawiszem myszy na Libraries dla projektu My App i wybierz Add Project.</li>

    <li>
Przejdź do <tt><i>NetBeans_projects</i>/</tt> i wybierz folder projektu <tt>MyLib</tt>. Project JAR Files pokazuje pliki JAR, które mogą być dodane do projektu. Zauważ, że plik JAR dla MyLib jest obecny pomimo, że nie utworzyliśmy jeszcze żadnego pliku JAR. Ten plik JAR zostanie utworzony za pierwszym i każdym kolejnym razem gdy będziemy budować i uruchamiać projekt MyApp.
 </li>
    <li>Kliknij na Add Project JAR Files.</li>
    <li>
Rozwiń odgałęzienie Libraries. Zauważ, że plik JAR z MyLib jest dodany do classpath projektu MyApp.
</li>

  </ol>
</div>
<!-- =============================================================================== -->
<h2>Pisanie i Edytowanie Kodu Źródłowego Java<a name="create"></a></h2>
<p>
Teraz potrzebujemy utworzyć pakiet Java i dodać metody, których użyjemy przy konstruowaniu naszego akrostychu, po czym zaimplementujemy metodę <tt>acrostic</tt> w klasie <tt>Main</tt>.
</p>
<div class="indent">
  <h3 class="tutorial">Tworzenie Plików oraz Pakietów Klas Java</h3>

  <ol>
    <li>
Kliknij prawym przyciskiem myszy na projekcie MyLib i wybierz New &gt; Java Class. Wpisz <tt>LibClass</tt> jako nazwę nowej klasy, wpisz <tt>org.me.mylib</tt> w polu Package i kliknij Finish. <tt>LibClass.java</tt> zostanie otwarta w oknie Edytora Kodu Źródłowego.<br>
    </li>
    <li>
W <tt>LibClass.java</tt>, przejdź do linii pomiędzy deklaracją klasy (<tt>public
      LibClass() {</tt>) a konstruktorem (<code>public class LibClass {</code>) wpisz albo skopiuj i wklej poniższy kod metody:
</li>
    <pre class="examplecode">    public static String acrostic(String[] args) {
        StringBuffer b = new StringBuffer();
        for (int i = 0; i &lt; args.length; i++) {
            if (args[i].length() &gt; i) {
                b.append(args[i].charAt(i));
            } else {
                b.append('?');
            }
        }
        return b.toString();
    }</pre>

    <li>
Jeśli wklejony kod jest niepoprawnie sformatowany, naciśnij Ctrl-Shift-F aby przeformatować cały plik.
</li>
    <!--Uwaga: przeformatowanie nie działa na mac'ach-->
    <li>Naciśnij Ctrl-S, żeby zapisać utworzony plik.</li>
  </ol>
  <h3 class="tutorial">Edytowanie Pliku Java</h3>
  <!--<p><b>Aby zaimplementować metodę konsytrukrora w klasie main:</b></p>-->
  <ol>

    <li>
Wybierz zakładkę <tt>Main.java</tt> w Edytorze Kodu Źródłowego. Jeśli nie jest już otwarta, rozwiń MyApp &gt; acrostics w oknie Projects i kliknij dwa razy <tt>Main.java</tt>.
</li>
    <li>Usuń z kodu komentarz <tt>// TODO code application logic here</tt> w metodzie <tt>main</tt> i wpisz:
      <pre class="examplecode">String result = Li</pre>

    </li>
    <li>Naciśnij Ctrl-Spacja żeby otworzyć okno automatycznego uzupełniania kodu. IDE oferuje uzupełnianie kodu dla wszystkich klas znajdujących się w classpath kompilacji projektu. Wybierz <samp>LibClas</samp><tt>s (org.me.mylib)</tt> i naciśnij Enter. IDE uzupełnia resztę nazwy klasy ale również automatycznie tworzy deklarację import dla klasy.<br>

      <b>Uwaga:</b> IDE wyświetla również drugie okno nad oknem uzupełniania kodu zwierające Javadoc dla wybranej klasy lub pakietu. Z uwagi na to, że dla większości pakietów Javadoc nie ma, dopóki nie podświetli się jakiejś klasy, w oknie będzie widoczna informacja o tym, że &quot;Nie można znaleźć Javadoc&quot;.
</li>

    <li>
W głównej klasie wstaw kropkę po <samp>LibClass</samp>. Okno uzupełniania kodu pojawi się ponownie. Wybierz metodę <tt>acrostic(String[]args)</tt> i naciśnij Enter. IDE wstawia metodę <tt>acrostic</tt> i polazuje jej parametry w dymku podpowiedzi.
</li>
    <li>Naciśnij jeszcze raz Ctrl-Spacja żeby wyświetlić okno uzupełniania kodu, wybierz <tt>args</tt> i naciśnij Enter.
</li>
    <li>Wstaw średnik. Zauważ, że jest on wstawiany po prawym nawiasie pomimo, iż punkt w którym został wstawiony jest jeszcze wewnątrz nawiasów. Ostatecznie linijka kodu będzie wyglądać tak:

      <pre class="examplecode">String result = LibClass.acrostic(args);</pre>

    </li>
    <li>Naciśnij Enter, żeby przejść do nowej linii. Wpisz <tt>sout</tt> i naciśnij spację. Skrót <tt>sout</tt> zostaje automatycznie zamieniony na <tt>System.out.println(&quot;&quot;);
      </tt> z kursorem między cudzysłowami. Wpisz <tt>Result
      =</tt> między cudzysłowami i <tt>+ result</tt> za drugim cudzysłowem. W rezultacie powinniśmy otrzymać:

      <pre class="examplecode">System.out.println(&quot;Result = &quot; + result);</pre>

    </li>
    <li>Naciśnij Ctrl-S żeby zapisać zmiany.</li>
  </ol>
</div>
<h2>Kompilacja i Uruchamianie Projektu<a name="comp"></a></h2>
<p>W tym momencie należy ustawić argumenty uruchomieniowe aplikacji i klasy main, żeby można było projekt uruchomić. Zwrócimy również uwagę na narzędzia czyszczące kod oraz budowania i generowania dokumentacji Javadoc. </p>
<div class="indent">
  <h3 class="tutorial">Ustawianie Argumentów Uruchomieniowych</h3>
  <ol>

    <li> Kliknij prawym klawiszem na MyApp w oknie projektu, wybierz Properties i kliknij na Run po lewej stronie okna dialogowego. Zauważ, że klasa główna jest już ustawiona jako <tt>acrostic.Main</tt>.
</li>
    <li>Wpisz <samp>However&nbsp;we&nbsp;all&nbsp;feel&nbsp;zealous </samp>w polu Arguments i kliknij OK.</li>
  </ol>

  <h3 class="tutorial">Uruchamianie Głównego Projektu</h3>
  <ol>
    <li>Wybierz Run&nbsp;&gt; Run&nbsp;Main&nbsp;Project (F6) z menu Run.

Kliknij dwukrotnie na oknie Output, żeby je zmaksymalizować by móc widzieć całość wyjścia. Zauważ, że Ant najpierw tworzy <samp>MyLib.jar</samp>, a dopiero później przy jego użyciu kompiluje MyApp. Na końcu wypisuje wyjście programu, <samp>Result =
      Hello </samp> (jest to akrostych wyrażenia podanego programowi jako argument uruchomieniowy).
</li>

    <li>Wybierz okno Files i rozwiń folder projektu MyApp. Zbudowane pliki znajdują się w folderze <tt>build</tt>.
</li>
    <li>Naciśnij F6, żeby uruchomić program. Nie ma potrzeby kompilować niczego od nowa, a program zostaje uruchomiony.</li>
  </ol>
  <h3 class="tutorial">Czyszczenie i Budowanie Projektu</h3>
  <ol>
    <li>Wybierz Build &gt; Clean and Build Main Project (Shift-F11). Podczas tego procesu oba projekty, MyLib i MyApp, są czyszczone i ponownie budowane.
    </li>

    <li>Kliknij prawym przyciskiem myszy na projekt MyLib w oknie Projects i wybierz Clean Project. Tym razem wyczyszczony zostanie jedynie projekt MyLib.</li>
  </ol>
  <h3 class="tutorial">Budowanie Pojedynczego Projektu</h3>
  <ol>
    <li>Kliknij prawym przyciskiem na MyLib w oknie Projects.</li>
    <li>Wybierz z menu kontekstowego Build Project.</li>
  </ol>

  <h3 class="tutorial">Generowanie Javadoc</h3>
  <ol>
    <li>Wybierz projekt MyLib.</li>
    <li>W głównym menu IDE kliknij Build &gt; Generate&nbsp;Javadoc for&nbsp;Project "MyLib".

      <p>IDE wyświetli wyjście Javadoc w oknie Output, a przeglądarka internetowa zostanie otwarta wyświetlając Javadoc.
    </li>
  </ol>

</div>
<!-- =============================================================================== -->
<h2>Testowanie i Debugowanie Projektu<a name="test"></a></h2>
<p>Teraz używając JUnit utworzymy i uruchomimy dla naszego projektu test, a następnie uruchomimy go w debugerze IDE, żeby sprawdzić czy program nie zawiera błędów.</p>
<div class="indent">
  <h3 class="tutorial">Tworzenie Testów JUnit</h3>
  <ol>
    <li>
Kliknij prawym przyciskiem na <tt>LibClass.java</tt> w oknie Projects i wybierz Tools &gt;Create JUnit Tests (Ctrl-Shift-U). Kliknij OK aby uruchomić test z ustawieniami domyślnymi. IDE tworzy pakiet <tt>org.me.mylib</tt> oraz plik <tt>LibClassTest.java</tt> w pakiecie Test Packages.
</li>
    <li>W <tt>LibClassTest.java</tt>, usuń ciało metody
      <!--Uwaga: co to jest "ciało" metody? może powinniśmy podac numery linii kodu?-->
       <tt>testAcrostic</tt> i wpisz albo wklej w to miejsce poniższy kod:
      <pre class="examplecode">System.err.println(&quot;Running testAcrostic...&quot;);
String result = LibClass.acrostic(new String[]
                  {&quot;fnord&quot;, &quot;polly&quot;, &quot;tropism&quot;});
assertEquals(&quot;Correct value&quot;, &quot;foo&quot;, result);</pre>

    <li> Zapisz plik naciskając Ctrl-S. </li>
  </ol>
  <h3 class="tutorial">Uruchamianie Testów JUnit</h3>
  <ol>
    <li>Zaznacz projektu MyLib i wybierz z menu IDE: Run &gt; Test &quot;MyLib&quot;
      (Alt-F6). W oknie Output pojawia się zakładka <tt>MyLib&nbsp;(test)</tt>. Testy JUnit są kompilowane i uruchamiane. Dane na wyjściu testu JUnit wskazują, że program przeszedł go pomyślnie.
 </li>
    <li>Zamiast testować od razu cały projekt, można również przeprowadzić test oddzielnie dla pojedynczego pliku. Wybierz zakładkę <tt>LibClass.java</tt> w Edytorze Kodu Źródłowego i z menu IDE wybierz: 
Run &gt; Run File &nbsp;&gt; Test&nbsp;&quot;LibClass.java&quot;.
</li>

  </ol>
  <h3 class="tutorial">Debugowanie Projektu</h3>
  <ol>
    <li> W pliku <tt>LibClass.java</tt>	, przejdź do metody <code>acrostic</code> i ustaw kursor gdziekolwiek w kodzie  <samp>b.append(args[i].charAt(i));</samp>.
      Naciśnij teraz Ctrl-F8 aby ustawić w tym miejscu breakpoint. </li>

    <li>Wybierz Run&nbsp;&gt; Debug Main Project (F5). IDE otwiera okna debugowania i uruchamia program do chwili dojścia do ustawionego wcześniej breakpointa.
    </li>
    <li>Wybierz okno Local&nbsp;Variables i rozwiń <tt>args</tt>. Tablica łańcuchów literowych zawiera tekst wprowadzony wcześniej jako argument uruchomieniowy programu.

    </li>
    <li>Kliknij Step Into (F7) w pasku narzędziowym żeby program został wykonany do końca i zobacz jak tworzony jest akrostych.
      <p>W momencie kiedy program kończy działanie, okna debugera zamykają się.
    </li>
  </ol>

</div>
<h2><a name="nextsteps"></a>Co Dalej</h2>
  <p>Żeby dowiedzieć się więcej o używaniu NetBeans IDE 5.0, przejrzyj poniższe zasoby:
  </p>
  <ul>
    <li>Przewodniki Szybkiego Startu w NetBeans 5.0 dla:
      <ul>
        <li><a href="quickstart-webapps.html">Aplikacji webowych</a></li>
        <li><a href="quickstart-webservice.html">Web services</a></li>

        <li><a href="quickstart-j2ee.html">Aplikacji J2EE</a></li>
        <li><a href="quickstart-mobility.html">Aplikacji J2ME MIDP</a></li>
      </ul>
    </li>
    <li>Przewodniki importowania do NetBeans IDE 5.0:
      <ul>
        <li><a href="import_j2se.html">Aplikacji J2SE</a></li>
        <li><a href="import_web.html">Aplikacji webowych</a></li>

        <li><a href="import_j2ee.html">Aplikacji J2EE</a></li>
        <li><a href="import-mobility.html">Aplikacji J2ME MIDP</a></li>
        <!--<li><a href="http://www.netbeans.org/switch/">Projektów z Eclipse</a></li>-->
      </ul>
     </li>

    <li><a href="index.html">Strona Wsparcia i Dokumentacji NetBeans</a></li>
  </ul>

<!-- /Servlet-Specific template -->








 
 
 

 
 


<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
<script type="text/javascript">
_uacct = "UA-198771-2";
urchinTracker();
</script>

</body>

</html>