Syncing changes from private repository

Author: helium-service

.github/pull_request_template.md

@@ -0,0 +1,14 @@
+# Changelog
+All notable changes to this project will be documented in this file using the standards as defined at [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0).
+
+### Version 1.0.1 *(2024-08-01)*
+Added:
+
+- `ApplicationPreferences` a data storage registry focused on Chartboost SDKs and their context.
+
+### Version 1.0.0 *(2024-01-26)*
+
+First version of Chartboost Utilities package for Unity.
+
+Added:
+- General Chartboost shared constants an extension methods.

CHANGELOG.md

@@ -0,0 +1,75 @@
+# Contributing to Chartboost Core
+
+We value each contribution provided by the community and strive to achieve the following goals for the most optimal contribution experience:
+
+- Maintain the SDK's quality.
+- Fix problems that are important to users.
+- Enable a sustainable system for the SDK's maintainers to review contributions.
+
+Therefore, this document will note specific steps and details required for you to contribute. 
+
+## How Can I Contribute?
+
+There are two ways to contribute:
+- [Reporting Bugs](#reporting-bugs)
+- [Pull Requests](#pull-requests)
+
+### Reporting Bugs
+Bugs are tracked as a type of [GitHub issues](https://guides.github.com/features/issues/). To submit a report, create an issue and provide the information instructed in the template.
+
+> **Note:** If you find a **Closed** issue that seems similar to what you're experiencing, open a new issue and include a link to the closed issue.
+
+Follow these guides to create a detailed and effective report for us to understand and resolve issues faster: 
+
+* **Use a clear, concise, and descriptive title** for the issue that identifies the problem.
+* **Describe the steps with as much concise detail as possible to reproduce the problem**. For example, start by explaining how the Chartboost Core SDK was initialized and the method calls invoked afterwards.
+* **Provide specific examples to demonstrate each step**. Include links to files, screenshots, Charles logs, or copy/pasteable code snippets used in those examples. Use [markdown code blocks]([https://help.github.com/articles/markdown-basics/#multiple-lines](https://help.github.com/articles/markdown-basics/#multiple-lines)) when providing snippets.
+* **Describe the behavior(s) observed** and explain why that behavior is a problem.
+* **Describe the behavior(s) expected.**
+* **Include screenshots and animated GIFs** of the described steps and behaviors that demonstrate the problem.
+* **If you're reporting a crash**, include the crash report with a stack trace and in the issue using either a [code block](https://help.github.com/articles/markdown-basics/#multiple-lines), [file attachment](https://help.github.com/articles/file-attachments-on-issues-and-pull-requests/), or [gist](https://gist.github.com/) link.
+* **If the problem is related to performance or memory**, include a CPU profile capture.
+* **If the problem wasn't triggered by a specific action**, describe what you were doing before the problem happened.
+
+### Pull Requests
+In order to submit pull requests, you are required to review and sign the [Contribution License Agreement (CLA)](https://developers.chartboost.com/docs/mediation-contribution-license-agreement) which is available on the Chartboost website to view. Once you have read the agreement, sign the appropriate form depending on whether you are an individual an employer contributor.
+
+- [Individual contributor license agreement form](https://na3.docusign.net/Member/PowerFormSigning.aspx?PowerFormId=159c66e8-610c-4afc-9330-15bc2217c291&env=na3&acct=9c982e12-8675-45df-9d81-95fe3656e695&v=2).
+_You wish to contribute on your own behalf as an individual._
+
+- [Employer contributor license agreement form](https://na3.docusign.net/Member/PowerFormSigning.aspx?PowerFormId=73009870-c5f9-483f-b21c-eb3a222d2d6b&env=na3&acct=9c982e12-8675-45df-9d81-95fe3656e695&v=2).
+_You wish to contribute on behalf of your employer._
+
+#### Submitting a Pull Request
+Follow these steps to have your contribution considered by the maintainers:
+
+1. Review and sign the [Contribution License Agreement (CLA)](https://developers.chartboost.com/docs/mediation-contribution-license-agreement).
+2. Identify the issue related to your fix. If an issue doesn't exist, then create a new issue.
+3. Create a pull request. 
+4. Format the title starting with the issue number, followed by a brief description of the fix. _Example: `[ISSUE-60] Fix null pointer exception`._
+5. Follow the [style guides](#style-guides) in your pull request.
+6. Submit your pull request.
+7. Verify that all [status checks](https://help.github.com/articles/about-status-checks/) are passing. If a status check is failing and you believe that the failure is unrelated to your change, then leave a comment on the pull request explaining why you believe the failure is unrelated. A maintainer will re-run the status check. If we conclude that the failure was a false positive, then we will open an issue to track the problem with our status check suite.
+
+While the prerequisites above must be satisfied before your pull request is reviewed, the reviewer(s) may ask you to complete additional design work, tests, or other changes before your pull request can be accepted.
+
+## Style Guides
+
+### Git Commit Messages
+
+* Use the present tense ("Add feature" not "Added feature")
+* Use the imperative mood ("Move cursor to..." not "Moves cursor to...")
+* Limit the first line to 72 characters or less
+* Reference issues and pull requests liberally after the first line
+ 
+### Kotlin
+
+Follow the Android developers [Kotlin style guide](https://developer.android.com/kotlin/style-guide).
+
+### Swift
+
+Follow Google's [Swift style guide](https://google.github.io/swift/).
+
+### C#
+
+Follow Microsoft's [C# coding conventions guide](https://learn.microsoft.com/en-us/dotnet/csharp/fundamentals/coding-style/coding-conventions).

CHANGELOG.md.meta

@@ -1,8 +1,8 @@
-<?xml version="1.0" encoding="utf-8"?>
+<?xml version="1.0" encoding="utf-8"?>
 <package>
   <metadata>
     <id>Chartboost.CSharp.Utilities.Unity</id>
-    <version>1.0.0</version>
+    <version>1.0.1</version>
     <title>Chartboost Utilities for Unity</title>
     <description>Reusable Utilities for Chartboost's Unity Projects</description>
     <authors>Chartboost</authors>
@@ -12,5 +12,8 @@
     <copyright>Copyright 2024</copyright>
     <tags>Chartboost, Ads, Mediation, Unity, cs</tags>
     <repository type="git" url="https://github.com/ChartBoost/chartboost-unity-utilities"/>
+    <dependencies>
+      <dependency id="Chartboost.CSharp.Logging.Unity" version="1.0.0" />
+    </dependencies>
   </metadata>
 </package>

CONTRIBUTING.md

@@ -0,0 +1,16 @@
+{
+    "name": "Chartboost.Utilities.Dependencies",
+    "rootNamespace": "",
+    "references": [],
+    "includePlatforms": [
+        "Editor"
+    ],
+    "excludePlatforms": [],
+    "allowUnsafeCode": false,
+    "overrideReferences": false,
+    "precompiledReferences": [],
+    "autoReferenced": true,
+    "defineConstraints": [],
+    "versionDefines": [],
+    "noEngineReferences": false
+}

CONTRIBUTING.md.meta

@@ -0,0 +1,26 @@
+using UnityEditor;
+using UnityEditor.PackageManager;
+
+namespace Dependencies
+{
+    /// <summary>
+    /// Helper class that allows installation of any additional dependencies that are available to install using Unity Package Manager(UPM)
+    /// This would allow installation of UPM based packages even when sdk is not installed using UPM
+    /// </summary>
+    [InitializeOnLoad]
+    public static class DependencyInstaller
+    {
+        private const string NewtonSoftJsonDependency = "com.unity.nuget.newtonsoft-json";
+        private const string NewtonSoftJsonVersion = "3.2.1";
+
+        private static readonly string[] DependencyPackages = {
+            $"{NewtonSoftJsonDependency}@{NewtonSoftJsonVersion}"
+        };
+        
+        static DependencyInstaller()
+        {
+            foreach (var package in DependencyPackages) 
+                Client.Add(package);
+        }
+    }
+}