Add header and stub for User Messaging Platform SDK. (#1391)

* Added initial header and empty stub for UMP ConsentInfo.

* Added error message getters.

* Add ConsentInfo methods.

* Format code.

* Comment tweak.

* Fix lint error.

* Add LastResult methods.

* Additional implementation.

* Fix build.

* Fix lint errors.

* Added integration test for initializing library.

* Update test.

* Fix initialization.

* Add internal methods.

* Add mappings from interface class to internal class.

* Add string conversion for error code.

* Add conversion of form errors.

* Add stub function implementations.

* Add stub operations and unit tests.

* Add missing file.

* Format code.

* Add check for form.

* Add test for expected error not specifying tag for age of consent.

* Clean up tests by moving initialization into shared method.

* Fix TODO.

* Fix lint issues.

* Add Doxygen comments to public interface.

* Add LastResult implementations, and tests to confirm.

* Add method stubs for new UserMessagingPlatform API.

* Handle invalid internal pointers.

* Format code.

* Add objective-C header for FormParent.

* Add ump.h to top-level CMake file, so it gets added to the framework.

* Change RequestConsentStatus to RequestConsentInfoUpdate.

* Update integration test method name.

* Update all Future return types to Future<void>.

Added GetInstance() with no parameters for Android, for convenience.

* Add a test to ensure that GetInstance() always returns the same instance.

* Change params to a struct.
Add ConsentFormErrorUnavailable and remove some other enum entries.

* Document the workflow that the stub simulates.

* Clean up stub workflow for privacy options.

* Add comment to struct.

* Fix comments & enum text.

* Newline removed.

* Lint error.

* Added comment explaining what EEA means.

* Add a comment about ResetInfo in the UMP tests.

* Add expectation for privacy also being unknown.

* Move GetConsent*ErrorMessage to internal.

* Update method documentation and fixed FormUnavailable/Available logic.

* Fix comments.

Author: jonsimantov

app/CMakeLists.txt

@@ -546,7 +546,10 @@ if (IOS)
     ${FIREBASE_SOURCE_DIR}/gma/src/include/firebase/gma/interstitial_ad.h
     ${FIREBASE_SOURCE_DIR}/gma/src/include/firebase/gma/internal/native_ad.h
     ${FIREBASE_SOURCE_DIR}/gma/src/include/firebase/gma/rewarded_ad.h
-    ${FIREBASE_SOURCE_DIR}/gma/src/include/firebase/gma/types.h)
+    ${FIREBASE_SOURCE_DIR}/gma/src/include/firebase/gma/types.h
+    ${FIREBASE_SOURCE_DIR}/gma/src/include/firebase/gma/ump.h
+    ${FIREBASE_SOURCE_DIR}/gma/src/include/firebase/gma/ump/consent_info.h
+    ${FIREBASE_SOURCE_DIR}/gma/src/include/firebase/gma/ump/types.h)
   set(installations_HDRS
     ${FIREBASE_SOURCE_DIR}/installations/src/include/firebase/installations.h)
   set(messaging_HDRS

gma/CMakeLists.txt

@@ -16,6 +16,8 @@
 
 # Common source files used by all platforms
 set(common_SRCS
+    src/common/ump/consent_info.cc
+    src/common/ump/consent_info_internal.cc
     src/common/gma_common.cc
     src/common/ad_view.cc
     src/common/ad_view_internal.cc
@@ -38,6 +40,7 @@ binary_to_array("gma_resources"
 # Source files used by the Android implementation.
 set(android_SRCS
     ${gma_resources_source}
+    src/stub/ump/consent_info_internal_stub.cc
     src/android/ad_request_converter.cc
     src/android/ad_error_android.cc
     src/android/adapter_response_info_android.cc
@@ -51,6 +54,7 @@ set(android_SRCS
 
 # Source files used by the iOS implementation.
 set(ios_SRCS
+    src/stub/ump/consent_info_internal_stub.cc
     src/ios/FADAdSize.mm
     src/ios/FADAdView.mm
     src/ios/FADInterstitialDelegate.mm
@@ -69,6 +73,7 @@ set(ios_SRCS
 
 # Source files used by the stub implementation.
 set(stub_SRCS
+    src/stub/ump/consent_info_internal_stub.cc
     src/stub/ad_error_stub.cc
     src/stub/adapter_response_info_stub.cc
     src/stub/gma_stub.cc