CTR-SDK Change Log for E-Commerce

Along with changes to the sample demos, the unique ID of the patch sample demo was changed to avoid confusion with demos with a server patch from the CTR-SDK 4 series.
This change actually occurred in CTR-SDK 5.0 but was accidentally omitted from the change log.

Note 39-02: (PATCH) Fixed Bugs in the Sample Demos [Sample Demos].

Fixed a bug where an error was displayed if the timestamp was updated under certain conditions.
In addition, functionality did not match sample demo documentation. This was also fixed.
This change actually occurred in CTR-SDK 5.0 but was accidentally omitted from the change log.

Known Issues with SDK 6.0.0 Sample Demos

None.

■ CTR-SDK Version 5.2.0 Release

(2013/03/26)

Note 38-01:(DevEnv) Added to the data incorporated in patches [SDK]

Patches now also contain e-manual and Download Play child data when created with the CTR-SDK build system.

Known Issues with SDK 5.2.0 Release

None.

■ CTR-SDK Version 5.2.0 System Updater 0.18.5

(2013/03/26)

Note 37-01:(EC) Expanded the scope of data that can be patched [System Updater]

Patches can now also be used to update e-manual and Download Play child data.
For more information, see the Patch Manual: $CTR_SDK/documents/TechnicalNotes/Patch/PatchManual.html.

Known Issues with SDK 5.2.0 System Updater 0.18.5

None.

■ CTR-SDK Version 5.1.1 System Updater 0.18.4

(2013/02/28)

Note 36-01:(EC) Updated the EC applet [System Updater]

The following changes were made to the EC applet.

Corrected the invalid error code that was generated when the EC applet was started and the SD card had no Nintendo3DS folder and no free space.
(009-4079 → 009-4077)
Fixed the problem that the error code was given as -1 when duplicated content was purchased and the returned Result was nn::ec::ResultAppletDuplicateContentIndex.
Fixed the black line that showed at the bottom of icons on the purchase screen in some cases, depending on the scroll position.

Known Issues with SDK 5.1.1 System Updater 0.18.4

None.

■ CTR-SDK Version 5.1.0 Release

(2013/02/07)

Note 35-01: (DevEnv) Fixed a bug that set the default stack size to 16 KB [SDK]

Fixed a bug that set the default stack size to 16 KB when EcApplication.desc was used.

Known Issues with SDK 5.1.0 Release

None.

■ CTR-SDK Version 5.0.0 Sample Demos

(2012/12/18)

Note 34-01:(EC) Revised the Purchase Demo [Sample Demos]

Added a description of the differences in the filters used for purchasing and redeeming items to the comments.
Fixed the error that occurred when you transitioned to the redeem-item process after setting the filter in the purchase-item process.
Added a sample demo for how to handle situations where there is no data title yet at the time when the application sale has started.

Note 34-02:(EC) Revised the Purchase, ContentListUp, and RichPromotion Demos [Sample Demos]

Added a precaution about the mounted numbers of add-on content and metadata to the comments in the source code.

Known Issues with SDK 5.0.0 SampleDemos

None.

■ CTR-SDK Version 4.2.1 Release

(2012/06/27)

Note 33-01:(EC) Changed the Format for Item Download Code [SDK]

Changed the characters that can be used for the item download code from numerals only to alphanumeric characters.
In line with this, the following functions have been revised to convert all lowercase letters that were input in the number to uppercase letters and then send them to the Nintendo eShop server.

ECardInfo::Retrieve
EcApplet::RequestRedeemContentSet
EcApplet::RequestRedeemServiceItem

Known Issues in the SDK 4.2.1 Release

None.

■ CTR-SDK Version 4.2.1 System Updater 0.17.19

(2012/06/27)

Note 32-01: (EC) Changed the EC applet [System Updater]

The following changes were made to the EC applet.

Support for format change of item redemption number
Changed so that age confirmation is performed when adding to the balance

Known Issues in the SDK 4.2.1 System Updater 0.17.19

None.

■ CTR-SDK Version 4.2.1 SampleDemos

(2012/06/27)

Note 31-01: (EC) Format change for item redemption numbers [Sample Demos]

In line with the change to allow alphanumeric characters be used for the item redemption number, revised the number input portion.

Known Issues in the SDK 4.2.1 SampleDemos

None.

■ CTR-SDK Version 4.2.0 Release

(2012/05/29)

Note 30-01: (DevEnv) Improved the search content in the Result search field [SDK]

Of the Result values belonging to nn::ec, made improvements so that the portion of error codes that could not be properly searched for, can now be searched for.

Note 30-02: (EC) Revised the `Server::ConvertPrice` function [SDK]

Fixed a bug that prevented proper conversion of prices that had only one digit after the decimal in the ec::Server::ConvertPrice function.

Note 30-03: (EC) Revised the upper limit for the data title version [SDK]

The reference stated that the upper limit for data title versions was 1023, which was a mistake. This has been changed to the correct value of 4095.

Note 30-04: (PATCH) Added the debug method for the patch update process to the reference [SDK]

Added the debug method for patch update processing using cia.out to the patch manual located in $CTR_SDK/documents/TechnicalNotes/Patch/PatchManual.html.

Known Issues in the SDK 4.2.0 Release

None.

■ CTR-SDK Version 4.2.0 System Updater 0.17.17

(2012/05/29)

Note 29-01: (EC) Fixed a bug that prevented some content from being mounted when the data title was updated [System Updater]

Fixed a bug that prevented some content from being mounted when a data title was updated.

Known Issues in the SDK 4.2.0 System Updater 0.17.17

None.

■ CTR-SDK Version 4.2.0 SampleDemos

(2012/05/29)

Note 28-01: (EC) Revised the `ContentsListUp` demo [Sample Demos]

Fixed a bug that displayed undefined strings when displaying strings in a content file on the screen.

Note 28-02: (EC) Revised the `RichPromotion` demo [Sample Demos]

Fixed a bug that displayed undefined strings when displaying strings in a content file on the screen.
Also, fixed the bug that caused the application to stop when listing up content, depending how screen transition were made.

Note 28-03: (PATCH) Revised the demos [Sample Demos]

In the demos, made changes so that the version is shown to the user.

Known Issues in the SDK 4.2.0 SampleDemos

None.

■ CTR-SDK Version 4.1.0 Release

(2012/05/02)

Note 27-01:(EC) Revised description about DNS server addresses [SDK]

Revised the description about the DNS server address settings required for accessing the development server, referring readers to the latest information at WarioWorld.com.

Note 27-02:(EC) Added patch features [SDK | Sample Demos]

Added features for CTR application patches.

Note 27-03:(EC) Removed support for Taiwan market English data [SDK]

Changed ctr_makeMetaDataContent so it can no longer create Taiwan market English-language data.

Note 27-04:(EC) Added description about creating/using multiple data titles [SDK]

Added a description about the creation and use of multiple data titles.

Note 27-05:(EC) Added references for adding/updating add-on content [SDK]

Added text about adding and updating add-on content to the following API references and to the Developing Applications That Support Add-On Content document.

ContentSetCatalog::Retrieve
ContentSetGroupCatalog::Retrieve
ServiceItemCatalog::Retrieve
ECardItemCatalog::Retrieve

Known Issues in the SDK 4.1.0 Release

None.

■ CTR-SDK Version 4.1.0 System Updater 0.17.6

(2012/05/02)

Note 26-01:(System Settings) Added feature for displaying patches (data updates) on the Add-On Content Management screen [System Updater]

Patches (data updates) are now displayed on the Add-On Content Management screen.

Known Issues in the SDK 4.1.0 System Updater 0.17.6

None.

■ CTR-SDK Version 4.1.0 Sample Demos

(2012/05/02)

Note 25-01:(EC) Added demo of providing sale information to users about add-on content in an original, application-specific mechanism [Sample Demos]

Added the RichPromotion demo, showing use of the EC library to provide sale information to users about add-on content in an original, application-specific mechanism.
This demo is also a reference for when creating applications that involve the purchase and management of add-on content and handle numerous data titles with different variations.

Note 25-02:(EC) Added support in sample demos for North America, Europe, Korea and Taiwan regions [Sample Demos]

The EC-related sample demos now support running on the systems in the North America, Europe, Korea and Taiwan regions.
Depending on the market region, there are restrictions on the country settings in the System Settings.
See the sample demo documentation for more information.

Note 25-03:(EC) Revised so that the data title icon index now starts from 1 [Sample Demos]

In the XML of content created by IMAS, the icon index starts from 1.
In line with this, the icon index for DataTitle has been revised to also start from 1.

Note 25-04:(EC) Added comment about buffer usage and revised the buffer size [Sample Demos]

Added a comment prompting that an appropriate value be set for the buffer size passed to functions like nn::ec::ContentSetCatalog and nn::ec::ECardCatalog.
In line with this, also revised the buffer size.

Note 25-05:(EC) Added patch features [SDK | Sample Demos]

Added features for CTR application patches.

Note 25-06:(EC) Revisions to use correct item code format [Sample Demos]

The following revisions were made relating to the item codes in the EC demos:

In the Purchase demo, changed the data title being purchased.
This data title defines item code in the correct format.
In the ServiceItem demo, changed the service item being purchased.
This service item defines item code in the correct format.
The server-side demo of the ServiceItem demo was revised to handle item code in the correct format.

Note 25-07:(EC) Revised error handling when mounting add-on content [Sample Demos]

When errors occur when add-on content is being mounted, ContentListUp demo now shows the method for error handling.

Known Issues in the SDK 4.1.0 Sample Demos

None.

■ CTR-SDK Version 4.0.2 System Updater 0.17.4

(2012/03/30)

Note 24-01: (EC) Fixed problem of `ec::Server::GetDateTime` returning lost time [SDK | System Updater]

ec::Server::GetDateTime was late by the amount of time the system had been put to sleep. That problem was fixed.
With this bug fix, communication with the external server happens on every call to GetDateTime.
This was actually changed in CTR-SDK 4.0.2 but was accidentally omitted from the Change Log.

Known Issues in the SDK 4.0.2 System Updater 0.17.4

None.

■ CTR-SDK Version 4.0.2 Release

(2012/03/19)

Note 23-01: (EC) Added function for creating filters for specified items [SDK]

Added a function for creating filters that can be used to specify and search for certain items from catalogs.

Known Issues in the SDK 4.0.2 Release

None.

■ CTR-SDK Version 4.0.2 System Updater 0.17.3

(2012/03/19)

Note 22-01: (EC) Fixed bug that returned invalid `ResultAppletSdBroken` when downloading [System Updater]

During downloading, ResultAppletSdBroken would be returned if some error happened to arise. That problem was fixed.
This change was actually included in System Updater 0.17.1 supporting CTR-SDK 4.0, but was accidentally omitted from the Change Log.

Known Issues in the SDK 4.0.2 System Updater 0.17.3

None.

■ CTR-SDK Version 4.0.1 System Updater 0.17.2

(2012/02/29)

Note 21-01: (EC) Fixed bug when updating data titles [System Updater]

Fixed a bug that prevented proper determination of content updates when updating data titles.

Known Issues in the SDK 4.0.1 System Updater 0.17.2

None.

■ CTR-SDK Version 4.0.0 Release

(2012/02/20)

Note 20-01: (EC) Made changes so that metadata can also be created for Asian markets [SDK]

Supported creating metadata even in the Asian regions (China, Korea, Taiwan) using ctr_makeMetaDataContent.

Note 20-02: (EC) Added a PIN code input feature [SDK | System Updater]

This is the PIN code to release parental controls that was required to be input from traditional applications, and changes were made so that the EC applet provides an input screen as needed.
See the reference for the EcApplet class for details.
In line with this, the arguments of traditional functions that required input of the PIN code, such as EcApplet::RequestPurchaseContentSet, have been changed.

Note 20-03: (EC) Added features to purchase multiple items in batch [SDK | System Updater]

Added features to allow batch purchase and download of multiple content sets or service items.
See the references for the EcApplet::RequestPurchaseContentSets and EcApplet::RequestPurchaseServiceItems functions for details.

Note 20-04: (EC) Revised the method to handle errors surrounding the add-on content archive [SDK]

Made changes to recommend using error display that uses the error code for special errors that normally do not occur, as the error handling for the add-on content archive.
See $CTR_SDK/documents/api_private/ECommerceKit/nn/fs/briefing/aboutFsErrorHandling.html for details.

Known Issues in the SDK 4.0.0 Release

None.

■ CTR-SDK Version 4.0.0 System Updater 0.17.1

(2012/02/20)

Note 19-01: (EC) Fixed a bug that caused all downloaded content to be deleted when add-on content on the server was updated or added [System Updater]

Fixed a bug that caused all downloaded content to be deleted when add-on content on the server was updated or added.
There is no need to handle this on the application-side.

Note 19-02: (EC) Added a PIN code input feature [SDK | System Updater]

Note 19-03: (EC) Added features to purchase multiple items in batch [SDK | System Updater]

Note 19-04: (EC) Fixed the progress display when updating add-on content [System Updater]

Fixed a bug that prevented the EC applet progress display from being displayed correctly when updating add-on content.

Known Issues in the SDK 4.0.0 System Updater 0.17.1

None.

■ CTR-SDK Version 4.0.0 Sample Demos

(2012/02/20)

Note 18-01: (EC) Made revisions so that when purchasing add-on content, the application does not request that input of the parental control PIN code [Sample Demos]

Added a PIN code input feature to the EC applet when use of Nintendo eShop has been restricted with parental controls.
In line with this, deleted the PIN code input feature that was used in the Purchase and ServiceItem demos.

Known Issues in the SDK 4.0.0 Sample Demos

None.

■ CTR-SDK Version 3.3.1 Release

(2012/01/25)

Note 17-01: (DevEnv) Changed build rules for add-on content to allow specification of company code [SDK]

Changed the build rules for add-on content to allow the specification of a company code.

Known Issues in the SDK 3.3.1 Release

None.

■ CTR-SDK Version 3.3.0 Release

(2011/12/22)

Note 16-01: (EC) Regarding use of `EcApplication.desc` [SDK]

To use the EC library, it is necessary to create a binary by specifying EcApplication.desc in ctr_makerom. This fact was added to Readme-ECommerceKit.html and the API reference.

Note 16-02: (EC) Fixed the `nn::ec::Initialize` function bug [SDK]

Fixed a bug that caused a fatal error when the nn::ec::Initialize function was called multiple times.
Nothing is done with the second and subsequent calls to the nn::ec::Initialize function.

Note 16-03: (EC) Enhanced the regional language check when creating metadata [SDK]

Fixed the problem that allowed metadata to be created successfully even with an invalid regional language (JPN_en, etc.) when creating metadata using ctr_makeMetaDataContent.

Known Issues in the SDK 3.3.0 Release

None.

■ CTR-SDK Version 3.3.0 Sample Demos

(2011/12/22)

Note 15-01: (EC) Revised the `ContentsListUp` demo [Sample Demos]

Made the following revisions to the ec/ContentsListUp demo.

Added a process to determine whether a session is valid to error handling
Deleted SceneInitializeSession
Made documentation revisions

Note 15-02: (EC) Revised the `Purchase` demos [Sample Demos]

Made the following revisions to the ec/Purchase demo.

Added a process to determine whether a session is valid to error handling
Revised the process for when overflow occurred in the string encoding process
Added process to verify string length of the filter when setting an item filter
Fixed bug related to access outside the region
Made changes so ac::Connect is performed by each tool rather than with SceneConnect
Made changes so that there is a transition to SceneConnect when there is an error that should be handled by the application or when there is an implementation error

Note 15-03: (EC) Added demo to create add-on content directly using tools [Sample Demos]

Added the ec/DataTitleRaw demo to create add-on content by directly using Windows tools such as makerom or makecia.

Known Issues in the SDK 3.3.0 Sample Demos

With the Purchase demo, the page number that is referenced when purchasing an item is also referenced when using the item download code.
This can be avoided by switching to the first page after purchasing an item, quitting, and then using the download code.

■ CTR-SDK Version 3.2.5 Release

(2011/11/25)

Note 14-01: (EC) Revised size calculation [SDK]

Fixed error in calculation of the region sizes returned by the following interfaces.

DataTitle::CalculateNumRequiredBlocksOf
ContentInfo::GetOccupiedSize
ContentInfo::GetNumOccupiedBlocks
ContentSet::CalculateNumRequiredBlocks

Note 14-02: Restricted number of instances of add-on content that could be mounted at one time, and number of `MetaDataReader` instances. [SDK]

Mounting add-on content and creating a valid instance of MetaDataReader consumes a resource that is shared by the system as a whole.
Added information that no more than two instances of add-on content should be mounted at one time, and that no more than one valid instance of MetaDataReader should exist at one time.

Known Issues in the SDK 3.2.5 Release

None.

■ CTR-SDK Version 3.2.4 Release

(2011/11/11)

Note 13-01: (EC) Removed the `ECardCatalogFilter::OrderByAttribute` function

Removed OrderByAttribute function because it is not supported by ECardCatalog.

Note 13-02: (EC) Revised the `GetAccountId` function [SDK]

Fixed bug where the GetAccountId function returned nim::ResultAccountNotCreated when it should have returned ec::ResultAccountNotCreated.

Note 13-03: (EC) Removed `ResultAcNotConnected` and added `ResultAcNotConnectedError` [SDK]

In CTR-SDK 3.2.2, we removed ResultAcNotConnectedError and added ResultAcNotConnected, but the situation in which this result occurs changed again so that it is necessary to display an error code. We have therefore removed ResultAcNotConnected and added ResultAcNotConnectedError back.

Note 13-04: (EC) Added `ResultNewSessionRequired` [SDK]

There were some cases where if a call to the applet failed (for example, due to network disconnection), subsequent calls to functions of classes holding Session objects would fail, even if the Session object was valid.
Changed these functions to return ResultNewSessionRequired in these cases.

Note 13-05: (EC) Revised the `Server::ConvertPrice` function [SDK]

Fixed bug where the display prices obtained from Server::ConvertPrice did not include the decimal portion (".00") for currencies displaying decimal places, such as US dollars.

Note 13-06: (EC) Removed the `ServiceItemCatalogFilter::OrderByAttribute` function [SDK]

Removed the OrderByAttribute function because it is not supported by ServiceItemCatalog.

Note 13-07: (EC) Revised the documentation [SDK]

Revised the EC documentation as follows.

Revised the Readme-ECommerceKit.html package structure.
Added note about applet processing after calling the EcApplet::Preload function.
Added information that ECardInfo::Retrieve returns ResultECardInvalidIdError when the download-voucher ID that was entered does not exist.
Revised return values of API functions calling ECApplet applets.

This was actually changed in CTR-SDK 3.2.3 but was accidentally omitted from the change log.

Known Issues in the SDK 3.2.4 Release

None.

■ CTR-SDK Version 3.2.4 System Updater 0.16.12

(2011/11/11)

Note 12-01: (EC) Fixed bug where value calculated by the `nn::ec::DataTitle::CalculateRequiredSizeOf` function was too small [System Updater]

Fixed error in calculation performed by the nn::ec::DataTitle::CalculateRequiredSizeOf function, where the value could be too small depending on the number of pieces of content defined in add-on content.

Known Issues in the SDK 3.2.4 System Updater 0.16.12

None.

■ CTR-SDK Version 3.2.3 Release

(2011/11/04)

Note 11-01: (EC) Removed declaration of `HasMountedAddOnContent` function [SDK]

The HasMountedAddOnContent function was removed in CTR-SDK 3.2, but the header declaration remained, and documentation of this function remained in the reference. These were removed in this release.

Note 11-02: (EC) Revised handling of add-on content versions [SDK]

Removed major and minor versions from add-on content versions, merging them into a single value called the "data title version."
Past versions of the build tools will no longer be able to build add-on content, so revise your code making reference to the sample demos.

Note 11-03: (EC) Made micro-versions of add-on content optional [SDK]

In past releases, it was mandatory to specify a micro-version of add-on content, even though they were not needed by add-on content developers. This was changed to optional in this release.

Known Issues in the SDK 3.2.3 Release

None.

■ CTR-SDK Version 3.2.3 System Updater 0.16.9

(2011/11/04)

Note 10-01: (EC) Fixed bug where correct content information could not be obtained when the size was larger than 1,024 [System Updater]

Fixed a bug where the ContentInfo::IsOwned function would fail to return the correct Boolean value when information about content with a size greater than 1,024 was obtained.

Note 10-02: (EC) Data title purchase and update progress now displayed [System Updater]

Revised the process to download new data titles and updates of existing ones so that it now displays detailed progress.

Note 10-03: (EC) Added check for whether local data title version is newer [System Updater]

Added the nn::ec::CTR::ResultAppletInvalidVersion function, and revised test to check whether the local version is newer than the version on the server. This is possible in certain circumstances, such as a developer environment.
This state will generally never occur in a production environment.

Note 10-04: (EC) Revised kit so that the same `ReferenceId` cannot be used to purchase different service items [System Updater]

Once a given ReferenceId has been used to purchase a service, it will no longer be possible to enter it into a shop service.
Starting with this version, an error will appear before purchase, preventing such purchases from moving forward.

Known Issues in the SDK 3.2.3 System Updater 0.16.9

None.

■ CTR-SDK Version 3.2.3 Sample Demos

(2011/11/04)

Note 9-01: (EC) Support for blocking of HOME Button while preloading EC applet [Sample Demos]

It is no longer possible to navigate to the HOME Menu while preloading the EC applet.

Note 9-02: (EC) Removed micro-versions from ec/DataTitle [Sample Demos]

Removed micro-versions from add-on content, because it is not necessary to specify them.

Note 9-03: (EC) Revised ec/DataTitle versions [Sample Demos]

Removed major and minor versions from add-on content data titles. Data titles now use a single unified version system. The DataTitle demo was modified to support this change.

Known Issues in the SDK 3.2.3 Sample Demos

None.

■ CTR-SDK Version 3.2.2 Release

(2011/10/28)

Note 8-01: (EC) Revised `ContentSetGroupCatalog::Retrieve` function [SDK]

Fixed bug where the Session in use would not automatically be invalidated if the ContentSetGroupCatalog::Retrieve function returned a ResultError object whose ResultError::RequiresNewSession function returned true.

Note 8-02: (EC) Fixed bug where `DataTitle::DeleteContents` returned an unexpected result [SDK | System Updater]

Fixed a bug where DataTitle::DeleteContents would return an unexpected result if the index of content that did not exist in the title or if an index of 0 was specified.

Note 8-03: (EC) Fixed bug where the `ECardInfo::Retrieve` function succeeded even when the session was invalid [SDK]

Fixed bug where the ECardInfo::Retrieve function would succeed even when the session was invalid.

Note 8-04: (EC) Added feature to `EcRightTool` to delete licenses [SDK]

Modified EcRightTool to be able to delete locally imported data-title licenses.

Note 8-05: (EC) Removed `ResultAcNotConnectedError` and added `ResultAcNotConnected` [SDK]

Removed ResultAcNotConnectedError defined as a result when an automatic connection was disconnected, and added ResultAcNotConnected in its place.
It is consequently no longer necessary to display an error code when this result is returned.

Note 8-06: (EC) Fixed bug where error type of `ResultError` was not determined correctly [SDK]

Fixed bug where the ResultError::RequiresNewSession and ResultError::IndicatesServiceNotAvailable functions did not determine the error correctly.

Note 8-07: (EC) Added result for when the catalog buffer is too small [SDK | System Updater]

Added a ResultOutOfCatalogMemory result for when the buffer passed to the ContentSetCatalog or other catalog is too small.
The ResultOutOfCatalogMemory result is returned when it is possible to determine that the buffer is too small from local information only.
In contrast, the ResultOutOfCatalogMemoryError result is returned when the response from the server could not be stored. The error code must be displayed in the error and EULA applets.

Known Issues in the SDK 3.2.2 Release

None.

■ CTR-SDK Version 3.2.2 System Updater 0.16.8

(2011/10/28)

Note 7-01: (EC) Fixed bug where `ContentInfo::IsOnDevice` did not return correct results [System Updater]

Fixed bug where ContentInfo::IsOnDevice returned an incorrect value when a portion of content was downloaded.

Note 7-02: (EC) Fixed bug where `DataTitle::DeleteContents` returned an unexpected result [SDK | System Updater]

Fixed a bug where DataTitle::DeleteContents would return an unexpected result if the index of content that did not exist in the title or if an index of 0 was specified.

Note 7-03: (EC) Added result for when the catalog buffer is too small [SDK | System Updater]

Known Issues in the SDK 3.2.2 System Updater 0.16.8

None.

■ CTR-SDK Version 3.2.1 Release

(2011/10/21)

Note 6-01: (EC) Revised error-type determination by `ResultError` [SDK]

Changed RequiresNewSession function of ResultError object wrapping ResultFsMediaWriteProtectedError to return true.
Changed IndicatesServiceNotAvailable function of ResultError object wrapping ResultInfraNeedsUpdateError to return true.

Note 6-02: (EC) Revised determination of whether SD cards are write protected [SDK]

There were cases when ResultFsMediaAccessFailedError was returned if the process could not proceed due to the SD card being write protected. Revised this so that ResultFsMediaWriteProtectedError is returned instead.

Note 6-03: (EC) Revised `ec::ServiceItemCatalog::Retrieve` function [SDK]

Fixed issue where ec::ServiceItemCatalog::Retrieve function did not check whether the service title was included in the session.

Note 6-04: (EC) Support for North American and European regions [SDK | System Updater]

System Updater was modified to include EC applets for the North American and European regions.
EcCountryTool was also added to reflect the country setting of the system in the account on the eShop server.
Added notes on changing region or country settings to "aboutAocAppDevelopment.html".

Known Issues in the SDK 3.2.1 Release

None.

■ CTR-SDK Version 3.2.1 System Updater 0.16.7

(2011/10/21)

Note 5-01: (EC) Support for North American and European regions [SDK | System Updater]

Known Issues in the SDK 3.2.1 System Updater 0.16.7

None.

■ CTR-SDK Version 3.2.1 Sample Demos

(2011/10/21)

Note 4-01: (EC) Error handling for add-on content mounting and file operations [Sample Demos]

Changed handling of file-system errors when using ec/ContentsListUp to mount add-on content or perform file operations on it.
Refer to this error-handling documentation when using add-on content.

Known Issues in the SDK 3.2.1 Sample Demos

None.

■ CTR-SDK Version 3.2.0 Release

(2011/10/14)

Note 3-01: (EC) Removed `HasMountedAddOnContent` function [SDK]

Removed HasMountedAddOnContent function, because API functions that must not be called when add-on content is mounted were revised so that they return an error if called when add-on content is being mounted.

Note 3-02: (EC) Fixed bug where `SELECTION_FILTER_PURCHASABLE` specification was ignored [SDK]

Fixed bug where nn::ec::ContentSetCatalogFilter::SetSelectionFilter function ignored specification of SELECTION_FILTER_PURCHASABLE.

Note 3-03: (EC) Invalidation of `Session` objects [SDK]

Changed classes holding Session objects to automatically invalidate the Session object if a member function returns an error stating that Session initialization is required.
Also added a Session::Invalidate function to explicitly invalidate Session objects.

Note 3-04: (EC) Function to obtain account ID [SDK | System Updater]

Added GetAccountId function to API to obtain the account ID.

Note 3-05: (EC) Downloading and deletion while content is mounted are prohibited [SDK | System Updater]

Changed API so that an error is returned when trying to download content to or delete content from a data title while content from that same data title is mounted.

Note 3-06: (EC) Added function to get service-item licenses [SDK | System Updater]

Added a function to the API for getting the license of a service item.
See the ServiceTitle reference for details.

Note 3-07: (EC) Added functions to search for service items [SDK | System Updater]

Added functions to search for service items to the API.
See the references for ServiceItem, ServiceItemCatalogFilter, and ServiceItemCatalog for details.

Note 3-08: (EC) Revised the documentation [SDK]

Added explanation that data titles are .cia files in the Developing Applications That Support Add-On Content documentation ("aboutEcAppDevelopment.html").
Added explanation that building samples creates .cia files.
Added description of samples to serve as reference and added descriptions about sample documentation.

Note 3-09: (EC) Added a function for getting number of blocks [SDK]

Added a function to get the number of blocks occupied by content, and a function for getting the number of free blocks needed to import content.
See the API references for ContentInfo::GetNumOccupiedBlocks, ContentSet::CalculateNumRequiredBlocks, and DataTitle::CalculateNumRequiredBlocks for details.

Note 3-10: (EC) Support for Parental Controls [SDK]

Changed functions for purchasing items to return an error if Parental Controls restrict the use of Nintendo eShop, and a valid PIN code is not passed to the function.

Note 3-11: (EC) Determine whether a data title has never been initialized [SDK]

Modified the DataTitle::Initialize function to return ResultDataTitleNotOwned if called on a data title that has never been initialized.

Note 3-12: (EC) Added functions to find items that can be redeemed for a download voucher [SDK]

Added functions to find items that can be redeemed for a download voucher.
See the references for the ECardInfo, ECardItem, and ECardCatalog classes for details.

Note 3-13: (EC) Changed specifications for required content [SDK]

Changed specifications for required content.
See the ctr_MakeMataDataContent reference for details on this change.

Note 3-14: (EC) Added function to create required-attribute names [SDK]

Added AttributeName::MakeNecessary function for creating attribute names for required attributes.

Known Issues in the SDK 3.2.0 Release

None.

■ CTR-SDK Version 3.2.0 System Updater 0.16.6

(2011/10/14)

Note 2-01: (EC) Function to obtain account ID [SDK | System Updater]

Added GetAccountId function to API to obtain the account ID.

Note 2-02: (EC) Downloading and deletion while content is mounted are prohibited [SDK | System Updater]

Changed API so that an error is returned when trying to download content to or delete content from a data title while content from that same data title is mounted.

Note 2-03: (EC) Added function to get service-item licenses [SDK | System Updater]

Added a function to the API for getting the license of a service item.
See the ServiceTitle reference for details.

Note 2-04: (EC) Added functions to search for service items [SDK | System Updater]

Added functions to search for service items to the API.
See the references for ServiceItem, ServiceItemCatalogFilter, and ServiceItemCatalog for details.

Note 2-05: (EC) Revised size calculation for downloading and updating add-on content [System Updater]

Revised the method for calculating size when downloading new add-on content, downloading content, and updating add-on content.

Note 2-06: (EC) Changed location of add-on content files [System Updater]

The location of related files when importing add-on content was changed.
This change makes add-on content that has already been imported unusable.
If you are using System Updater 0.16.6 for CTR-SDK 3.2, delete the add-on content from the Dev Menu, and then import it again.

Now sets UniqueID of application correctly.
No longer monitors for removal/insertion of SD card from Title screen.
Fixed bug where navigation to next page and other actions were possible when there was no purchased content.
Fixed bug where display was incorrect when there were four pieces of purchased add-on content.
The content size is now displayed in blocks.

Note 1-02: (EC) Revised demo for purchasing add-on content [Sample Demos]

Made the following revisions to the ec/Purchase demo.

Items are now obtained four at a time, because items were not displayed due to lack of memory.
Before, the determination of whether an item could be purchased was made after obtaining only one piece of content from the item. This was changed so that now, all content is obtained before making the determination.
Added feature to filter items by attribute.
Added scene of adding to account balance.
Attributes are now specified based on the language obtained from the required content.

Known Issues in the SDK 3.2.0 Sample Demos

None.