web
You’re offline. This is a read only version of the page.
close
Skip to main content

Notifications

Announcements

No record found.

Community site session details

Community site session details

Session Id :
Supply chain | Supply Chain Management, Commerce
Unanswered

What does 'Retail SDK Pkgs/libraries and samples available in the Retail SDK are deprecated in application release 10.0.21' mean?

(0) ShareShare
ReportReport
Posted on by 1,457

I upgraded my one Dev box from v10.0.20 to v10.0.22 and after putting the retailSDK for v10.0.22 in place and built the project, I got this message:

2> Retail SDK Pkgs/libraries and samples available in the Retail SDK are deprecated in application release 10.0.21.
2> Use the packages from public repository and refer samples from the public GitHub repository.
2> https://docs.microsoft.com/en-us/dynamics365/commerce/dev-itpro/retail-sdk/sdk-github

I have noticed while building it, it checked to see if certain prerequisites were installed and indicated that it was. It did this even though I had the parameter "/p:CheckVSDependencies" set to False, which I had to do for v10.0.20 because the MSBuild failed even though all prerequisites were in place.

So what Pkgs/Libraries  were deprecated in V10.0.22?

I have the same question (0)
  • ToddB Profile Picture
    on at

    Hi Retha,

    That’s just a standard message that we started putting in because of the eventual migration to the new SDK.  The link you have in there discusses it in pretty good detail and then this series of webinars are helpful:

    learning.eventbuilder.com/FY22TechTalkCommerceSeries

    First one is here:  community.dynamics.com/.../commerce-extensions-part-1-overview-of-the-crt-and-pos-extension-with-the-new-sealed-sdk-november-3-2021

    Session 2 was just yesterday so it should be up shortly:  community.dynamics.com/.../techtalks

    Per the doc link, previously, the reference libraries/DLLS and samples were all available in the dev environment from LCS.

    As of 10.0.21, the samples and reference libraries/DLLS should be obtained from the GitHub repositories.

    Download Retail SDK samples and reference packages from GitHub and NuGet - Commerce | Dynamics 365 | Microsoft Docs

    The repos/feeds listed in the link are what customers should be updating their extension projects to be using going forward.

    No libraries are being ‘deprecated’, but rather the location and distribution process for them is being changed.

  • Retha Profile Picture
    1,457 on at

    Thanks for the links Todd.

    I have a few questions.

    1) First when  will we have to switch? I know RetailSDK will be deprecated October 2022.

    However it doesn't sound like everything is ready om Microsoft's end. For example ISV packages and CloudPOS.

    We are using CloudPOS and we have our own custom as well as custom from ISVs.

    2) We do not use GIT currently as our source control. We use TFS (DevOps). It works best for us in that we can link changesets to specific tickets that were logged in Azure DevOps. We can check in code against a specific ticket and it will show on the ticket the changesets.

    It sounds like when we switch over to CommerceSDK that we have to use GIT as the source control. Do I understand this correctly?

    3) VS code is mentioned. I know my colleague started to develop E-Com custom and he has to do it using VS Code. But we develop Retail extensions using Visual Studio 2017.  From the part 1 video on TechTalk it looks like what I understood from Luke, that we can continue to develop using VS2017. Is that correct?

    4) Currently all our RetailSDK and CRT customization projects are Class Library (.Net Framework) projects.  So we have to change them all to be Class Library (.Net Standard) projects? They mentioned in the Part 1 series that  one just have to change the project type on the project properties. However I do not see a project type on my .Net Framework project.

    5) Currently the references on our projects are added by 'Manage Nuget Packages' and we add them  as a PackageReference format and not a Packages.Config format. So until we switch to CommerceSDK, do I need to change anything where this reference gets its package or not?

    I still don't understand the part that I need to get the packages from GIT. Is this for when I switch to CommerceSDK or is it something I need to do right now because I upgraded my Dev box to V10.0.22? Meaning that the RetailSDK that was saved to my Dev box under "K:\RetailSDK\Update" when I upgraded my Dev box in LCS to v10.0.22, doesn't have the DLLs for v10.0.22?

    If I right-click on my project in VS and click on Manage Nuget Packages and then on Browse, I see the Package source is LocalPackages.  If I click on the little gear symbol next to the dropdown, I see that LocalPackages points to RetailSDK\pkgs.

    If I have to get it from the GitHub repositories for v10.0.22, where do I save it to? Overwriting the RetailSDK\pkgs folder?

  • SergeyP Profile Picture
    2,928 on at

    >... 1) First when  will we have to switch? I know RetailSDK will be deprecated October 2022. ...

    You would need to switch by the above date, so the sooner you will start getting familiar with the new GitHub based SDKs the better, the readme outlines details on how the Dev Experience look like in regards to the Commerce Scale Unit. Meantime, Dev VMs deploying via LCS are planned to not have any Retail components (like, for instance, RS, CPOS, HS, SampleStoreFront) pre-deployed there, that removal is planned to be completed sooner than Oct 2022. So, when those components are removed, and if you will still need to use the Legacy Retail SDK present on that Dev VM, you would need to deploy corresponding product (like RS, HS, CPOS) by leveraging on-prem Installers: Introduction to Commerce Sealed Installers either explicitly as outlined in that blog or, in case of On-Prem Scale Unit, via semi-automated way as shown in GitHub Scale Unit sample.

    >... However it doesn't sound like everything is ready om Microsoft's end. ...

    There are indeed activities still in progress on Microsoft side but at the same time we wanted to inform about the switch the sooner the better so the customers/partners are prepared well.

    >... For example ISV packages and CloudPOS.  ...

    Can you outline specific details on what is missing in the new SDKs in regards to the above?

    >... It sounds like when we switch over to CommerceSDK that we have to use GIT as the source control. Do I understand this correctly? ...

    No, you don't have to change your internal Source Control. The fact the new Commerce SDK Samples live on GitHub simply means we now use more standard and open way of delivering samples than with the Legacy Retail SDK. The fact the Legacy Retail SDK gets updates only in a context of those LCS based DEV VMs is a restricting factor (for both - customers as well as Microsoft) - customers have to use that VM or copy the SDK/Samples from there to another machine in order to use it. With GitHub based samples we are employing industry standard way of delivering the SDK/Samples to the outside world. So if you don't want to use GitHub - you don't have to - you just would use GitHub to get the latest samples sources and then you could still use your existing source control to maintain those sources. I need to explicitly say that this GitHub approach let's us deliver the SDK/Sample changes to customers much faster and easier for the customers - you no longer need to update your entire LCS VM to get a new version of the SDK which could take hours, instead you just need to spend literally few minutes to sync to the latest on GitHub for the branch you need and this is it. This also allows us releasing SDK/Samples hotfixes much faster since we don't need to go through entire LCS pipeline - all the required SDK packages are available via public nuget feed.

     

    Regarding Visual Studio vs VS Code, both can be used but with the latter more steps are automated, that is especially prominent in the above mentioned Scale Unit Installer, which employs lots of automation when is invoked via VS Code but that doesn't mean VS Code is the only way to develop it - you can still use Visual Studio or even directly command line commands. 

    >... However I do not see a project type on my .Net Framework project. ...

    This is where the setting in the new Commerce SDK corresponding to the Scale Unit:

    <PropertyGroup>
      <TargetFramework>netstandard2.0</TargetFramework>
    </PropertyGroup>

    You can also see that via Visual Studio's project properties (right click the project and click Properties):

    TargetFrameworkProperties.png

    >...  So we have to change them all to be Class Library (.Net Standard) projects? ...

    Yes, that is especially important because the new, above mentioned Sealed Installers, deploy an ASP.NET Core 3.1 version of Retail Server and similar change will be available for Cloud deployed Retail Servers as well. This is the link which indicates the usages of netstandard while creating custom controllers.

    >... do I need to change anything where this reference gets its package or not? ...

    You don't need to, the packages.config is just another way to reference nuget packages especially since you are talking about Legacy Retail SDK.

    >... I still don't understand the part that I need to get the packages from GIT. Is this for when I switch to CommerceSDK or is it something I need to do right now because I upgraded my Dev box to V10.0.22? ...

    Packages are not actually retrieved from Git (I assume you meant GitHub), instead those above mentioned GitHub Samples are published on Git and those samples reference the new Commerce SDK nuget packages available via public feed. You only need to deal with them when working with the new SDK. To work with the Legacy Retail SDK keep using the same approach as you did before - retrieve everything from the LCS Dev VM.

    >... Meaning that the RetailSDK that was saved to my Dev box under "K:\RetailSDK\Update" when I upgraded my Dev box in LCS to v10.0.22, doesn't have the DLLs for v10.0.22? ...

    The fact you upgraded your LCS Dev VM means that VM got everything required for the Legacy Retail SDK/Samples to work, so if you updated it to specific 10.0.22 version - you have got everything on that VM required to create extensions by using Legacy Retail SDK.

    >... If I have to get it from the GitHub repositories for v10.0.22, where do I save it to? Overwriting the RetailSDK\pkgs folder? ...

    You don't need to mix packages from Retail and Commerce SDKs. Anyways, if you still want to see the location of the nuget packages as restored in the new GitHub based Commerce SDK, you can find them in the %UserProfile%/.nuget/packages

  • Retha Profile Picture
    1,457 on at

    Hi Sergey

    Thanks for answering my questions.

    If you listen to the Part 1 video that Todd was so nice to provide the link for, you will hear that the guy stated that they are not ready with CloudPOS yet to switch to CommerceSDK.  I could have misunderstood him because it was very difficult to understand him because he spoke so fast while having a heavy accent.

  • SergeyP Profile Picture
    2,928 on at

    Probably there is some confusion but CPOS is ready in the Commerce SDK, at least there are no known issues to us in that regard. Can you please specify the time marker (from-to) which says about the issues you were talking about above?

  • Retha Profile Picture
    1,457 on at

    Listen to the Q&A, the 2nd question with time marker around 59:11.

    It has to do with the ISV retail packages. Currently on RetailSDK I merge the ISV custom with our custom and then create 1 retail deployable package.

    It sounds like for CommerceSDK we won't do it like this anymore (the merging of custom into the retailSDK) except for cloudPOS?

Under review

Thank you for your reply! To ensure a great experience for everyone, your content is awaiting approval by our Community Managers. Please check back later.

Helpful resources

Quick Links

Responsible AI policies

As AI tools become more common, we’re introducing a Responsible AI Use…

Neeraj Kumar – Community Spotlight

We are honored to recognize Neeraj Kumar as our Community Spotlight honoree for…

Leaderboard > Supply chain | Supply Chain Management, Commerce

#1
Siv Sagar Profile Picture

Siv Sagar 283 Super User 2025 Season 2

#2
Laurens vd Tang Profile Picture

Laurens vd Tang 196 Super User 2025 Season 2

#3
André Arnaud de Calavon Profile Picture

André Arnaud de Cal... 139 Super User 2025 Season 2

Last 30 days Overall leaderboard

Featured topics

Product updates

Dynamics 365 release plans