asgardeo/mobile-ui-sdks

Mobile SDKs for authentication and building customizable login UIs for Asgardeo & WSO2 Identity Server.

Mobile SDKs for Asgardeo

This repository holds the mobile SDKs to support the integreation of your mobile application with Asgardeo.

Packages

Package	Description	Version
🤖 Android	Android SDK for Asgardeo
🍎 iOS	iOS SDK for Asgardeo	In Development
🐦 Flutter	Flutter SDK for Asgardeo	In Development

Documentation

For more information on how to use each SDK, check out the following documentation.

• 🤖 Android

Development Guide for Documentation Site

The details about the development guide for the documentation site can be found here.

Contributing

Want to report a bug, contribute some code, or improve the documentation?

Excellent! Read up on our guidelines for contributing to get started.

License

Licenses this source under the Apache License, Version 2.0 LICENSE, You may not use this file except in compliance with the License.

mobile-ui-sdks's Issues

Add Asgardeo Android SDK error handling part to the documentation

Description:
Currently in the mobile-ui-sdks documentation it does not have the error handling part of the Android SDK. To give a good developer experience it is necessary to add this part to the documentation.

Add developer documentation for `docs` website.

Description:
Currently in the mobile-ui-sdks repository, there is no developer documentation for the project, which would makes it difficult for the developers who will be working on this to further make changes to the project. Hence it is necessary to add a developer documentation for this project.

`Coming Soon` logos not responsive for smaller screen sizes.

Description:
Currently in the Asgardeo mobile ui SDKs the Coming Soon logos are not responsive for smaller screen sizes. This need to be fixed to give a good user experience for the users.

Add developer documentation for the Asgardeo Android SDK.

Description:
Currently the developer documentation for the Asgardeo Android SDK is very limited, which makes it difficult for the developers to develop on the Asgardeo Android SDK. Hence it is recommended to improve the developer documentation on the Asgardeo Android SDK.

Migrate Android SDK to Kotlin 2.0

Description:
Need to migrate Asgardeo Android SDK to Kotlin 2.0, since it is written using Kotlin 1.9.

Add PR Builder check for the Asgardeo-Android SDK

Description:
Currently there are no PR builder for the Asgardeo-Android SDK, which it difficult for the maintainers to properly maintain the repository. Hence it is suggested to add a PR builder for the Asgardeo-Android SDK.

Add lint checks for the Asgardeo-Android-SDK project.

Description:
To improve the code quality of the Asgardeo-Android SDK project, it is recommended to integrate lint checks for that project.

Remove the reliance of `callbackUriHost` and `callbackUriScheme` when those values are not using.

Description:
Currently in the Android SDK, we need to add callbackUriHost and callbackUriScheme to setup even those values are not using.

ex:

android.defaultConfig.manifestPlaceholders = [
    'appAuthRedirectScheme': 'wso2sample',
    'callbackUriHost': '',
    'callbackUriScheme': ''
]

This can be an overhead for the developer. Therefore we need to fix this by removing the necessity on adding the callbackUriHost and callbackUriScheme when those values are not using.

Improve error messages in the Asgardeo-Android SDK

Description:
Currently in the Asgardeo-Android SDK the error messages can displayed are not very informative. The error message coming from Asgardeo is not properly embed into the error object, which makes it difficult for the developers who will be working on the Asgardeo-Android SDK to properly handle errors.

How to solve this:

The most important that this issue should be fixed is where Asgardeo send FAIL_INCOMPLETE status. The error message send from the Asgardeo need to be embed into the exception object.

Exact place in the SDK where to solve

In the manageStateOfAuthorizeFlow function int the FlowManagerImpl class, embed the error message sent from the Asgardeo to the FlowManagerException in the FlowStatus.FAIL_INCOMPLETE.flowStatus.