Channel and Version Requirements - Revision history

Oz Linden: /* Viewer Channel Name */

2013-08-09T15:02:23Z

Viewer Channel Name

← Older revision		Revision as of 08:02, 9 August 2013
Line 21:		Line 21:
	To set the channel name, set the cmake variable on the autobuild command line:		To set the channel name, set the cmake variable on the autobuild command line:
	autobuild configure -- -DVIEWER_CHANNEL='"''channel''"'		autobuild configure -- -DVIEWER_CHANNEL='"''channel''"'
			or
			autobuild configure -- -DVIEWER_CHANNEL="\"''channel''\""

	===Version Number===		===Version Number===

Oz Linden at 18:55, 1 May 2013

2013-05-01T18:55:36Z

← Older revision		Revision as of 11:55, 1 May 2013
Line 43:		Line 43:
	* '''NOTE: If Linden Lab determines that a particular client distribution contains security vulnerabilities or exploits, Linden Lab may block that particular version of the client from logging in.'''		* '''NOTE: If Linden Lab determines that a particular client distribution contains security vulnerabilities or exploits, Linden Lab may block that particular version of the client from logging in.'''
	* '''NOTE: If Linden Lab introduces a server update that requires a particular capability in order to connect to the server, Viewers that do not include the required capability will be unable to connect to ''regions running that version of the server.''''' It is the intention of Linden Lab to make these required updates infrequent, and to make the Viewer code available well in advance of the server update.		* '''NOTE: If Linden Lab introduces a server update that requires a particular capability in order to connect to the server, Viewers that do not include the required capability will be unable to connect to ''regions running that version of the server.''''' It is the intention of Linden Lab to make these required updates infrequent, and to make the Viewer code available well in advance of the server update.

			[[Category:Open Source Portal]]

Oz Linden at 17:51, 1 May 2013

2013-05-01T17:51:53Z

← Older revision		Revision as of 10:51, 1 May 2013
Line 1:		Line 1:
	== Setting a Viewer Identifier for an Open Source Viewer ==		== Setting a Viewer Identifier for an Open Source Viewer ==
	A Viewer Identifier is unique to a particular release of a viewer. It is composed of ~~three~~ parts: the ~~Version~~ Name~~, the Version Variant,~~ and the Version Number~~. The combination of the Version Name and the Version Variant form the Channel Name~~.		A Viewer Identifier is unique to a particular release of a viewer. It is composed of two parts: the Viewer Channel Name and the Version Number.

	~~1. Choose a Version~~ Name		=== Viewer Channel Name===
	* The ~~default Version~~ Name ~~is "Second Life"~~		The Viewer Channel Name should be a unique base name for your viewer, optionally combined with a variant name (typically used to distinguish the type of build). Linden Lab viewer builds use:
	~~2. Choose a Version Variant. The default variant is "Developer"~~		;Second Life
	* The combination of the Name and Variant should be combined to ~~make~~ the ~~Channel Name~~.		:as the base name, followed by either
	* The default ~~Channel~~ Name is "Second Life ~~Developer"~~		:;Release
	* Other standard Linden Lab Channel Names are "Second Life Release" and "Second Life Beta Viewer". Please note that any Channel Name containing "Second Life" is reserved for use by Linden Lab (~~but~~ if you are building a test version for submission to Linden Lab, there is no need to change this).		::for release builds
	* The Channel Name can be any ASCII string. It should not violate [http://secondlife.com/corporate/brand/trademark/ Linden Lab's trademark policy]. We recommend that the Channel Name be the name of the Open Source Viewer.		:;Beta ''project-name''
	~~2. Choose a~~ Version Number		::for early release user test builds
	* The Version Number is in the form ~~Major~~.~~Minor~~.~~Patch~~.~~Build~~		:;Project ''project-name''
	* The Version Number can be any four numbers, separated by periods.		::for integration builds (which may or may not be publicly available)
			:;Test
			::for developer builds
			:The default Version Name is '''Second Life Test'''
			{{Note\|Any Channel Name containing "Second Life" is reserved for use by Linden Lab (if you are building a test version for submission to Linden Lab, there is no need to change this)}}

			The Channel Name can be any ASCII string. It should not violate [http://secondlife.com/corporate/brand/trademark/ Linden Lab's trademark policy]. We recommend that the Channel Name be the name of the Open Source Viewer.

			To set the channel name, set the cmake variable on the autobuild command line:
			autobuild configure -- -DVIEWER_CHANNEL='"''channel''"'

			===Version Number===
			The Version Number is in the form ''major''.''minor''.''patch''.''build'': any four numbers, separated by periods.
	* We recommend using the Major and Minor numbers from the most recently merged Linden Lab source code.		* We recommend using the Major and Minor numbers from the most recently merged Linden Lab source code.
	** Linden Lab uses an internal number from our source control system for the Build number.
	* The 4 numbers together should uniquely identify a version of the sources from which the viewer was built.
	~~3. Set the Channel and Version in the code~~
	* Edit indra/llcommon/llversionviewer.h
	** Modify LL_CHANNEL with the Channel Name
	** Modify LL_VERSION_BUILD with the appropriate build number
	* Update the Version Number in the following files:
	** indra/newview/res/newViewRes.rc - ''"FileVersion" and "ProductVersion" in the Version section''
	** indra/newview/Info-SecondLife.plist - ''CFBundleVersion''
	** indra/newview/English.lproj/InfoPlist.strings - ''CFBundleShortVersionString''
	* Build the code

	~~== Packaging~~ for ~~Distribution ==~~		The 4 numbers together should uniquely identify a version of the sources from which the viewer was built; Linden Lab uses an internal number from our build farm system for the Build number to ensure uniqueness.
	* From the indra/newview ~~directory run viewer_manifest~~.~~py with~~ the ~~following arguments:~~
	** viewer_manifest.py --login_url=http:/~~/your~~.~~login.url.com~~		'''To change the first three elements of the version number, edit the file <tt>indra/newview/VIEWER_VERSION.txt</tt>'''
	* See http://~~wiki~~.~~secondlife.com~~/~~wiki/Viewer_Manifest~~ for ~~more information on packaging the Viewer~~
			To set the revision, set the <tt>revision</tt> environment variable. If that variable is not set, the <tt>indra/cmake/BuildVersion.cmake</tt> file will attempt to get the local revision number from your Mercurial working copy (which will not change for any changes that have not yet been committed), or if that is not found then it will use 0.

	== Updating an Open Source Viewer ==		== Updating an Open Source Viewer ==
Line 35:		Line 37:
	* Clients not based on the Linden viewer code base should ensure that the XMLRPC login connection sends:		* Clients not based on the Linden viewer code base should ensure that the XMLRPC login connection sends:
	** channel = the channel name, e.g. "My Viewer"		** channel = the channel name, e.g. "My Viewer"
	** version = ~~the channel name and~~ a four-part version, e.g. "~~My Viewer~~ 1.2.3.4"		** version = a four-part version, e.g. "1.2.3.4"

	== Linden Lab Updates ==		== Linden Lab Updates ==

Oz Linden: /* Setting a Viewer Identifier for an Open Source Viewer */

2013-03-13T19:28:59Z

Setting a Viewer Identifier for an Open Source Viewer

← Older revision		Revision as of 12:28, 13 March 2013
Line 14:		Line 14:
	* We recommend using the Major and Minor numbers from the most recently merged Linden Lab source code.		* We recommend using the Major and Minor numbers from the most recently merged Linden Lab source code.
	** Linden Lab uses an internal number from our source control system for the Build number.		** Linden Lab uses an internal number from our source control system for the Build number.
	* The 4 numbers together should uniquely identify a version of the sources from which the viewer was built~~, and should lexically sort into the order in which they were built (for example, you should use leading zeros for any level that might be more than one number)~~		* The 4 numbers together should uniquely identify a version of the sources from which the viewer was built.
	3. Set the Channel and Version in the code		3. Set the Channel and Version in the code
	* Edit indra/llcommon/llversionviewer.h		* Edit indra/llcommon/llversionviewer.h

Oz Linden: /* Setting a Viewer Identifier for an Open Source Viewer */

2011-09-05T12:22:43Z

Setting a Viewer Identifier for an Open Source Viewer

← Older revision		Revision as of 05:22, 5 September 2011
Line 4:		Line 4:
	1. Choose a Version Name		1. Choose a Version Name
	* The default Version Name is "Second Life"		* The default Version Name is "Second Life"
	2. Choose a Version Variant. The default variant is "~~Release~~"		2. Choose a Version Variant. The default variant is "Developer"
	* The combination of the Name and Variant should be combined to make the Channel Name.		* The combination of the Name and Variant should be combined to make the Channel Name.
	* The default Channel Name is "Second Life ~~Release~~"		* The default Channel Name is "Second Life Developer"
	* Other standard Linden Lab Channel Names are "Second Life Release ~~Candidate~~" and "Second Life ~~First Look [Feature]~~". Please note that any Channel Name containing "Second Life" is reserved for use by Linden Lab.		* Other standard Linden Lab Channel Names are "Second Life Release" and "Second Life Beta Viewer". Please note that any Channel Name containing "Second Life" is reserved for use by Linden Lab (but if you are building a test version for submission to Linden Lab, there is no need to change this).
	* The Channel Name can be any ASCII string. It should not violate [http://secondlife.com/corporate/brand/trademark/ Linden Lab's trademark policy]. We recommend that the Channel Name be the name of the Open Source Viewer.		* The Channel Name can be any ASCII string. It should not violate [http://secondlife.com/corporate/brand/trademark/ Linden Lab's trademark policy]. We recommend that the Channel Name be the name of the Open Source Viewer.
	2. Choose a Version Number		2. Choose a Version Number

Oz Linden: /* Setting a Viewer Identifier for an Open Source Viewer */

2011-01-24T19:36:03Z

Setting a Viewer Identifier for an Open Source Viewer

← Older revision		Revision as of 12:36, 24 January 2011
Line 14:		Line 14:
	* We recommend using the Major and Minor numbers from the most recently merged Linden Lab source code.		* We recommend using the Major and Minor numbers from the most recently merged Linden Lab source code.
	** Linden Lab uses an internal number from our source control system for the Build number.		** Linden Lab uses an internal number from our source control system for the Build number.
			* The 4 numbers together should uniquely identify a version of the sources from which the viewer was built, and should lexically sort into the order in which they were built (for example, you should use leading zeros for any level that might be more than one number)
	3. Set the Channel and Version in the code		3. Set the Channel and Version in the code
	* Edit indra/llcommon/llversionviewer.h		* Edit indra/llcommon/llversionviewer.h

Oz Linden: /* Setting a Viewer Identifier for an Open Source Viewer */

2011-01-24T19:13:12Z

Setting a Viewer Identifier for an Open Source Viewer

← Older revision		Revision as of 12:13, 24 January 2011
Line 12:		Line 12:
	* The Version Number is in the form Major.Minor.Patch.Build		* The Version Number is in the form Major.Minor.Patch.Build
	* The Version Number can be any four numbers, separated by periods.		* The Version Number can be any four numbers, separated by periods.
	* We recommend using the Major, Minor~~, and Patch~~ numbers from the most recently merged Linden Lab source code.		* We recommend using the Major and Minor numbers from the most recently merged Linden Lab source code.
	** Linden Lab uses an internal number from our source control system for the Build number.		** Linden Lab uses an internal number from our source control system for the Build number.
	3. Set the Channel and Version in the code		3. Set the Channel and Version in the code

Q Linden: /* Setting a Version Identifier for an Open Source Viewer */

2010-02-17T05:16:30Z

Setting a Version Identifier for an Open Source Viewer

← Older revision		Revision as of 22:16, 16 February 2010
Line 1:		Line 1:
	== Setting a ~~Version~~ Identifier for an Open Source Viewer ==		== Setting a Viewer Identifier for an Open Source Viewer ==
	A ~~viewer's Version~~ Identifier is unique to a particular release of a viewer. It is composed of three parts: the Version Name, the Version Variant, and the Version Number. The combination of the Version Name and the Version Variant form the Channel Name.		A Viewer Identifier is unique to a particular release of a viewer. It is composed of three parts: the Version Name, the Version Variant, and the Version Number. The combination of the Version Name and the Version Variant form the Channel Name.

	1. Choose a Version Name		1. Choose a Version Name

Q Linden: /* Setting a Channel and Version for an Open Source Viewer */

2010-02-17T01:35:26Z

Setting a Channel and Version for an Open Source Viewer

← Older revision		Revision as of 18:35, 16 February 2010
Line 1:		Line 1:
	== Setting a ~~Channel and~~ Version for an Open Source Viewer ==		== Setting a Version Identifier for an Open Source Viewer ==
	1. Choose a ~~channel name~~		A viewer's Version Identifier is unique to a particular release of a viewer. It is composed of three parts: the Version Name, the Version Variant, and the Version Number. The combination of the Version Name and the Version Variant form the Channel Name.
	* The default ~~channel name~~ is "Second Life Release"
	* Other standard Linden Lab ~~channel names~~ are "Second Life Release Candidate" and "Second Life First Look [Feature]". Please note that any ~~channel name~~ containing "Second Life" is reserved for use by Linden Lab.		1. Choose a Version Name
	* The ~~channel name~~ can be any ASCII string. It should not violate [http://secondlife.com/corporate/brand/trademark/ Linden Lab's trademark policy]. We recommend that the ~~channel name~~ be the name of the Open Source Viewer.		* The default Version Name is "Second Life"
	2. Choose a ~~version number~~		2. Choose a Version Variant. The default variant is "Release"
	* The ~~version number~~ is in the form Major.Minor.Patch.Build		* The combination of the Name and Variant should be combined to make the Channel Name.
	* The ~~version number~~ can be any four numbers, separated by periods.		* The default Channel Name is "Second Life Release"
			* Other standard Linden Lab Channel Names are "Second Life Release Candidate" and "Second Life First Look [Feature]". Please note that any Channel Name containing "Second Life" is reserved for use by Linden Lab.
			* The Channel Name can be any ASCII string. It should not violate [http://secondlife.com/corporate/brand/trademark/ Linden Lab's trademark policy]. We recommend that the Channel Name be the name of the Open Source Viewer.
			2. Choose a Version Number
			* The Version Number is in the form Major.Minor.Patch.Build
			* The Version Number can be any four numbers, separated by periods.
	* We recommend using the Major, Minor, and Patch numbers from the most recently merged Linden Lab source code.		* We recommend using the Major, Minor, and Patch numbers from the most recently merged Linden Lab source code.
	** Linden Lab uses an internal number from our source control system for the Build number.		** Linden Lab uses an internal number from our source control system for the Build number.
Line 13:		Line 18:
	** Modify LL_CHANNEL with the Channel Name		** Modify LL_CHANNEL with the Channel Name
	** Modify LL_VERSION_BUILD with the appropriate build number		** Modify LL_VERSION_BUILD with the appropriate build number
	* Update the ~~version number~~ in the following files:		* Update the Version Number in the following files:
	** indra/newview/res/newViewRes.rc - ''"FileVersion" and "ProductVersion" in the Version section''		** indra/newview/res/newViewRes.rc - ''"FileVersion" and "ProductVersion" in the Version section''
	** indra/newview/Info-SecondLife.plist - ''CFBundleVersion''		** indra/newview/Info-SecondLife.plist - ''CFBundleVersion''

Q Linden: /* Setting a Channel and Version for an Open Source Viewer */

2010-02-15T18:46:18Z

Setting a Channel and Version for an Open Source Viewer

← Older revision		Revision as of 11:46, 15 February 2010
Line 2:		Line 2:
	1. Choose a channel name		1. Choose a channel name
	* The default channel name is "Second Life Release"		* The default channel name is "Second Life Release"
	* Other Linden Lab channel names are "Second Life Release Candidate" and "Second Life First Look [Feature]"		* Other standard Linden Lab channel names are "Second Life Release Candidate" and "Second Life First Look [Feature]". Please note that any channel name containing "Second Life" is reserved for use by Linden Lab.
	* The channel name can be any ASCII string~~, however we suggest something along~~ the ~~lines~~ of:		* The channel name can be any ASCII string. It should not violate [http://secondlife.com/corporate/brand/trademark/ Linden Lab's trademark policy]. We recommend that the channel name be the name of the Open Source Viewer.
	** "Second Life Open Source ~~[Brand and/or Feature]"~~
	2. Choose a version number		2. Choose a version number
	* The version number is in the form Major.Minor.Patch.Build		* The version number is in the form Major.Minor.Patch.Build
	* The version number can be any four numbers		* The version number can be any four numbers, separated by periods.
	* We recommend using the Major, Minor, and Patch numbers from the most recently merged Linden Lab source code.		* We recommend using the Major, Minor, and Patch numbers from the most recently merged Linden Lab source code.
	* We recommend using a Build number >= 100 to indicate a non Linden Lab version.		** Linden Lab uses an internal number from our source control system for the Build number.
	** Linden Lab uses ~~the Subversion revision~~ number for the ~~build~~ number ~~for non Release / Release Candidate builds~~
	3. Set the Channel and Version in the code		3. Set the Channel and Version in the code
	* Edit indra/llcommon/llversionviewer.h		* Edit indra/llcommon/llversionviewer.h