https://github.com/circlefin/w3s-android-sample-app-wallets
https://github.com/circlefin/w3s-android-sample-app-wallets
Last synced: over 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/circlefin/w3s-android-sample-app-wallets
- Owner: circlefin
- License: apache-2.0
- Created: 2023-06-30T20:51:56.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2024-07-23T10:46:05.000Z (about 2 years ago)
- Last Synced: 2025-03-28T03:51:09.408Z (over 1 year ago)
- Language: Kotlin
- Homepage:
- Size: 56.4 MB
- Stars: 22
- Watchers: 12
- Forks: 31
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Circle Programmable Wallet SDK for Android - Sample
> Sample app for integrating Circle Programmable Wallet SDK.
- Bookmark
- [Requirement](#requirement)
- [Run the Sample App](#run-the-sample-app)
---
## Requirement
1. Java 17 is required for the sample app.
## Run the Sample App
You can install [the latest APK](https://github.com/circlefin/w3s-android-sample-app-wallets/blob/master/app/build/outputs/apk/debug/app-debug.apk) or follow the instructions below to run on a device / emulator directly.
1. Open the project by [Android Studio](https://developer.android.com/studio): File ➜ Open ➜ choose the project root folder.
2. Edit `values/config.xml` ➜ `pw_app_id` to fill in your `APP ID`
3. Add/Edit `local.properties` in the project's root with the following maven repository settings:
```properties
pwsdk.maven.url=https://maven.pkg.github.com/circlefin/w3s-android-sdk
pwsdk.maven.username=
# Fine-grained personal access tokens or classic with package read permission.
pwsdk.maven.password=
```
> **Note**
> When pasting the values above for `` and ``, make sure to not surround the values with quotes.
- Check the following links for creating PAT.
- [Creating a personal access token (classic)](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-personal-access-token-classic)
- [Creating a fine-grained personal access token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-fine-grained-personal-access-token)
4. If there's no error after Gradle sync, select a device and click `Debug 'app'`.
5. There are three tabs corresponding to different login methods. Fill in the `App ID` and fill in the relevant fields in each tab according to the requirements of different login methods for following execution action.
6. (Optional) Auth configs setup. If you want to use social login for test , please follow below steps to and Social login infos.
- [Google and Facebook] Add/Edit value with a specific key-name in `strings.xml` (please refer to the sample strings.xml below)
```properties
YOUR_GOOGLE_WEB_CLIENT_ID
YOUR_FACEBOOK_APP_ID
your_fb_protocol_scheme
YOUR_FACEBOOK_CLIENT_TOKEN
```
- [Apple] Add your Apple `service-id` as manifestPlaceholders to app’s `build.gradle`
```properties
android {
defaultConfig {
…
…
manifestPlaceholders = [appAuthRedirectScheme: 'YOUR_APPLE_SERVICE_ID']
}
}
```