update vc docs for android release (#996)

Author: fire-at-will

code_blocks/virtual-currency/vc-balance-sdk-android.java

@@ -0,0 +1,29 @@
+// Fetch virtual currencies
+Purchases.sharedInstance.getVirtualCurrencies(
+    new GetVirtualCurrenciesCallback() {
+        @Override
+        public void onReceived(@NonNull VirtualCurrencies virtualCurrencies) {
+            // TODO: Handle virtual currencies
+        }
+
+        @Override
+        public void onError(@NonNull PurchasesError error) {
+            // TODO: Handle error
+        }
+    }
+);
+
+// Get the details of a specific virtual currency
+VirtualCurrency virtualCurrency = virtualCurrencies.getAll().get("");
+int balance = virtualCurrency.getBalance();
+String name = virtualCurrency.getName();
+String code = virtualCurrency.getCode();
+
+// Keep in mind that serverDescription may be null if no description was provided
+// in the RevenueCat dashboard
+String serverDescription = virtualCurrency.getServerDescription();
+
+// Iterate through all virtual currency balances
+virtualCurrencies.getAll().forEach((key, virtualCurrency) -> {
+    System.out.println(virtualCurrency.getCode() + ": " + virtualCurrency.getBalance());
+});

code_blocks/virtual-currency/vc-balance-sdk-android.kt

@@ -1,10 +1,30 @@
-// Don't forget to opt in to experimental RevenueCat APIs with 
-// @OptIn(ExperimentalPreviewRevenueCatPurchasesAPI::class)
+// Fetch virtual currencies
+// With coroutines
+try {
+    val getVirtualCurrenciesResult: VirtualCurrencies = Purchases.sharedInstance.awaitGetVirtualCurrencies()
+    // TODO: Handle virtual currencies
+} catch(error: PurchasesException) {
+    // TODO: Handle error
+}
 
-// Get the balance of a specific virtual currency
-val balance = customerInfo.virtualCurrencies[<your_virtual_currency_code>]?.balance
+// With callbacks
+Purchases.sharedInstance.getVirtualCurrenciesWith(
+    onError = { error: PurchasesError -> 
+        // TODO: Handle error
+    },
+    onSuccess = { virtualCurrencies: VirtualCurrencies -> 
+        // TODO: Handle virtual currencies
+    },
+)
+
+// Get the details of a specific virtual currency
+val virtualCurrency = virtualCurrencies.all[<your_virtual_currency_code>]
+val balance = virtualCurrency?.balance
+val name = virtualCurrency?.name
+val code = virtualCurrency?.code
+val description = virtualCurrency?.serverDescription
 
 // Iterate through all virtual currency balances
-for((virtualCurrencyCode, virtualCurrencyInfo) in customerInfo.virtualCurrencies) {
-    println("$virtualCurrencyCode: ${virtualCurrencyInfo.balance}")
+for ((virtualCurrencyCode, virtualCurrency) in virtualCurrencies.all) {
+    println("$virtualCurrencyCode: ${virtualCurrency.balance}")
 }

docs/offerings/virtual-currency.mdx

@@ -50,28 +50,7 @@ Virtual currency functionality is available in the native iOS SDK in versions 5.
 
 ### Android
 
-When adding the purchases-android SDK to your app, use the most recent `vc-beta` version when adding `purchases-android` to your `build.gradle`:
-
-[![Latest Virtual Currency Android Beta Release](https://img.shields.io/github/release/RevenueCat/purchases-android.svg?filter=*vc-beta*&style=flat)](https://github.com/RevenueCat/purchases-android/releases)
-
-```kotlin
-// build.gradle
-
-implementation 'com.revenuecat.purchases:purchases:8.14.2-vc-beta.1'
-```
-
-When you use the beta virtual currency features, you’ll need to annotate your function/class with the `@OptIn(ExperimentalPreviewRevenueCatPurchasesAPI::class)` annotation:
-
-import androidExperimentalAPIAnnotationExample from "@site/code_blocks/virtual-currency/vc-android-experimental-api-annotation-example.kt?raw";
-
-<RCCodeBlock
-  tabs={[
-    {
-      type: "kotlin",
-      content: androidExperimentalAPIAnnotationExample,
-    },
-  ]}
-/>
+Virtual currency functionality is available in the native Android SDK in versions 9.1.0 and above.
 
 ### React Native
 
@@ -152,9 +131,11 @@ import content5 from "@site/code_blocks/virtual-currency/balance-response.json?r
 
 #### From the SDK
 
-##### iOS
+##### iOS and Android
 
 import fetchVCBalancesSwift from "@site/code_blocks/virtual-currency/vc-balance-sdk-ios.swift?raw";
+import fetchVCBalancesKotlin from "@site/code_blocks/virtual-currency/vc-balance-sdk-android.kt?raw";
+import fetchVCBalancesJava from "@site/code_blocks/virtual-currency/vc-balance-sdk-android.java?raw";
 
 You can use the `virtualCurrencies()` function to retrieve a customer's balance. The function returns a `VirtualCurrencies` object, which includes the customer's balances along with each virtual currency's metadata.
 
@@ -165,6 +146,16 @@ You can use the `virtualCurrencies()` function to retrieve a customer's balance.
       content: fetchVCBalancesSwift,
       name: "Swift",
     },
+    {
+      type: "kotlin",
+      content: fetchVCBalancesKotlin,
+      name: "Kotlin",
+    },
+    {
+      type: "java",
+      content: fetchVCBalancesJava,
+      name: "Java",
+    },
   ]}
 />
 
@@ -186,21 +177,15 @@ import cachedVirtualCurrenciesSwift from "@site/code_blocks/virtual-currency/cac
   ]}
 />
 
-##### Android, React Native, and Flutter
+##### React Native and Flutter
 
-If you're using the virtual currency SDK betas for Android, React Native, and Flutter, you can fetch the virtual currency balances from the [CustomerInfo](https://www.revenuecat.com/docs/customers/customer-info) object in the SDK:
+If you're using the virtual currency SDK betas for React Native or Flutter, you can fetch the virtual currency balances from the [CustomerInfo](https://www.revenuecat.com/docs/customers/customer-info) object in the SDK:
 
-import fetchVCBalancesKotlin from "@site/code_blocks/virtual-currency/vc-balance-sdk-android.kt?raw";
 import fetchVCBalancesReactNative from "@site/code_blocks/virtual-currency/vc-balance-sdk-react-native.ts.txt?raw";
 import fetchVCBalancesFlutter from "@site/code_blocks/virtual-currency/vc-balance-sdk-flutter.dart?raw";
 
 <RCCodeBlock
   tabs={[
-    {
-      type: "kotlin",
-      content: fetchVCBalancesKotlin,
-      name: "Kotlin",
-    },
     {
       type: "rn",
       content: fetchVCBalancesReactNative,