| | 1 | = !NetBeans - Subversion Tutorial = |
| | 2 | [[BR]] !NetBeans has Subversion features integrated into the IDE.'''[[BR]] ''' |
| | 3 | |
| | 4 | == Prerequisites == |
| | 5 | [[BR]]You must have been issued a username and password for the TMC project Subversion repository.[[BR]] You must have installed [http://www.netbeans.org/ NetBeans] ver 6.9 or later.[[BR]]The project manager may want to reset the Pizza project resources.[[BR]] |
| | 6 | |
| | 7 | == Checkout the !NetBeans project == |
| | 8 | === Checkout the repository into !NetBeans. === |
| | 9 | 1. Start !NetBeans. [[BR]] |
| | 10 | 1. From the menubar select Team > Subversion > Checkout.[[BR]] In the Checkout dialog, enter[[BR]] Repository URL: `svn_ssh://git.tokomak.net/svn/tmcsimulator/branches/SVNtutorial` [[BR]] Supply !Username/Password (for repository account). [[BR]] |
| | 11 | 1. Click Next. (Observe "connecting to Subversion Repository" progress bar). If Linux prompts you to enter a "Master Password" you may click "Cancel."[[BR]] |
| | 12 | 1. If a Server Certificate Verification Failed dialog appears, double check the Certification Information, then click "Accept".[[BR]] |
| | 13 | 1. The Folders to Checkout dialog will appear. Enter these fields:[[BR]] Repository folder: `branches/SVNtutorial`[[BR]] Verify Local Folder: ''/path/to/folder''/!NetBeansProjects[[BR]] Check the box: Scan for !NetBeans Projects after Checkout.[[BR]]Click Finish. |
| | 14 | 1. Checkout Completed dialog will appear. Click Open Project. |
| | 15 | 1. !PizzaOrderIntl will appear in the Projects panel. Right-click on the project name and select "Run" from the context menu. |
| | 16 | 1. A window should appear with the Pizza Order International application. [[BR]] |
| | 17 | 1. To operate the application, |
| | 18 | 1. Check one or more checkboxes for your desired toppings and click the Submit button. |
| | 19 | 1. Display the toppings in a different language by choosing a locale from the combo box. (Initially, only English and Spanish are enabled). |
| | 20 | 1. View the authors by selecting Credits from the Help menu. |
| | 21 | |
| | 22 | == Modify the project == |
| | 23 | You will be enhancing the application to include labels in another language. |
| | 24 | |
| | 25 | === Create a new label properties file === |
| | 26 | 1. Decide which language you want to implement. View the locales in the combo box and select one that does NOT have an author in the Credits page. You can verify that it has not been implemented by selecting it and observing that the labels remain in English. [[BR]] |
| | 27 | 1. In the project pane, [[BR]] expand the project node (!PizzaOrderIntl), [[BR]] expand Source Packages, [[BR]] expand resources[[BR]] |
| | 28 | 1. Right-click on Labels.properties and select Add -> Locale. |
| | 29 | 1. In the New Locale dialog, select the language code you have chosen from the Language Code combo box (NOT the Predefined Locales list). Click OK. |
| | 30 | 1. Observe a new properties file appears in the list of Labels files. It will be colored green because it isn't yet part of Subversion. Double-click on your new language file and and edit window will appear containing the default properties:[[BR]] |
| | 31 | |
| | 32 | {{{ |
| | 33 | # This is the default Labels.properties file |
| | 34 | label1 = Toppings |
| | 35 | choice1 = Onions |
| | 36 | choice2 = Mushrooms |
| | 37 | choice3 = Peppers |
| | 38 | choice4 = Olives |
| | 39 | choice5 = Tomatoes |
| | 40 | choice6 = Pepperoni |
| | 41 | button1 = Submit |
| | 42 | message1 = You ordered a pizza with these toppings: |
| | 43 | }}} |
| | 44 | 1. Using Google Translate or other resource, replace each english word with the corresponding phrase in the target language. (You won't be graded on correctness). [[BR]] |
| | 45 | 1. Change 'default' in the first line to whatever locale you are creating. [[BR]] |
| | 46 | 1. Save the file. (Ctrl-S)[[BR]] |
| | 47 | 1. Run the application, select your language from the combo box, and you should observe the labels are changed appropriately. Click Submit and verify the message appears correctly.[[BR]] |
| | 48 | 1. Exit the application, correct any mistakes in your properties file. |
| | 49 | 1. When the properties file is complete and correct, add it to Subversion by right-clicking on the file in the project pane and choose Subversion > Show Changes[[BR]] |
| | 50 | 1. !NetBeans displays a Subversion status window. Your new file should appear with a status "Locally New". Click the "Update All" icon. |
| | 51 | 1. It's unlikely, but possible, that someone else picked the same language as you and created the same file since you began this activity. If they completed the activity before you did, when you do "Update All" you'll get this error:[[BR]]Failed to add file '!NetBeansProjects/PizzaOrderIntl/src/pizzaorderintl/resources/Labels_''xx''.properties': an unversioned file of the same name already exists[[BR]] If that happens, right-click and delete the file, then choose a different language, and go back to step 1 of this section. |
| | 52 | 1. Right-click on the file and choose "Commit". Enter a Commit Message such as "Labels_FI.properties added for Finnish language." Click the Commit button. ''Note: It's usually helpful to include the name of the file being modified as the first item in the commit message.'' |
| | 53 | 1. The Subversion status window should clear and the file text color turns from green to black. |
| | 54 | |
| | 55 | === Add yourself to the Credits page === |
| | 56 | 1. In the project pane, right-click on Source Packages, and from the context menu select Subversion > Update. This updates your working copy with the most recent additions in the repository.[[BR]] |
| | 57 | 1. In the project pane, [[BR]] expand the project node (!PizzaOrderIntl), [[BR]] expand Source Packages, [[BR]] expand resources. [[BR]] Double-click on Credits.txt. |
| | 58 | 1. The text file opens in the editor window. |
| | 59 | 1. Add your Language Code and your first initial and last name to the bottom of the file. Save the file.[[BR]] |
| | 60 | 1. Run the application, and verify that your name appears properly in the Credits box (Help -> Credits). [[BR]] |
| | 61 | |
| | 62 | === Update your files from the repository. === |
| | 63 | 1. In the project pane, right-click on the Source Packages, and from the context menu select Subversion > Update. |
| | 64 | 1. If no one else made any changes to the Credits.txt while you were working on it, the Update step will be successful. Skip to the Commit step.[[BR]] |
| | 65 | 1. If the Versioning Output shows a status of "Conflict" then someone else updated the Credits at the same time. |
| | 66 | 1. Right-click on the file and select Subversion > Revert Modifications. |
| | 67 | 1. Select the .txt file in the dialog which appears and click Select. |
| | 68 | 1. In the Revert Modifications Dialog, "Revert Local Changes" radio button should be selected. Click Revert. |
| | 69 | 1. Now repeat the steps in adding yourself to the credits page. |
| | 70 | |
| | 71 | === === |
| | 72 | === Commit your changes to the repository. === |
| | 73 | 1. In the project pane, right-click on Source Packages, and from the context menu select Subversion > Commit. Enter a Commit Message such as "Added J. Smith to credits box." Click the Commit button. |
| | 74 | 1. Exit !NetBeans. You're done! |
| | 75 | 1. If you somehow made a mistake and destroyed someone else's work (or otherwise messed things up), inform the instructor and he will revert the repository for you. |
| | 76 | |
| | 77 | Here's some tips on [http://wrttn.in/f3819f writing good commit messages].[[BR]] |
| | 78 | |
| | 79 | ---- |
