diff --git a/Microsoft.Toolkit.Uwp.SampleApp/Microsoft.Toolkit.Uwp.SampleApp.csproj b/Microsoft.Toolkit.Uwp.SampleApp/Microsoft.Toolkit.Uwp.SampleApp.csproj
index 54b67eaba99..4e2d05bbc26 100644
--- a/Microsoft.Toolkit.Uwp.SampleApp/Microsoft.Toolkit.Uwp.SampleApp.csproj
+++ b/Microsoft.Toolkit.Uwp.SampleApp/Microsoft.Toolkit.Uwp.SampleApp.csproj
@@ -460,7 +460,6 @@
-
Designer
@@ -499,9 +498,6 @@
AdvancedCollectionViewPage.xaml
-
- AppPinManagerHelperPage.xaml
-
BluetoothLEHelperPage.xaml
@@ -796,10 +792,6 @@
Designer
MSBuild:Compile
-
- Designer
- MSBuild:Compile
-
MSBuild:Compile
Designer
diff --git a/Microsoft.Toolkit.Uwp.SampleApp/SamplePages/AppPinManager/AppPinManagerHelperCode.bind b/Microsoft.Toolkit.Uwp.SampleApp/SamplePages/AppPinManager/AppPinManagerHelperCode.bind
deleted file mode 100644
index d75eb807666..00000000000
--- a/Microsoft.Toolkit.Uwp.SampleApp/SamplePages/AppPinManager/AppPinManagerHelperCode.bind
+++ /dev/null
@@ -1,20 +0,0 @@
-//Specific app pin to StartMenu
-var appList = (await Package.Current.GetAppListEntriesAsync())[0];
-var pinResult = await AppPinManager.PinSpecificAppToStartMenuAsync(appList);
-
-//User Specific app in StartMenu
-var userInfo = await User.FindAllAsync();
-if (userInfo.Count > 0)
-{
- var appList = (await Package.Current.GetAppListEntriesAsync())[0];
- var pinResult = await AppPinManager.PinUserSpecificAppToStartMenuAsync(userInfo[0], appList);
-}
-
-//Current app pin to TaskBar
-var pinResult = await AppPinManager.PinCurrentAppToTaskBarAsync();
-
-
-//Specific app pin to TaskBar
-var appList = (await Package.Current.GetAppListEntriesAsync())[0];
-var pinResult = await AppPinManager.PinSpecificAppToTaskBarAsync(appList);
-
diff --git a/Microsoft.Toolkit.Uwp.SampleApp/SamplePages/AppPinManager/AppPinManagerHelperPage.xaml b/Microsoft.Toolkit.Uwp.SampleApp/SamplePages/AppPinManager/AppPinManagerHelperPage.xaml
deleted file mode 100644
index 057e9fadb18..00000000000
--- a/Microsoft.Toolkit.Uwp.SampleApp/SamplePages/AppPinManager/AppPinManagerHelperPage.xaml
+++ /dev/null
@@ -1,71 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/Microsoft.Toolkit.Uwp.SampleApp/SamplePages/AppPinManager/AppPinManagerHelperPage.xaml.cs b/Microsoft.Toolkit.Uwp.SampleApp/SamplePages/AppPinManager/AppPinManagerHelperPage.xaml.cs
deleted file mode 100644
index 9242b7c93d5..00000000000
--- a/Microsoft.Toolkit.Uwp.SampleApp/SamplePages/AppPinManager/AppPinManagerHelperPage.xaml.cs
+++ /dev/null
@@ -1,63 +0,0 @@
-// ******************************************************************
-// Copyright (c) Microsoft. All rights reserved.
-// This code is licensed under the MIT License (MIT).
-// THE CODE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
-// INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
-// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
-// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH
-// THE CODE OR THE USE OR OTHER DEALINGS IN THE CODE.
-// ******************************************************************
-
-using System;
-using Microsoft.Toolkit.Uwp.Helpers;
-using Windows.ApplicationModel;
-using Windows.System;
-using Windows.UI.Xaml;
-using Windows.UI.Xaml.Controls;
-
-namespace Microsoft.Toolkit.Uwp.SampleApp.SamplePages
-{
- ///
- /// An empty page that can be used on its own or navigated to within a Frame.
- ///
- public sealed partial class AppPinManagerHelperPage : Page
- {
- public AppPinManagerHelperPage()
- {
- this.InitializeComponent();
- }
-
- private async void SpecificAppSMenuButton_OnClick(object sender, RoutedEventArgs e)
- {
- var appList = (await Package.Current.GetAppListEntriesAsync())[0];
- var pinResult = await AppPinManager.PinSpecificAppToStartMenuAsync(appList);
- StatusMessage.Text = "SpecificApp in StartMenu : " + pinResult.ToString();
- }
-
- private async void UserSpecificAppSMenuButton_OnClick(object sender, RoutedEventArgs e)
- {
- var userInfo = await User.FindAllAsync();
- if (userInfo.Count > 0)
- {
- var appList = (await Package.Current.GetAppListEntriesAsync())[0];
- var pinResult = await AppPinManager.PinUserSpecificAppToStartMenuAsync(userInfo[0], appList);
- StatusMessage.Text = "User SpecificApp in StartMenu : " + pinResult.ToString();
- }
- }
-
- private async void CurrentAppTBarButton_OnClick(object sender, RoutedEventArgs e)
- {
- var pinResult = await AppPinManager.PinCurrentAppToTaskBarAsync();
- StatusMessage.Text = "Current App in TaskBar : " + pinResult.ToString();
- }
-
- private async void SpecificAppTBarButton_OnClick(object sender, RoutedEventArgs e)
- {
- var appList = (await Package.Current.GetAppListEntriesAsync())[0];
- var pinResult = await AppPinManager.PinSpecificAppToTaskBarAsync(appList);
- StatusMessage.Text = "Specific App in TaskBar : " + pinResult.ToString();
- }
- }
-}
diff --git a/Microsoft.Toolkit.Uwp.SampleApp/SamplePages/samples.json b/Microsoft.Toolkit.Uwp.SampleApp/SamplePages/samples.json
index ea93f428d69..504f01e4149 100644
--- a/Microsoft.Toolkit.Uwp.SampleApp/SamplePages/samples.json
+++ b/Microsoft.Toolkit.Uwp.SampleApp/SamplePages/samples.json
@@ -550,16 +550,6 @@
"Icon": "/Assets/Helpers.png",
"DocumentationUrl": "https://raw.githubusercontent.com/Microsoft/UWPCommunityToolkit/master/docs/helpers/BackgroundTaskHelper.md"
},
- {
- "About": "The AppPinManager helps easily add app shortcuts to the Start Menu or the Taskbar",
- "CodeFile": "AppPinManagerHelperCode.bind",
- "CodeUrl": "https://github.com/Microsoft/UWPCommunityToolkit/blob/master/Microsoft.Toolkit.Uwp/Helpers/AppPinManager/AppPinManager.cs",
- "DocumentationUrl": "https://raw.githubusercontent.com/Microsoft/UWPCommunityToolkit/master/docs/helpers/AppPinManager.md",
- "Icon": "/Assets/Helpers.png",
- "Name": "AppPinManager",
- "Type": "AppPinManagerHelperPage",
- "BadgeUpdateVersionRequired": "Creators Update required"
- },
{
"Name": "NetworkHelper",
"Type": "NetworkHelperPage",
diff --git a/Microsoft.Toolkit.Uwp/Helpers/AppPinManager/AppPinManager.cs b/Microsoft.Toolkit.Uwp/Helpers/AppPinManager/AppPinManager.cs
index ebe12b783b9..0f5374e9928 100644
--- a/Microsoft.Toolkit.Uwp/Helpers/AppPinManager/AppPinManager.cs
+++ b/Microsoft.Toolkit.Uwp/Helpers/AppPinManager/AppPinManager.cs
@@ -23,12 +23,14 @@ namespace Microsoft.Toolkit.Uwp.Helpers
///
/// This class provides static helper methods help to add the app in startmenu or TaskBar.
///
+ [Obsolete("This helper will be removed in future releases. Please use the platform APIs directly")]
public static class AppPinManager
{
///
/// Pin the current app in Windows TaskBar
///
/// PinResult
+ [Obsolete("This helper will be removed in future releases. Please use the Windows.UI.Shel.TaskbarManager APIs directly")]
public static async Task PinCurrentAppToTaskBarAsync()
{
var resultPinResult = PinResult.UnsupportedOs;
@@ -70,6 +72,7 @@ public static async Task PinCurrentAppToTaskBarAsync()
///
/// AppListEntry
/// PinResult
+ [Obsolete("This helper will be removed in future releases. Please use the Windows.UI.Shel.TaskbarManager APIs directly")]
public static async Task PinSpecificAppToTaskBarAsync(AppListEntry appListEntry)
{
var resultPinResult = PinResult.UnsupportedOs;
@@ -111,6 +114,7 @@ public static async Task PinSpecificAppToTaskBarAsync(AppListEntry ap
///
/// AppListEntry
/// PinResult
+ [Obsolete("This helper will be removed in future releases. Please use the Windows.UI.StartScreen.StartScreenManager APIs directly")]
public static async Task PinSpecificAppToStartMenuAsync(AppListEntry entry)
{
var resultPinResult = PinResult.UnsupportedOs;
@@ -146,6 +150,7 @@ public static async Task PinSpecificAppToStartMenuAsync(AppListEntry
/// User
/// AppListEntry
/// PinResult
+ [Obsolete("This helper will be removed in future releases. Please use the Windows.UI.StartScreen.StartScreenManager APIs directly")]
public static async Task PinUserSpecificAppToStartMenuAsync(User user, AppListEntry entry)
{
var resultPinResult = PinResult.UnsupportedOs;
diff --git a/docs/helpers/AppPinManager.md b/docs/helpers/AppPinManager.md
index 20d5f36f586..00e86f42026 100644
--- a/docs/helpers/AppPinManager.md
+++ b/docs/helpers/AppPinManager.md
@@ -8,6 +8,9 @@ keywords: windows 10, uwp, uwp community toolkit, uwp toolkit, StartMenu, TaskBa
# AppPinManager
+> [!NOTE]
+The AppPinManager is deprecated and will be removed in the next major release. Please use the platform APIs ([TaskbarManager](https://docs.microsoft.com/en-us/uwp/api/windows.ui.shell.taskbarmanager) and [StartScreenManager](https://docs.microsoft.com/en-us/uwp/api/windows.ui.startscreen.startscreenmanager)) directly.
+
The **AppPinManager** is a class used to add the application shortcut in StartMenu or TaskBar.
## Syntax
diff --git a/readme.md b/readme.md
index 26638801369..bf12af84774 100644
--- a/readme.md
+++ b/readme.md
@@ -112,7 +112,6 @@ Once you search you should see a list similar to the one below (versions may be
### Helpers
* [AdvancedCollectionView](https://docs.microsoft.com/windows/uwpcommunitytoolkit/helpers/AdvancedCollectionView/)
-* [AppPinManager](https://docs.microsoft.com/windows/uwpcommunitytoolkit/helpers/AppPinManager/)
* [BackgroundTaskHelper](https://docs.microsoft.com/windows/uwpcommunitytoolkit/helpers/BackgroundTaskHelper/)
* [BindableValueHolder](https://docs.microsoft.com/windows/uwpcommunitytoolkit/helpers/BindableValueHolder/)
* [BluetoothLEHelper](https://docs.microsoft.com/windows/uwpcommunitytoolkit/helpers/BluetoothLEHelper/)