// Copyright 2019 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef IOS_CHROME_BROWSER_METRICS_MODEL_METRICS_APP_INTERFACE_H_
#define IOS_CHROME_BROWSER_METRICS_MODEL_METRICS_APP_INTERFACE_H_
#import <Foundation/Foundation.h>
#include "base/time/time.h"
#include "third_party/metrics_proto/user_demographics.pb.h"
namespace syncher {
// Constant for timeout while waiting for asynchronous sync and UKM operations.
constexpr base::TimeDelta kSyncUKMOperationsTimeout = base::Seconds(10);
} // namespace syncher
// MetricsAppInterface contains the app-side implementation for helpers. These
// helpers are compiled into the app binary and can be called from either app or
// test code.
@interface MetricsAppInterface : NSObject
// Enable/Disable the metrics in the app for test.
// `overrideMetricsAndCrashReportingForTesting` must be called before setting
// the value.
// `stopOverridingMetricsAndCrashReportingForTesting` must be called at the end
// of the test for cleanup.
// `setMetricsAndCrashReportingForTesting:` can be called to enable/disable
// metrics. It returns whether metrics were previously enabled.
+ (void)overrideMetricsAndCrashReportingForTesting;
+ (void)stopOverridingMetricsAndCrashReportingForTesting;
+ (BOOL)setMetricsAndCrashReportingForTesting:(BOOL)enabled;
// Returns whether UKM recording is `enabled`.
+ (BOOL)checkUKMRecordingEnabled:(BOOL)enabled;
// Returns YES if the ReportUserNoisedUserBirthYearAndGender feature is enabled.
+ (BOOL)isReportUserNoisedUserBirthYearAndGenderEnabled [[nodiscard]];
// Returns the current UKM client ID.
+ (uint64_t)UKMClientID;
// Checks whether a sourceID is registered for UKM.
+ (BOOL)UKMHasDummySource:(int64_t)sourceID;
// Adds a new sourceID for UKM.
+ (void)UKMRecordDummySource:(int64_t)sourceID;
// Updates the network time to approximately `now`.
+ (void)updateNetworkTime:(base::Time)now;
// Gets the maximum eligible birth year for reporting demographics based on
// `now`.
+ (int)maximumEligibleBirthYearForTime:(base::Time)now;
// If data are available, creates a UKM Report and stores it in the
// UKM service's UnsentLogStore.
+ (void)buildAndStoreUKMLog;
// Returns YES if the UKM service has logs to send.
+ (BOOL)hasUnsentUKMLogs;
// Returns YES if the UKM service's report has the expected year and gender.
// The year is the un-noised birth year, and the gender corresponds to the
// options in UserDemographicsProto::Gender.
+ (BOOL)UKMReportHasBirthYear:(int)year
gender:(metrics::UserDemographicsProto::Gender)gender;
// Returns YES if the UKM service's report has user demographics.
+ (BOOL)UKMReportHasUserDemographics;
// If data are available, creates an UMA log and stores it in the
// MetricsLogStore.
+ (void)buildAndStoreUMALog;
// Returns YES if the metrics service has logs to send.
+ (BOOL)hasUnsentUMALogs;
// Returns YES if the UMA log has the expected year and gender. The year is the
// un-noised birth year, and the gender corresponds to the proto enum
// UserDemographicsProto::Gender.
+ (BOOL)UMALogHasBirthYear:(int)year
gender:(metrics::UserDemographicsProto::Gender)gender;
// Returns YES if the UMA log has user demographics.
+ (BOOL)UMALogHasUserDemographics;
// Creates a chrome_test_util::HistogramTester that will record every histogram
// sent during test.
+ (NSError*)setupHistogramTester [[nodiscard]];
// Releases the chrome_test_util::HistogramTester.
+ (NSError*)releaseHistogramTester [[nodiscard]];
// We don't know the values of the samples, but we know how many there are.
// This measures the diff from the snapshot taken when this object was
// constructed.
+ (NSError*)expectTotalCount:(int)count
forHistogram:(NSString*)histogram [[nodiscard]];
// We know the exact number of samples in a bucket, but other buckets may
// have samples as well. Measures the diff from the snapshot taken when this
// object was constructed.
+ (NSError*)expectCount:(int)count
forBucket:(int)bucket
forHistogram:(NSString*)histogram [[nodiscard]];
// We know the exact number of samples in a bucket, and that no other bucket
// should have samples. Measures the diff from the snapshot taken when this
// object was constructed.
+ (NSError*)expectUniqueSampleWithCount:(int)count
forBucket:(int)bucket
forHistogram:(NSString*)histogram [[nodiscard]];
// Checks the sum of all samples recorder for `histogram`.
+ (NSError*)expectSum:(NSInteger)sum
forHistogram:(NSString*)histogram [[nodiscard]];
@end
#endif // IOS_CHROME_BROWSER_METRICS_MODEL_METRICS_APP_INTERFACE_H_
Codebase Browser
chromium