Hello World, Android Style With our

Hello World, Android Style
With our development set up, we can now finally create our first Android project in
Eclipse. The ADT plug-in installed a couple of wizards for us to make the creation of new
Android projects really easy.


Creating the Project
There are two ways to create a new Android project. The first one works by right-clicking
in the Package Explorer view (see Figure 2-4) and selecting New Project... from the
pop-up menu. In the new dialog, select Android Project under the Android category. As
you can see, there are a lot of other options for project creation in that dialog. This is the standard way to create a new project of any type in Eclipse. After confirming the dialog, the Android project wizard will open.
The second way is a lot easier: just click the button responsible for creating a new
Android project (shown earlier in Figure 2-4).
Once you are in the Android project wizard dialog, you have to make a few choices.

1.


2.
First, you must define the project name. A usual convention is to keep it
all lowercase. For this example, name the project "hello world."
Next, you have to specify the build target. For now, simply select the
Android 1.5 build target, since this is the lowest common denominator and you don't need any fancy features like multitouch yet.


CHAPTER 2: First Steps with the Android SDK 33



NOTE: In Chapter 1 you saw that each new release of Android adds new classes to the Android
framework API. The build target specifies which version of this API you want to use in your
application. For example, if you choose the Android 2.3 build target, you get access to the latest
and greatest API features. This comes at a risk, though: if your application is run on a device that
uses a lower API version (say, a device running Android version 1.5), then your application will
crash if you access API features that are only available in version 2.3. In this case, you'd need to
detect the supported SDK version during runtime and only access the 2.3 features when you're
sure that the Android version on the device supports it. This may sound pretty nasty, but as you'll see in Chapter 5, given a good application architecture you can easily enable and disable certain
version-specific features without running the risk of crashing.



3.





4.










5.


Next, you have to specify the name of your application (e.g., Hello
World), the name of the Java package in which all your source files will
eventually be located (e.g., com.helloworld), and an activity name. An
activity is similar to a window or dialog on a desktop operating system.
Let's just name it HelloWorldActivity.
The Min SDK Version field allows you to specify what minimum Android
version your application requires to run. This parameter is not required, but it's good practice to specify it. SDK versions are numbered starting
from 1 (1.0) and increase with each release. Since 1.5 is the third
release, specify 3 here. Remember that you had to specify a build target
previously, which might be newer than the minimum SDK version. This
allows you to work with a higher API level, but also deploy to older
versions of Android (making sure that you only call the supported API methods for that version, of course).
Click Finish to create your first Android project.


NOTE: Setting the minimum SDK version has some implications. The application can only be run
on devices with an Android version equal to or greater than the minimum SDK version you
specify. When a user browses the Android Market via the Market application, only applications with a fitting minimum SDK version will be shown to her.



Exploring the Project
In the Package Explorer, you should now see a project called "hello world." If you
expand it and all its children, you'll see something like Figure 2-6. This is the general structure of most Android projects. Let's explore it a little bit.

34
CHAPTER 2: First Steps with the Android SDK


AndroidManifest.xml describes your application. It defines what
activities and services it is composed of, what minimum and target
Android version it is supposed to run on, and what permissions it needs
(e.g., access to the SD card or networking).
default.properties holds various settings for the build system. We
won't touch this, as the ADT plug-in will take care of modifying it when
necessary.
src/ contains all your Java source files. Notice that the package has
the same name as the one you specified in the Android project wizard.
gen/ contains Java source files generated by the Android build
system. You shouldn't mess with them, as they get regenerated
automatically in some cases.
assets/ is where you store file our application needs (e.g.,
configuration files or audio files and the like). These files get packaged
with your Android application.
res/ holds resources your application needs, such as icons, strings for
internationalization, and UI layouts defined via XML. Like assets, they
also get packaged with your application.
Android 1.5 tells us that we are building against an Android version 1.5
target. This is actually a dependency in the form of a standard JAR file
that holds the classes of the Android 1.5 API.
The Package Explorer view hides another directory, called bin/, which holds the
compiled code that is ready for deployment to a device or emulator. As with the gen/ folder, we usually don't care what happens in this folder.


CHAPTER 2: First Steps with the Android SDK 35


























Figure 2-6. Hello World project structure

We can easily add new source files, folders, and other resources in the Package
Explorer view by right-clicking the folder we want to put the new resources in, and
selecting New plus the corresponding resource type we want to create. For now,
though, we'll leave everything as is. Next, let's modify the source code a little.

Kết quả (Quốc tế ngữ) 1:

Saluton Mondo, Android Stilo
Kun nia evoluo starigis, ni povas nun fine krei nia unua Android projekto en
Eklipso. La ADT kromprogramo instalita paro de sorĉistoj por ni fari la kreo de nova
Android projektoj vere facila. Kreante la Projekto Ekzistas du manieroj por krei novan Android projekto. La unua funkcias per dekstra musklako sur la Pako Explorer vido (vidu Figuro 2-4) kaj selektante novan projekton ... el la popo-up menu. En la nova dialogo, elektu Android Projekto sub la Android kategorio. Kiel vi povas vidi, estas multaj aliaj ebloj por projekto kreo en tiu dialogo. Tio estas la norma maniero por krei novan projekton de iu tipo en Eklipso. Post konfirmi la dialogo, la Android projekto sorĉisto malfermos. La dua maniero estas multe pli facila: simple klaku la butonon respondeca kreante nova Android projekto (montrita frue en Figuro 2-4). Kiam vi estas en la Android projekto sorĉisto dialogo , vi devas fari kelkajn decidojn. 1. 2. Unue vi devas difini la projekto nomo. Kutima konvencio estas teni ĝin ĉiuj minuskla. Por ĉi tiu ekzemplo, nomumi la projekto "saluton mondo." Venonta, vi devas doni la muntaĵo celo. Nuntempe, simple elektu la Android 1.5 muntaĵo celo, pro tio estas la plej malalta komuna denominatoro kaj vi ne bezonas fancy trajtoj kiel multitouch ankoraŭ. ĈAPITRO 2: Unuaj Paŝoj kun la Android SDK 33 NOTO: En Ĉapitro 1 vi vidis ke ĉiu nova ĵeto de Android aldonas novajn klasojn al la Android kadro API. La muntaĵo celo specifas kiun version de ĉi tiu API vi volas uzi en via kandidatiĝo. Ekzemple, se vi elektas la Android 2.3 muntaĵo celo, vi ricevas aliron al la plej lasta kaj plej granda API karakterizaĵoj. Ĉi venas je risko, tamen: se via kandidatiĝo estas kuri sur mekanismo kiu uzas pli malaltan API versio (diri, mekanismo kurante Android versio 1.5), tiam via aplikaĵo kraŝi se vi aliras API karakterizaĵoj kiuj nur estas disponeblaj en versio 2.3 . En tiu kazo, vi bezonus detekti la subtenataj SDK versio dum ekzekuto kaj nur aliri la 2.3 karakterizaĵoj kiam vi estas certa ke la Android versio de la mekanismo subtenas ĝin. Ĉi tio povas soni belan aĉa, sed kiel vi vidos en ĉapitro 5, donita bona apliko arkitekturo povas facile ŝalti kaj malŝalti certaj versio-specifaj trajtoj sen kuri la riskon de kraŝado. 3. 4. 5. Venonta, vi devas entajpi la nomon de via apliko (ekzemple, Saluton Mondo), la nomo de la Java pakaĵo en kiu ĉiuj viaj fontodosierojn estos eventuale lokos (ekz com.helloworld) kaj aktiveco nomo. An aktiveco estas simila al fenestro aŭ dialogon sur labortablo mastruma sistemo. Ni simple nomu ĝin HelloWorldActivity. La Min SDK Versio kampo permesas vin specifi kion minimuma Android versio via apliko postulas kuri. Tiu parametro ne estas postulata, sed estas bona praktiko por specifi ĝin. SDK versioj kalkulon starta el 1 (1.0) kaj pliigi kun ĉiu ĵeto. Ekde 1.5 estas la tria eldono, specifi 3 tie. Memoru ke vi devis specifi muntaĵo celo antaŭe, kio povus esti pli nova ol la minimuma SDK versio. Tiu ebligas al vi labori kun pli alta API nivelo, sed ankaŭ disfaldi al pli malnovaj versioj de Android (certigante ke vi nur nomas la subtenataj API metodoj por tiu versio, kompreneble). Klaku Finu por krei via unua Android projekto. NOTO: Scenaro la minimuma SDK versio havas kelkaj implicojn. La apliko povas esti plenumitaj nur en mekanismoj kun Android versio egala al aŭ pli granda ol la minimuma SDK versio vi specifas. Kiam uzanto navigas la Android Market tra la Market apliko, nur aplikoj kun decan minimuman SDK versio estos montrita al ŝi. Esplorante la Projekto En la Pako Explorer, vi nun devus vidi projekto nomita "saluton mondo." Se vi vastigi gxin kun cxiuj gxiaj infanoj, vi vidos ion kiel Figuro 2-6. Tiu estas la ĝenerala strukturo de plej Android projektoj. Ni esploros gxin iomete. 34 Ĉapitro 2: Unuaj Paŝoj kun la Android SDK AndroidManifest.xml priskribas via kandidatiĝo. Ĝi difinas kio aktivecoj kaj servoj estas formita de: Kia minimuma kaj celo Android versio estas supozitaj kuri plu, kaj kio permesojn bezonas (ekz, aliro al la SDa karto aŭ retoj). Default.properties tenas diversajn agordojn por la muntaĵo sistemo. Ni ne tuŝos tion, kiel la ADT kromprogramo prizorgos modifante ĝin kiam necesas. Src / enhavas ĉiujn viajn Java fontodosierojn. Rimarku ke la pako havas la saman nomon kiel la unu vi specifitaj en la Android projekto sorĉisto. Gen / enhavas Java fontodosierojn generita per la Android muntaĵo sistemo. Vi devus ne mess kun ili, kiel ili akiras regenerita aŭtomate en iuj kazoj. Aktivoj / estas kie vi stoki dosieron nia apliko bezonoj (ekz, agordaj dosieroj aŭ audio dosierojn kaj similaj). Tiuj dosieroj akiri pakita kun via Android apliko. Res / tenas rimedoj via apliko bezonoj, kiel ekzemple ikonoj, kordoj por internaciiĝo, kaj UI arangoj difinitaj per XML. Kiel valoraĵoj, ili ankaŭ get pakita kun via apliko. Android 1.5 nin diras ke ni konstruas kontraŭ Android versio 1.5 celo. Tiu estas fakte dependeco en la formo de norma JAR dosiero kiu tenas la klasoj de la Android 1.5 API. La Pako Explorer vido kaŝas alia dosierujo, nomitan bin /, kiu tenas la kompilita kodo kiu estas preta por deplojo al mekanismo aŭ emulador . Kiel kun la gen / dosierujo, ni kutime ne zorgas kio okazas en tiu ĉi dosierujo. ĈAPITRO 2: Unuaj Paŝoj kun la Android SDK 35 Figuro 2-6. Saluton Mondo projekto strukturon Ni povas facile aldoni novajn fontodosierojn, dosierujoj, kaj aliaj rimedoj en la Pako Explorer vido per dekstra musklako la dosierujo ni volas meti la novaj rimedoj en kaj elektanta Nova plus la responda rimedotipo ni volas krei. Nuntempe, tamen, ni lasos ĉiu kiel estas. Venonta, ni modifos la fontkodo iom.