Remove repository sample apps (#182)

Author: AdamEssenmacher

AGENTS.md

@@ -1,9 +1,9 @@
 # Agent Instructions (public OSS)
 
 ## Non-negotiables
-- Documentation and samples must be generic (not app-specific).
+- Documentation must be generic (not app-specific).
 - Do not reference private business context.
-- Do not commit secrets; samples must rely on local config templates.
+- Do not commit secrets; rely on local config templates.
 
 ## Working agreements
 - Keep changes reviewable and releaseable (small PR-sized diffs).

CONTRIBUTING.md

@@ -18,21 +18,19 @@ This repo primarily contains:
 
 * **Bindings** (C# API surface + native frameworks packaged into NuGet)
 * **Build automation** (Cake scripts that fetch/build Pods and pack NuGets)
-* **Samples** (small apps to validate the bindings work end-to-end)
 * **Docs** (how to build, validate, publish)
 
 Most contributions fall into one of these buckets:
 
-* **Docs-only**: clarify setup, sample configuration, gotchas.
-* **Dependency bumps**: update a Pod version (and any required transitive Pods), then ensure the binding still packs and the sample still builds.
+* **Docs-only**: clarify setup, configuration, gotchas.
+* **Dependency bumps**: update a Pod version (and any required transitive Pods), then ensure the binding still packs.
 * **Binding fixes**: API surface adjustments, linker/NativeReference fixes, or changes needed after a native SDK update.
 
 ## Repository orientation (quick map)
 
-* `components.cake`: component definitions (Pod specs, sample names, dependency graph).
+* `components.cake`: component definitions (Pod specs, dependency graph).
 * `externals/`: generated/native artifacts produced from Pods (created by the build).
 * `source/`: binding projects (what becomes NuGet packages).
-* `samples/`: sample apps that reference the bindings.
 * `.github/workflows/`: CI validation and publishing.
 
 ## Common pitfalls with iOS bindings
@@ -73,9 +71,8 @@ At minimum, validate the component(s) you touched:
 
 * `dotnet tool restore`
 * `dotnet tool run dotnet-cake -- --target=nuget --names=<ComponentName>`
-* `dotnet tool run dotnet-cake -- --target=samples --names=<ComponentName>`
 
 Also:
 
-* Keep samples and docs **generic** (no app-specific context).
+* Keep docs **generic** (no app-specific context).
 * Do not commit secrets or service configuration files; prefer `.template` files and document the required local steps.

Readme.md

@@ -8,7 +8,7 @@ This repository is a community-supported continuation of the Xamarin Google/Fire
 
 The goal is to give .NET for iOS and Mac Catalyst developers a common binding baseline for Google, Firebase, and ML Kit native SDKs. That helps downstream libraries share the same native dependencies instead of each shipping incompatible copies of overlapping xcframeworks.
 
-This repo contains the binding projects, Cake build automation, documentation, and sample apps used to build and validate those packages.
+This repo contains the binding projects, Cake build automation, and documentation used to build and validate those packages.
 
 ## Quick links
 
@@ -166,7 +166,7 @@ If package extraction appears to be failing on Windows, see [this issue comment]
 
 ## Contributing and support
 
-Pull requests are welcome, especially for stale bindings, dependency updates, docs improvements, and sample fixes. For anything non-trivial, please open an issue or discussion first so we can align on the approach before you spend time on build tooling or binding surface changes.
+Pull requests are welcome, especially for stale bindings, dependency updates, docs improvements, and build fixes. For anything non-trivial, please open an issue or discussion first so we can align on the approach before you spend time on build tooling or binding surface changes.
 
 For contributor workflow details, see [CONTRIBUTING.md](CONTRIBUTING.md) and [docs/BUILDING.md](docs/BUILDING.md).
 

Xamarin.Google.sln

@@ -21,7 +21,6 @@ var EXTERNALS_PATH = new DirectoryPath ("./externals");
 var ARTIFACTS_TO_BUILD = new List<Artifact> ();
 
 var SOURCES_TARGETS = new List<string> ();
-var SAMPLES_TARGETS = new List<string> ();
 
 FilePath GetCakeToolPath ()
 {
@@ -99,7 +98,6 @@ Task("build")
 	.Does(() =>
 {
 	BuildCake ("nuget");
-	BuildCake ("samples");
 });
 
 // Prepares the artifacts to be built.
@@ -112,15 +110,12 @@ Task("prepare-artifacts")
 	SetArtifactsDependencies ();
 	SetArtifactsPodSpecs ();
 	SetArtifactsExtraPodfileLines ();
-	SetArtifactsSamples ();
 
 	var selectedArtifactsForBuild = new List<Artifact> ();
-	var orderedArtifactsForSamples = new List<Artifact> ();
 
 	if (string.IsNullOrWhiteSpace (NAMES)) {
 		var artifacts = ARTIFACTS.Values.Where (a => !a.Ignore);
 		selectedArtifactsForBuild.AddRange (artifacts);
-		orderedArtifactsForSamples.AddRange (artifacts);
 	} else {
 		var names = NAMES.Split (',');
 		foreach (var name in names) {
@@ -131,11 +126,9 @@ Task("prepare-artifacts")
 				continue;
 
 			selectedArtifactsForBuild.Add (artifact);
-			orderedArtifactsForSamples.Add (artifact);
 		}
 
 		selectedArtifactsForBuild = selectedArtifactsForBuild.Distinct ().ToList ();
-		orderedArtifactsForSamples = orderedArtifactsForSamples.Distinct ().ToList ();
 	}
 
 	var orderedArtifactsForBuild = OrderArtifactsByDependencies (selectedArtifactsForBuild);
@@ -147,11 +140,6 @@ Task("prepare-artifacts")
 		SOURCES_TARGETS.Add($@"{artifact.ComponentGroup}{BACKSLASH}{artifact.CsprojName.Replace ('.', '_')}");
 		Information (artifact.Id);
 	}
-
-	foreach (var artifact in orderedArtifactsForSamples)
-		if (artifact.Samples != null)
-			foreach (var sample in artifact.Samples)
-				SAMPLES_TARGETS.Add($@"{artifact.ComponentGroup}{BACKSLASH}{sample.Replace ('.', '_')}");
 });
 
 Task ("externals")
@@ -215,36 +203,6 @@ Task ("libs")
 	}
 });
 
-Task ("samples")
-	.IsDependentOn("libs")
-	.Does(() =>
-{
-	var msBuildSettings = new DotNetMSBuildSettings ();
-	msBuildSettings.Properties ["Platform"] = new [] { "iPhoneSimulator" };
-	msBuildSettings.Properties ["RuntimeIdentifier"] = new [] { GetDefaultiOSSimulatorRuntimeIdentifier () };
-	msBuildSettings.Properties ["EnableCodeSigning"] = new [] { "false" };
-
-	var dotNetBuildSettings = new DotNetBuildSettings {
-		Configuration = "Release",
-		Verbosity = DotNetVerbosity.Diagnostic,
-		NoRestore = false,
-		MSBuildSettings = msBuildSettings
-	};
-	
-	// Build each sample csproj directly
-	foreach (var artifact in ARTIFACTS_TO_BUILD) {
-		if (artifact.Samples == null)
-			continue;
-		foreach (var sample in artifact.Samples) {
-			var samplePath = $"./samples/{artifact.ComponentGroup}/{sample}/{sample}.csproj";
-			if (FileExists(samplePath)) {
-				Information ($"Building sample: {samplePath}");
-				DotNetBuild(samplePath, dotNetBuildSettings);
-			}
-		}
-	}
-});
-
 Task ("nuget")
 	.IsDependentOn("externals")
 	.IsDependentOn("ci-setup")
@@ -301,8 +259,7 @@ Task ("clean")
 Task ("ci")
 	.IsDependentOn("externals")
 	.IsDependentOn("libs")
-	.IsDependentOn("nuget")
-	.IsDependentOn("samples");
+	.IsDependentOn("nuget");
 
 Teardown (context =>
 {

build.cake

@@ -102,18 +102,18 @@ void SetArtifactsDependencies ()
 {
 	FIREBASE_AB_TESTING_ARTIFACT.Dependencies              = new [] { FIREBASE_CORE_ARTIFACT };
 	FIREBASE_ANALYTICS_ARTIFACT.Dependencies               = new [] { FIREBASE_CORE_ARTIFACT, FIREBASE_INSTALLATIONS_ARTIFACT, GOOGLE_GOOGLE_APP_MEASUREMENT_ARTIFACT };
-	FIREBASE_AUTH_ARTIFACT.Dependencies                    = new [] { FIREBASE_CORE_ARTIFACT, GOOGLE_GTM_SESSION_FETCHER_ARTIFACT /* Needed for sample GOOGLE_SIGN_IN_ARTIFACT */ };
-	FIREBASE_CLOUD_FIRESTORE_ARTIFACT.Dependencies         = new [] { FIREBASE_CORE_ARTIFACT, /* Needed for sample */ FIREBASE_AUTH_ARTIFACT };
+	FIREBASE_AUTH_ARTIFACT.Dependencies                    = new [] { FIREBASE_CORE_ARTIFACT, GOOGLE_GTM_SESSION_FETCHER_ARTIFACT };
+	FIREBASE_CLOUD_FIRESTORE_ARTIFACT.Dependencies         = new [] { FIREBASE_CORE_ARTIFACT, FIREBASE_AUTH_ARTIFACT };
 	FIREBASE_CLOUD_FUNCTIONS_ARTIFACT.Dependencies         = new [] { FIREBASE_CORE_ARTIFACT, GOOGLE_GTM_SESSION_FETCHER_ARTIFACT };
 	FIREBASE_CLOUD_MESSAGING_ARTIFACT.Dependencies         = new [] { FIREBASE_CORE_ARTIFACT, FIREBASE_INSTALLATIONS_ARTIFACT };
 	FIREBASE_CORE_ARTIFACT.Dependencies                    = new [] { GOOGLE_GOOGLE_DATA_TRANSPORT_ARTIFACT, GOOGLE_GOOGLE_UTILITIES_ARTIFACT, GOOGLE_NANOPB_ARTIFACT, GOOGLE_PROMISES_OBJC_ARTIFACT};
 	FIREBASE_CRASHLYTICS_ARTIFACT.Dependencies             = new [] { FIREBASE_CORE_ARTIFACT, FIREBASE_INSTALLATIONS_ARTIFACT };
-	FIREBASE_DATABASE_ARTIFACT.Dependencies                = new [] { FIREBASE_CORE_ARTIFACT, /* Needed for sample FIREBASE_AUTH_ARTIFACT */ };
+	FIREBASE_DATABASE_ARTIFACT.Dependencies                = new [] { FIREBASE_CORE_ARTIFACT };
 	FIREBASE_IN_APP_MESSAGING_ARTIFACT.Dependencies        = new [] { FIREBASE_CORE_ARTIFACT, FIREBASE_INSTALLATIONS_ARTIFACT, FIREBASE_AB_TESTING_ARTIFACT };
 	FIREBASE_INSTALLATIONS_ARTIFACT.Dependencies           = new [] { FIREBASE_CORE_ARTIFACT };
 	FIREBASE_PERFORMANCE_MONITORING_ARTIFACT.Dependencies  = new [] { FIREBASE_CORE_ARTIFACT, FIREBASE_INSTALLATIONS_ARTIFACT, FIREBASE_AB_TESTING_ARTIFACT, FIREBASE_REMOTE_CONFIG_ARTIFACT };
 	FIREBASE_REMOTE_CONFIG_ARTIFACT.Dependencies           = new [] { FIREBASE_CORE_ARTIFACT, FIREBASE_INSTALLATIONS_ARTIFACT, FIREBASE_AB_TESTING_ARTIFACT };
-	FIREBASE_STORAGE_ARTIFACT.Dependencies                 = new [] { FIREBASE_CORE_ARTIFACT, FIREBASE_DATABASE_ARTIFACT, GOOGLE_GTM_SESSION_FETCHER_ARTIFACT /* Needed for sample FIREBASE_AUTH_ARTIFACT */ };
+	FIREBASE_STORAGE_ARTIFACT.Dependencies                 = new [] { FIREBASE_CORE_ARTIFACT, FIREBASE_DATABASE_ARTIFACT, GOOGLE_GTM_SESSION_FETCHER_ARTIFACT };
 	FIREBASE_APP_DISTRIBUTION_ARTIFACT.Dependencies        = new [] { FIREBASE_CORE_ARTIFACT, FIREBASE_INSTALLATIONS_ARTIFACT };
 	FIREBASE_APP_CHECK_ARTIFACT.Dependencies               = new [] { FIREBASE_CORE_ARTIFACT, FIREBASE_INSTALLATIONS_ARTIFACT, GOOGLE_APP_CHECK_CORE_ARTIFACT };
 
@@ -406,36 +406,3 @@ void SetArtifactsExtraPodfileLines ()
 
 	FIREBASE_IN_APP_MESSAGING_ARTIFACT.ExtraPodfileLines = inAppMessagingLines.ToArray ();
 }
-
-void SetArtifactsSamples ()
-{
-	// Firebase components
-	FIREBASE_AB_TESTING_ARTIFACT.Samples              = null;
-	FIREBASE_ANALYTICS_ARTIFACT.Samples               = new [] { "AnalyticsSample" };
-	FIREBASE_AUTH_ARTIFACT.Samples                    = new [] { "AuthSample" };
-	FIREBASE_CLOUD_FIRESTORE_ARTIFACT.Samples         = new [] { "CloudFirestoreSample" };
-	FIREBASE_CLOUD_FUNCTIONS_ARTIFACT.Samples         = new [] { "CloudFunctionsSample" };
-	FIREBASE_CLOUD_MESSAGING_ARTIFACT.Samples         = new [] { "CloudMessagingSample" };
-	FIREBASE_CORE_ARTIFACT.Samples                    = null;
-	FIREBASE_CRASHLYTICS_ARTIFACT.Samples             = new [] { "CrashlyticsSample" };
-	FIREBASE_DATABASE_ARTIFACT.Samples                = new [] { "DatabaseSample" };
-	//FIREBASE_IN_APP_MESSAGING_ARTIFACT.Samples        = new [] { "InAppMessagingSample" };
-	FIREBASE_INSTALLATIONS_ARTIFACT.Samples           = null;
-	FIREBASE_PERFORMANCE_MONITORING_ARTIFACT.Samples  = new [] { "PerformanceMonitoringSample" };
-	FIREBASE_REMOTE_CONFIG_ARTIFACT.Samples           = new [] { "RemoteConfigSample" };
-	FIREBASE_STORAGE_ARTIFACT.Samples                 = new [] { "StorageSample" };
-	FIREBASE_APP_DISTRIBUTION_ARTIFACT.Samples        = null;
-	FIREBASE_APP_CHECK_ARTIFACT.Samples                = new [] { "AppCheckSample" };
-
-	// Google components
-	GOOGLE_ANALYTICS_ARTIFACT.Samples                 = new [] { "AnalyticsSample" };
-	GOOGLE_CAST_ARTIFACT.Samples                      = new [] { "CastSample" };
-	GOOGLE_MAPS_ARTIFACT.Samples                      = new [] { "GoogleMapsSample" };
-	GOOGLE_MOBILE_ADS_ARTIFACT.Samples                = new [] { "MobileAdsExample" };
-	GOOGLE_PLACES_ARTIFACT.Samples                    = new [] { "GooglePlacesSample" };
-	GOOGLE_SIGN_IN_ARTIFACT.Samples                   = new [] { "SignInExample" };
-	GOOGLE_TAG_MANAGER_ARTIFACT.Samples               = new [] { "TagManagerSample" };
-
-	// MLKit
-	MLKIT_VISION.Samples                              = new [] { "MLKitVisionSample" };
-}

components.cake

@@ -42,18 +42,6 @@ Build and produce `.nupkg` files into `./output`:
 dotnet tool run dotnet-cake -- --target=nuget --names=Google.SignIn
 ```
 
-## Build samples (using source)
-
-Build sample projects (without publishing packages):
-
-```sh
-dotnet tool run dotnet-cake -- --target=samples --names=Google.SignIn
-```
-
-### Configure the Google Sign-In sample
-
-For a runnable sign-in flow on iOS, the app must register an URL scheme callback. When you provide your own `GoogleService-Info.plist` (or fill in `samples/Google/SignIn/SignInExample/GoogleService-Info.plist.template`), also update `samples/Google/SignIn/SignInExample/Info.plist` so `CFBundleURLSchemes` matches your `REVERSED_CLIENT_ID`.
-
 ## Clean-up
 
 To clean generated folders:

docs/BUILDING.md

@@ -104,7 +104,7 @@ controller.UpdateExperiments(
 
 Firebase apps commonly require app-specific configuration from your own Firebase project, such as `GoogleService-Info.plist`.
 
-Keep app-specific Firebase configuration in the application project or sample app, not in reusable library projects.
+Keep app-specific Firebase configuration in application projects, not in reusable library projects.
 
 If the official Firebase docs for this feature require additional setup, follow those docs first.
 

docs/Firebase/NuGet/ABTesting.md

@@ -87,7 +87,7 @@ Analytics.SetUserId("user-123");
 
 Firebase apps commonly require app-specific configuration from your own Firebase project, such as `GoogleService-Info.plist`.
 
-Keep app-specific Firebase configuration in the application project or sample app, not in reusable library projects.
+Keep app-specific Firebase configuration in application projects, not in reusable library projects.
 
 If the official Firebase docs for this feature require additional setup, follow those docs first.
 

docs/Firebase/NuGet/Analytics.md

@@ -89,7 +89,7 @@ AppCheck.SharedInstance.TokenForcingRefresh(true, (token, error) =>
 
 Firebase apps commonly require app-specific configuration from your own Firebase project, such as `GoogleService-Info.plist`.
 
-Keep app-specific Firebase configuration in the application project or sample app, not in reusable library projects.
+Keep app-specific Firebase configuration in application projects, not in reusable library projects.
 
 If the official Firebase docs for this feature require additional setup, follow those docs first.