Lập trình Wrox Professional Xcode 3 cho Mac OS part 75 pptx

22 Using the Organizer WHAT'S IN THIS CHAPTER? Adding items to your organizer Using, editing, and creating custom organizer actions Making snapshots of organizer items Managing iPhone/iPod devices Confi guring your iPhone/iPod for development Using iPhone/iPod developer utilities The organizer window, shown in Figure 22 - 1, is a recent addition to Xcode. It encompasses an eclectic collection of ad hoc functionalities, and could have easily been named the “ Doesn ’ t Belong Anywhere Else ” window. Nevertheless, it performs a number of vital functions, particularly for iPhone and iPod Touch developers. It acts as a gathering point for disparate resources, furnishes a framework for automating and scripting your workfl ows, provisions and authorizes devices for development, aids in iPhone app debugging, and even provides a means of managing non - Xcode projects. Choose the Window ➪ Organizer (Control+Command+O) command to open the organizer window. There is only one organizer window; it doesn ’ t belong to any project. The organizer window has a set of predefi ned groups on the left. Click the details button at the bottom of the window to expand or collapse the optional details pane on the right. ➤ ➤ ➤ ➤ ➤ ➤ FIGURE 22 - 1 c22.indd 617c22.indd 617 1/21/10 4:37:50 PM1/21/10 4:37:50 PM Download at getcoolebook.com 618 ❘ CHAPTER 22 USING THE ORGANIZER The fi rst part of this chapter focuses on the Projects & Sources group. Here you can manage projects, folders, documents, and other fi le items, attach custom scripts to those items, and perform basic manipulations like editing, moving, and renaming them. The later sections deal with the Devices and iPhone Development groups. These are specialized features designed specifi cally for iPhone and iPod Touch development. PROJECTS & SOURCES The Projects & Sources group lets you collect projects, folders, and fi les in a single location. Once you have added items to the organizer, you can: Open or edit items Rename, move, and copy fi les Build, clean, and run projects Execute custom scripts Search folders Take snapshots These actions are available via the add menu or action menu in the lower - left corner of the window, the action buttons in the toolbar, and the Right/Control+click contextual menu for each item. All four menu locations are illustrated in Figure 22 - 2. ➤ ➤ ➤ ➤ ➤ ➤ Action Toobar Buttons Right/Control+click Menu Details Pane Action Menu Add Menu FIGURE 22 - 2 c22.indd 618c22.indd 618 1/21/10 4:37:53 PM1/21/10 4:37:53 PM Download at getcoolebook.com Adding Items to the Organizer The fi rst step in using the organizer is to add some items to it. Though you can add almost any item (document or folder) to the organizer, its capabilities bloom when you add folders, particularly project folders. Use any of these techniques to add items to the organizer: Drag a document or folder into the Projects & Sources group. Choose Add Existing Folder from either the add or Right/Control+click menu. Create a new fi le or folder and add it to the organizer using any of the following action menu commands: New File New Folder New From Template ➪ Template Name Once you have an item in the organizer, what you can do with it depends greatly on what kind of item it is. The following table lists all of the things you can do with an item directly from the organizer, but not all actions apply to every type of item: TO DO THIS DO THIS Open document or folder in Finder Double - click the item or choose the Open With Finder command Open project folder Choose the Open With Finder command Open project in project folder Double - click the item Edit a fi le that Xcode understands Select the document Reveal item in Finder Choose the Reveal In Finder command Edit folder location Choose the Assign New Location command Rename item Select, and then single - click the item ’ s name Build a project in a folder Choose a build action from the Build button Clean a project in a folder Choose an action from the Clean button Run an executable in a folder Choose an action from the Run button Run a custom action script for a folder Choose an action from the Action button Search the contents of a folder Choose the Find In Selected Organizer Folder command Take a snapshot of a folder Choose the Make Snapshot command Manage the snapshots of a folder Choose the Snapshots command Remove a top - level item Select it and then press the Delete key or choose the Remove from Organizer command ➤ ➤ ➤ ➤ ➤ ➤ Project & Sources ❘ 619 c22.indd 619c22.indd 619 1/21/10 4:37:55 PM1/21/10 4:37:55 PM Download at getcoolebook.com 620 ❘ CHAPTER 22 USING THE ORGANIZER Xcode provides very basic actions for documents, signifi cantly more for folders, and even more for project folders. The basic actions — open, edit, rename, and reveal in Finder — should all be self - explanatory. Items in the organizer are much closer to the “real thing.” You might be tempted to treat them like source items in a project — that is, quasi-independent objects that abstractly refer to a real item in the fi le system — but organizer items act much more like items in the Finder. If you rename any item, drag an item into a folder, drag an item out of a folder, or delete an item in a folder, you’re initiating a real action in the fi le system — the item will be renamed, moved, copied, or trashed. About the only non-destructive action you can take in the organizer is to delete a top-level item in the Projects & Sources group. This merely removes the organizer’s reference to the item, but does not delete the source item. The organizer makes a subtle distinction between a folder and a project folder that contains a project document. For example, double - clicking a project folder opens the project in Xcode, not the project folder in the Finder. In a somewhat ironic twist, Xcode largely ignores project documents that you add to the organizer; it prefers that you add the project folder that contains it. You are free to add a project document, but Xcode will treat it like a generic document, not a project. Any folder in the organizer can be associated with actions . Folders that have one or more actions are stamped with the Xcode “ tool ” icon. The Build, Clean, Run, and (the eponymous) Action actions that you can invoke are described in the “ Using Organizer Actions ” section. Embracing Foreign Projects The organizer is a great place to manage foreign — that is, non - Xcode — projects. As you ’ ll see in later sections, you can defi ne custom actions for organizer items; actions like make, clean, and install. Adding a project that ’ s built using make or ant (a Java build tool) lets you manage that project from within Xcode. You can defi ne actions to build various targets, perform source control, or anything else you need. The add menu includes a number of templates for Java projects that are built with ant. Use these as starting points for subsuming your non - Xcode projects into the organizer, then automate them using organizer actions. Searching Organizer Folders You can search all of the fi les within a folder in the organizer using the multi - fi le search window. To search the contents of a folder, follow these steps: 1. Select a folder in the organizer. 2. Choose the Find in Selected Organizer Folder command in the actions menu. 3. Perform your search using the multi - fi le search window. c22.indd 620c22.indd 620 1/21/10 4:37:56 PM1/21/10 4:37:56 PM Download at getcoolebook.com The multi - fi le search window is described in Chapter 8. It ’ s identical to using the project fi nd window, except that the target fi le set is permanently set to In Selected Organizer Folder. Taking Snapshots You can take and restore snapshots of any top - level folder in the organizer. To take a snapshot, choose Make Snapshot from the action menu. To review, compare, restore, or delete a snapshot, choose Snapshots from the action menu. Using snapshots in the organizer is identical to using snapshots in a project, described in Chapter 11. When taking snapshots from within your project, the project folder gets copied. In the organizer, the snapshot is whatever top - level folder you ’ ve selected in the organizer. Organizer snapshots and project snapshots are maintained independently. That is, making a snapshot of a project folder in the organizer does not add a snapshot to that project’s snapshot window, and vice versa. USING ORGANIZER ACTIONS The action buttons in the toolbar execute action scripts that (can potentially) perform an almost unlimited variety of tasks. Actions can only be defi ned for folder items in the organizer. A newly added non - project folder will (probably) have no actions defi ned. Xcode automatically generates a number of useful actions whenever you add a project folder to the organizer. You are free to use, modify, remove, and add your own actions, as you ’ ll see in the next few sections. Each action toolbar button is a combination of a button and a menu. Click and hold the button — don ’ t Right/Control + click the button, you ’ ll only get the toolbar menu — to reveal its action menu, as shown in the upper left of Figure 22 - 2. It lists the actions defi ned for the selected folder along with an Edit Actions command. Notice that one of the actions in the menu is checked. This is the default action . If you simply click the action button, this is the action that will be performed. Executing a different action in the list also makes it the new default. Just remember that clicking the button will perform the last selected action again. Automatically Created Actions When you add a project folder to the organizer, Xcode generates a number of actions automatically — the exception to this is described in the “ Preserving and Sharing Actions ” section later in this chapter. The actions it generates are based on the project documents found in the project folder. After adding a project folder you will fi nd: The Build button has a build action for each build confi guration in the project. The Clean button has a clean action and a clean all action for each build confi guration in the project. ➤ ➤ Using Organizer Actions ❘ 621 c22.indd 621c22.indd 621 1/21/10 4:38:01 PM1/21/10 4:38:01 PM Download at getcoolebook.com . Finder Choose the Reveal In Finder command Edit folder location Choose the Assign New Location command Rename item Select, and then single - click the item ’ s name Build a project in a folder Choose. a project in a folder Choose an action from the Clean button Run an executable in a folder Choose an action from the Run button Run a custom action script for a folder Choose an action from the. contents of a folder Choose the Find In Selected Organizer Folder command Take a snapshot of a folder Choose the Make Snapshot command Manage the snapshots of a folder Choose the Snapshots command Remove