Added TikTok App Events sample.

Adds a sample for utilizing TikTok App Events.

tiktok/NuGet.Config

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+  <packageSources>
+    <add key="maui-nativelibraryinterop" value="https://pkgs.dev.azure.com/xamarin/public/_packaging/maui-nativelibraryinterop/nuget/v3/index.json" />
+  </packageSources>
+</configuration>

tiktok/README.md

@@ -0,0 +1,45 @@
+# TikTok App Events Slim Binding
+This folder contains a slim binding which demonstrations using [TikTok App Events][0]
+
+## Setup
+The TikTok Business sdk must be added to the root of the sample folder. The SDK is distributed via [Jitpack][3], [download the aar][4]. Next the App IDs and Tik Tok App IDs must be set in app.xaml.cs.
+* The App IDs come from the respective app stores
+* See [Generating TikTok App IDs][2]
+
+## Manually Building The Android Binding
+These steps may or may not be required based on your machine's configuration. 
+
+```shell
+cd tiktok/android/native
+./gradlew build
+cd ../TikTok.Android.Binding
+dotnet build -t:InstallAndroidDependencies -f net9.0-android
+```
+
+### Build and Run
+```shell
+    dotnet build sample -t:Run -f net9.0-android
+    dotnet build sample -t:Run -f net9.0-ios
+```
+
+## Notes
+* If you experience issues with missing references manually invoking gradlew build before building the dotnet project helps.
+* NativeLibraryInterop depends on "CommunityToolkit.Maui.NativeLibraryInterop.BuildTasks", this package is not yet on Nuget, when migrating this sample into your project be sure to include the NuGet.Config in your project's folder.
+* You will also need to add the following to your project's csproj
+```
+<ItemGroup Condition="$(TargetFramework.Contains('android'))">
+    <AndroidLibrary Include="tiktok-business-android-sdk-1.3.8.aar">
+        <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </AndroidLibrary>
+</ItemGroup>
+
+<ItemGroup>
+    <PackageReference Include="CommunityToolkit.Maui.NativeLibraryInterop.BuildTasks" Version="0.0.1-pre1" PrivateAssets="all" />
+</ItemGroup>
+```
+
+[0]: https://business-api.tiktok.com/portal/docs?id=1739584951798785
+[1]: https://jitpack.io/com/github/tiktok/tiktok-business-android-sdk/1.3.8/tiktok-business-android-sdk-1.3.8.aar
+[2]: https://business-api.tiktok.com/portal/docs?id=1739584951798785#item-link-Generate%20your%20TikTok%20App%20ID
+[3]: https://jitpack.io/com/github/tiktok/tiktok-business-android-sdk/1.3.8/
+[4]: https://jitpack.io/com/github/tiktok/tiktok-business-android-sdk/1.3.8/tiktok-business-android-sdk-1.3.8.aar

tiktok/android/TikTok.Android.Binding/Additions/AboutAdditions.txt

@@ -0,0 +1,48 @@
+Additions allow you to add arbitrary C# to the generated classes
+before they are compiled.  This can be helpful for providing convenience
+methods or adding pure C# classes.
+
+== Adding Methods to Generated Classes ==
+
+Let's say the library being bound has a Rectangle class with a constructor
+that takes an x and y position, and a width and length size.  It will look like
+this:
+
+public partial class Rectangle
+{
+    public Rectangle (int x, int y, int width, int height)
+    {
+        // JNI bindings
+    }
+}
+
+Imagine we want to add a constructor to this class that takes a Point and
+Size structure instead of 4 ints.  We can add a new file called Rectangle.cs
+with a partial class containing our new method:
+
+public partial class Rectangle
+{
+    public Rectangle (Point location, Size size) :
+        this (location.X, location.Y, size.Width, size.Height)
+    {
+    }
+}
+
+At compile time, the additions class will be added to the generated class
+and the final assembly will a Rectangle class with both constructors.
+
+
+== Adding C# Classes ==
+
+Another thing that can be done is adding fully C# managed classes to the
+generated library.  In the above example, let's assume that there isn't a
+Point class available in Java or our library.  The one we create doesn't need
+to interact with Java, so we'll create it like a normal class in C#.
+
+By adding a Point.cs file with this class, it will end up in the binding library:
+
+public class Point
+{
+    public int X { get; set; }
+    public int Y { get; set; }
+}

tiktok/android/TikTok.Android.Binding/TikTok.Android.Binding.csproj

@@ -0,0 +1,30 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>net9.0-android</TargetFramework>
+    <SupportedOSPlatformVersion>21</SupportedOSPlatformVersion>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <!--
+      Enable trim analyzers for Android class libraries.
+      To learn more, see: https://learn.microsoft.com/dotnet/core/deploying/trimming/prepare-libraries-for-trimming
+    -->
+    <IsTrimmable>true</IsTrimmable>
+    <RootNamespace>MauiTikTokAndroid.Android.Binding</RootNamespace>
+    <!--
+      NOTE: you can simply add .aar or .jar files in this directory to be included in the project.
+      To learn more, see: https://learn.microsoft.com/dotnet/maui/migration/android-binding-projects
+    -->
+  </PropertyGroup>
+
+  <!-- Reference to Android Gradle project -->
+  <ItemGroup>
+    <AndroidGradleProject Include="../native/build.gradle.kts" >
+      <ModuleName>MauiTikTok</ModuleName>
+      <!-- Metadata applicable to @(AndroidLibrary) will be used if set, otherwise the following defaults will be used:
+      <Bind>true</Bind>
+      <Pack>true</Pack>
+      -->
+    </AndroidGradleProject>
+  </ItemGroup>
+
+</Project>

tiktok/android/TikTok.Android.Binding/Transforms/EnumFields.xml

@@ -0,0 +1,14 @@
+<enum-field-mappings>
+  <!--
+  This example converts the constants Fragment_id, Fragment_name,
+  and Fragment_tag from android.support.v4.app.FragmentActivity.FragmentTag
+  to an enum called Android.Support.V4.App.FragmentTagType with values
+  Id, Name, and Tag.
+
+  <mapping jni-class="android/support/v4/app/FragmentActivity$FragmentTag" clr-enum-type="Android.Support.V4.App.FragmentTagType">
+    <field jni-name="Fragment_name" clr-name="Name" value="0" />
+    <field jni-name="Fragment_id" clr-name="Id" value="1" />
+    <field jni-name="Fragment_tag" clr-name="Tag" value="2" />
+  </mapping>
+  -->
+</enum-field-mappings>

tiktok/android/TikTok.Android.Binding/Transforms/EnumMethods.xml

@@ -0,0 +1,13 @@
+<enum-method-mappings>
+  <!--
+  This example changes the Java method:
+    android.support.v4.app.Fragment.SavedState.writeToParcel (int flags)
+  to be:
+    android.support.v4.app.Fragment.SavedState.writeToParcel (Android.OS.ParcelableWriteFlags flags)
+  when bound in C#.
+
+  <mapping jni-class="android/support/v4/app/Fragment.SavedState">
+    <method jni-name="writeToParcel" parameter="flags" clr-enum-type="Android.OS.ParcelableWriteFlags" />
+  </mapping>
+  -->
+</enum-method-mappings>

tiktok/android/TikTok.Android.Binding/Transforms/Metadata.xml

@@ -0,0 +1,4 @@
+<metadata>
+    <!-- Make sure the package id and name reflects the new binding name -->
+    <attr path="/api/package[@name='com.microsoft.tiktok']" name="managedName">MauiTikTokAndroid</attr>
+</metadata>

tiktok/android/native/.gitignore

@@ -0,0 +1,15 @@
+*.iml
+.gradle
+/local.properties
+/.idea/caches
+/.idea/libraries
+/.idea/modules.xml
+/.idea/workspace.xml
+/.idea/navEditor.xml
+/.idea/assetWizardSettings.xml
+.DS_Store
+*/build
+/captures
+.externalNativeBuild
+.cxx
+local.properties

tiktok/android/native/build.gradle.kts

@@ -0,0 +1,6 @@
+// Top-level build file where you can add configuration options common to all sub-projects/modules.
+plugins {
+    id("com.android.library") version "8.6.1" apply false
+}
+
+

tiktok/android/native/gradle.properties

@@ -0,0 +1,21 @@
+# Project-wide Gradle settings.
+# IDE (e.g. Android Studio) users:
+# Gradle settings configured through the IDE *will override*
+# any settings specified in this file.
+# For more details on how to configure your build environment visit
+# http://www.gradle.org/docs/current/userguide/build_environment.html
+# Specifies the JVM arguments used for the daemon process.
+# The setting is particularly useful for tweaking memory settings.
+org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
+# When configured, Gradle will run in incubating parallel mode.
+# This option should only be used with decoupled projects. More details, visit
+# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
+# org.gradle.parallel=true
+# AndroidX package structure to make it clearer which packages are bundled with the
+# Android operating system, and which are packaged with your app's APK
+# https://developer.android.com/topic/libraries/support-library/androidx-rn
+android.useAndroidX=true
+# Enables namespacing of each library's R class so that its R class includes only the
+# resources declared in the library itself and none from the library's dependencies,
+# thereby reducing the size of the R class for that library
+android.nonTransitiveRClass=true

tiktok/android/native/gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,6 @@
+#Mon Jun 24 14:49:07 EDT 2024
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.10.2-bin.zip
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists