Export (0) Print
Expand All

IDE Differences Between Xbox 360 and Windows Development

This section describes the various differences in the appearance and behavior of the integrated development environment (IDE) of XNA Game Studio when developing for the Xbox 360.

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.

Title
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.
Description
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.
Company
Specifies a company name for the assembly manifest.
Product
Specifies a product name for the assembly manifest.
Copyright
Specifies a copyright notice for the assembly manifest.
Trademark
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.
GUID
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:

  • Microsoft.Xna.Framework
  • Microsoft.Xna.Framework.Game
  • mscorlib
  • system
  • system.xml

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.

Bb203930.caution(en-US,XNAGameStudio.20).gifCaution
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
  • XML Schema
    Bb203930.note(en-US,XNAGameStudio.20).gifNote
    This option is only available in Microsoft Visual Studio.
  • Text File
  • Assembly Information File
  • Resources file

    Bb203930.caution(en-US,XNAGameStudio.20).gifCaution
    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.
  • Class Diagram
    Bb203930.note(en-US,XNAGameStudio.20).gifNote
    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

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.

Community Additions

ADD
Show:
© 2014 Microsoft