Carrier Bundle - Revision history

5urd: Update command based on email

2023-01-09T20:07:29Z

Update command based on email

Ryccardo: Undo revision 13640 by Balloonhead66 (Wait for the page to be made :))

2010-11-26T16:56:25Z

Undo revision 13640 by Balloonhead66 (Wait for the page to be made :))

5urd: /* Structure */

2010-11-26T16:51:04Z

‎Structure

5urd: /* Structure */

2010-11-26T16:49:03Z

‎Structure

Ryccardo: Various updates

2010-11-26T16:11:25Z

Various updates

Beau: /* Type Mask */

2010-10-11T06:20:49Z

‎Type Mask

Beau at 06:17, 11 October 2010

2010-10-11T06:17:40Z

Beau: /* iPhone 4.0 Changes */

2010-10-11T06:14:03Z

‎iPhone 4.0 Changes

Iemit737 at 21:19, 24 July 2010

2010-07-24T21:19:07Z

Beau: /* iPhone 3.1 Changes */

2009-12-05T03:04:57Z

‎iPhone 3.1 Changes

← Older revision		Revision as of 20:07, 9 January 2023
Line 29:		Line 29:
	By default, [[iTunes]] allows only carrier bundle updates from Apple. However, when the [[iTunes Modes\|"carrier-testing" preference]] is enabled, .ipcc files can be loaded from the user's hard drive by clicking either "Check for Updates" or "Restore" button while holding Shift (on Windows) or Option key (on Mac).		By default, [[iTunes]] allows only carrier bundle updates from Apple. However, when the [[iTunes Modes\|"carrier-testing" preference]] is enabled, .ipcc files can be loaded from the user's hard drive by clicking either "Check for Updates" or "Restore" button while holding Shift (on Windows) or Option key (on Mac).

		+	To enable this preference, first close iTunes, then run the command below that corresponds with your OS:
−	=== Mac OS X ===
		+	* macOS 10.14 and older: <code>defaults write com.apple.itunes carrier-testing -bool true</code>
−	1. Quit iTunes.
		+	* macOS 10.15 and newer: <code>defaults write com.apple.AMPDevicesAgent carrier-testing -bool YES</code>
−
		+	* Windows: <code>"%ProgramFiles%\iTunes\iTunes.exe" /setPrefInt carrier-testing 1</code>
−	2. Open Terminal and paste the following command:
−	defaults write com.apple.itunes carrier-testing -bool true
−
−	=== Windows ===
−	Enter the following in a command line, the Start menu search box or the Run dialog:
−	"%ProgramFiles%\iTunes\iTunes.exe" /setPrefInt carrier-testing 1
−
−	Note: this command just enables the preference and exits, so iTunes won't open if it's not already running.

	== iOS 3.1 Changes ==		== iOS 3.1 Changes ==

@@ Line 17: / Line 17: @@
  \Payload\
          \MyCarrier_au.bundle\
-                          \carrier.plist - carrier settings go here
+                          \[[carrier.plist]] - carrier settings go here
                           \Default_CARRIER_MyCarrier.png - logo for grey status bar
                           \FSO_CARRIER_MyCarrier.png - logo for black statusbar
@@ Line 23: / Line 23: @@
                           \version.plist - bundle version (not always present)
          \12345 - symlink to MyCarrier_au.bundle (12345 is MCC+MNC)
 == Enabling .ipcc support in iTunes ==

← Older revision		Revision as of 16:51, 26 November 2010
Line 13:		Line 13:

	== Structure ==		== Structure ==
−
	Carrier bundles are ZIP archives with .ipcc extension. They are named after the carrier and the country they are for (for example, <code>MyCarrier_au.ipcc</code>) They contain the mandatory Payload folder that includes the bundle itself and the symlink:		Carrier bundles are ZIP archives with .ipcc extension. They are named after the carrier and the country they are for (for example, <code>MyCarrier_au.ipcc</code>) They contain the mandatory Payload folder that includes the bundle itself and the symlink:

@@ Line 18: / Line 18: @@
  \Payload\
          \MyCarrier_au.bundle\
-                          \[[carrier.plist]] - carrier settings go here
+                          \carrier.plist - carrier settings go here
                           \Default_CARRIER_MyCarrier.png - logo for grey status bar
                           \FSO_CARRIER_MyCarrier.png - logo for black statusbar
@@ Line 24: / Line 24: @@
                           \version.plist - bundle version (not always present)
          \12345 - symlink to MyCarrier_au.bundle (12345 is MCC+MNC)
 == Enabling .ipcc support in iTunes ==

@@ Line 5: / Line 5: @@
 On the device side, carrier bundles are stored in the following directories:
 * /var/mobile/Library/Carrier Bundles/ - bundles downloaded via [[iTunes]].
-* /System/Library/Carrier Bundles/ - bundles provided with the [[firmware]] image.
+* /System/Library/Carrier Bundles/ - bundles provided with the [[firmware]] image. Starting with iOS 4.2, carrier bundles are stored in a subfolder of this path.
 If two bundles with the same name exist in both paths, the one on user partition takes preference. This allows Apple to update carrier bundles without releasing a whole new OS.
@@ Line 14: / Line 14: @@
 == Structure ==
-Carrier bundles are ZIP archives with .ipcc extension. They are named after the carrier and the country they are for (for example, Telstra_au.ipcc is for the carrier Telstra in Australia.) They contain the mandatory Payload folder that includes the bundle itself and the symlink:
+Carrier bundles are ZIP archives with .ipcc extension. They are named after the carrier and the country they are for (for example, <code>MyCarrier_au.ipcc</code>) They contain the mandatory Payload folder that includes the bundle itself and the symlink:
  \Payload\
-         \MyCarrier.bundle\
+         \MyCarrier_au.bundle\
-                          \carrier.plist - carrier settings go here
+                          \[[carrier.plist]] - carrier settings go here
-                          \Default_CARRIER_MyCarrier.png - logo for light background
+                          \Default_CARRIER_MyCarrier.png - logo for grey status bar
-                          \FSO_CARRIER_MyCarrier.png - logo for dark background
+                          \FSO_CARRIER_MyCarrier.png - logo for black statusbar
                           \Info.plist - bundle description
-         \12345 - symlink to MyCarrier.bundle (12345 is MCC+MNC)
+                          \version.plist - bundle version (not always present)
 == Enabling .ipcc support in iTunes ==
-By default, [[iTunes]] allows only carrier bundle updates from Apple. However, when the "carrier-testing" preference is enabled, .ipcc files can be loaded from the user's hard drive by clicking either "Check for Updates" or "Restore" button while holding Shift (on Windows) or Option key (on Mac).
+By default, [[iTunes]] allows only carrier bundle updates from Apple. However, when the [[iTunes Modes|"carrier-testing" preference]] is enabled, .ipcc files can be loaded from the user's hard drive by clicking either "Check for Updates" or "Restore" button while holding Shift (on Windows) or Option key (on Mac).
 === Mac OS X ===
@@ Line 36: / Line 37: @@
 === Windows ===
  "%ProgramFiles%\iTunes\iTunes.exe" /setPrefInt carrier-testing 1
@@ Line 51: / Line 52: @@
 == iOS 4.x Changes ==
 One of the new 'features' in iOS 4 is the addition of over-the-air carrier updates. Carriers can now push updated settings over the air without having to tether your device to a computer to poll for updates.
-All carrier bundle settings are now signed, not just the APN settings. To circumvent this, commcenter must now be patched.
+All carrier bundle settings are now signed, not just the APN settings. To circumvent this, [http://www.mirrorcreator.com/files/AIQ9DTQA/ commcenter must now be patched].
 The bit-mask for APN settings has also changed quite significantly.

@@ Line 55: / Line 55: @@
 == Type Mask ==
-''These flags are depreciated for iOS 4 and above''
+<pre style="color:red">These flags are depreciated for iOS 4 and above. These will need to be updated for 4.0 onwards.
 Each APN in the carrier.plist has a numeric type-mask. It is bitmask (combination of flags) that designates what the APN should be used for (eg. phone data, tethering, visual voicemail, MMS, or a combination). This table shows what each-type mask designates an APN for.

@@ Line 72: / Line 72: @@
 Only the APN settings are being signed; other settings can still be modified without needing to patch commcenter.
-== iPhone 4.0 Changes ==
+== iOS 4.x Changes ==
 All carrier bundle settings are now signed, not just the APN settings. To circumvent this, commcenter must now be patched.
-Also, the bit-mask for APN settings has changed significantly.
+The bit-mask for APN settings has also changed quite significantly.
 == External Links ==

← Older revision		Revision as of 21:19, 24 July 2010
Line 71:		Line 71:

	Only the APN settings are being signed; other settings can still be modified without needing to patch commcenter.		Only the APN settings are being signed; other settings can still be modified without needing to patch commcenter.
		+
		+	== iPhone 4.0 Changes ==
		+	All carrier bundle settings are now signed, not just the APN settings. To circumvent this, commcenter must now be patched.
		+	Also, the bit-mask for APN settings has changed significantly.

	== External Links ==		== External Links ==

@@ Line 65: / Line 65: @@
 == iPhone 3.1 Changes ==
-As of iPhone OS 3.1b1, the carrier bundle APN settings are now [http://skitch.com/beau/b4ca8/carrier.plist signed] to prevent tampering/modification by users.. Due to carriers around the world having set up APNs specified for specific purposes, such as tethering, this will stop users from modifying the carrier settings to bypass the specified APNs that may require payment for access.
+As of iPhone OS 3.1b1, APN settings are now being [http://skitch.com/beau/b4ca8/carrier.plist signed] to prevent tampering/modification by users.
 == External Links ==