IDE Differences Between Xbox 360 and Windows Development
- Assembly Information Dialog Box
- XNA Game Studio Device Management 2.0 Toolbar
- Add Reference Dialog Box
- Add New Item Dialog Box
- Project Properties
- Unsupported Features of Microsoft Visual Studio
Assembly Information Dialog Box
You can open the Assembly Information dialog box from the Application page in the Project Designer. Open the Project Designer by double-clicking the Properties folder under the project node in Solution Explorer or by selecting [project name] Properties from the Project menu. Then click Assembly Information on the Application page.
Use this dialog box to change the assembly information for the current Xbox 360 project. This information includes the game title, brief description, company name, copyright, and trademark. Some of this information is displayed in the My Games area of the Games Library of an Xbox 360 console.
When used for an Xbox 360 project, the functionality of this dialog box differs in two aspects relative to Windows-based projects: The File Version field and the Make Assembly COM-Visible check box are not available due to differences in the handling of assemblies on the Xbox 360 console.
The assembly information specified here only affects the values seen in My Games area of Games Library if the project is a game project. Assembly information of library projects is not used when deploying or displaying information about a game.
- Displayed in the My Games area of Games Library. Specifies a title for the assembly manifest. Only the first 25 characters of this field are displayed. This field is required to deploy a game to an Xbox 360 console.
- Displayed in the My Games area of Games Library. Specifies an optional description for the assembly manifest. Only the first 300 characters of this field are displayed.
- Specifies a company name for the assembly manifest.
- Specifies a product name for the assembly manifest.
- Specifies a copyright notice for the assembly manifest.
- Specifies a trademark for the assembly manifest.
- Assembly Version
- Specifies the version of the assembly.
- File Version
- This field is not available to Xbox 360 projects due to differences in the handling of assemblies on the Xbox 360 console. Specifies a version number that instructs the compiler to use a specific version for the Win32 file version resource.
- A unique GUID that identifies the assembly. When you create a project, Visual Studio generates a GUID for the assembly.
- Neutral Language
- Specifies which culture the assembly supports.
- Make Assembly COM-Visible
- This field is not available to Xbox 360 projects due to differences in the handling of assemblies on the Xbox 360 console. Specifies whether types within the assembly will be accessible to COM.
XNA Game Studio Device Management 2.0 Toolbar
An additional toolbar for maintaining a list of one or more Xbox 360 consoles available for deployment is available when an Xbox 360 Game project or Xbox 360 Game Library project is loaded in supported versions of Visual Studio tools. For more information, see Using XNA Game Studio Device Center, or the "Managing Several Xbox 360 Consoles with XNA Game Studio Device Center" section in Deploying an Xbox 360 Game. Note that most of the options on this toolbar are only available when the startup project is an Xbox 360 project.
Add Reference Dialog Box
Use this dialog box to add component references needed by your Xbox 360 project. Because the Xbox 360 platform does not have the same feature set as the Windows platform, the COM tab is hidden and the .NET tab contains only Xbox 360–specific assemblies. These assemblies include:
These assemblies, with the exception of system.xml, are automatically added to an Xbox 360 project.
You can open the Add References dialog box by right-clicking the References item in Solution Explorer and then clicking Add Reference.
|The Projects tab lists all projects in the solution, regardless of platform. The assemblies in the Browse and Recent tabs may also include references to assemblies that are not for the Xbox 360 platform. Referencing assemblies that target platforms other than Xbox 360 is not supported for Xbox 360 projects.|
Add New Item Dialog Box
You can open the Add New Item dialog box by right-cicking the solution in Solution Explorer or from the Project menu. Use this dialog box to add new Xbox 360 supported items. This list contains the following items.
- C# Class
- C# Interface
- C# Code File
- XML File
Note This option is only available in Microsoft Visual Studio.
- Text File
- Assembly Information File
Caution String resources are the only built-in resource type supported by Xbox 360 projects. Adding other resource types such as bitmaps or icons to a resource file may result in compilation errors.
Note This option is only available in Microsoft Visual Studio.
- Game Component
- Content Type Reader
The Assembly Information File template for Xbox 360 projects excludes the AssemblyFileVersion attribute, which is not supported on the Xbox 360 platform.
Project properties are grouped into pages in the Project Designer. You can access the Project Designer in the Project menu by clicking Properties, or by double-clicking the Properties item in Solution Explorer. The Project Designer property pages are located in the same middle pane used by the code editor.
- On the Build page, the Platform target drop-down menu has been disabled in supported versions of Microsoft Visual Studio tools.
- The Debug page has been modified for Xbox 360 game projects. The Start Action and Enable Debuggers options have been disabled. The Working Directory, Use Remote Machine, and Enable the Visual Studio hosting process controls have also been disabled. Please note that the ... button, associated with the Working Directory option, is still enabled. However, any input entered with this control is still ignored by the project and XNA Game Studio.
- The Settings project property page allows you to add a settings file to your Xbox 360 project. However, note that the settings file is not supported for Xbox 360 projects.
- The Security and Publishing pages are hidden.
Unsupported Features of Microsoft Visual Studio
The following Microsoft Visual Studio items are not supported for XNA Game Studio Xbox 360 Game projects:
- Creating or running Visual Studio Team Edition for Software Testers unit tests for an Xbox 360 Game project. For this reason, the Create Unit Tests… command is hidden in the Code Editor context menu.
- Adding Windows Form, User Control, or Component classes to an Xbox 360 Game project. For this reason, these options are not available from the Project context menu.
- Adding Web references to an Xbox 360 Game project. For this reason, the Add Web Reference command is not available from the References context menu or the Project context menu.
- Adding data sources. Data sources are not supported on the Xbox 360 platform. For this reason, the Data menu is hidden when an Xbox 360 Game project is active.
- Publishing the project using the Visual Studio Publish command. For this reason, this command is not available from the Build menu. You should use the Deploy command instead. For more information on deployment, see Deploying an Xbox 360 Game.