versioning of API documentation in SBT - sbt

I am able to publish API docs using sbt-ghpages plugin. But documentation of the plugin doesn't explain how to maintain multiple versions of the API documentation for each release. How to do this with sbt-ghpages or any other alternatives if available.

Related

Unity & Firebase - Google and Facebook Login/SignIn/Authentication Tutorials

For the last couple of days, I have faced an issue with my Unity project regarding adding Google and Facebook authentication for my users, using Firebase. The thing is that there exist a couple of youtube tutorials for each of those two implementations but they are quite misleading and rushed.
Apart from that those tutorials refer to the creation of a new project which implies that the Firebase Auth package is not yet installed. And I mention this because I've seen plenty of people in the comments that are struggling with the Plugins and Parse folders that get overwritten whenever both Firebase Auth and Google or Facebook packages are installed. So there does not exist a rule of thumb on how to proceed in cases where projects already had other methods of authentication such as Email/Password.
Of course, the documentation for both Google and Facebook is unclear on how to get the access token.
Facebook SignIn doc: https://firebase.google.com/docs/auth/unity/facebook-login?hl=en&authuser=0
Google SignIn doc:
https://firebase.google.com/docs/auth/unity/google-signin?hl=en&authuser=0
I've made this post in order to find a step-by-step solution to my problem and hopefully help the community find a solution to a problem that concerns many developers.
[Edit]: My question is. How exactly do I implement the Google & Facebook Sign-In, based on the documentation, that is unclear, especially on the step
Follow instructions for Android and iOS+ to get an access token for the signed-in Facebook user.
And I am speaking for a project that already has imported Firebase.Authentication, which means that folders such as Plugins and Parse are already in the Assets and get overloaded from the packages requested by the 'tutorials' (Because the docs do not even mention what package to use and how).
[Edit]: As of right now I've managed to set up the code in a way that has no errors. When I run it though I get:
[Android]: Exception: Field currentActivity or type signature not found.
[iOS]: EntryPointNotFoundException: GoogleSignIn_Create
After some googling, they proposed testing it after I build it which I think is way too much time-consuming.
This is the answer I've got from Firebase support.
First of all, we need to note that Firebase only has three native authentication providers: email, phone, and anonymous authentication. For the other methods, Firebase needs to trust how their respective third-party providers handle their authentication flow. That's why Firebase can't offer a way to get the access token. This is not its responsibility.
So, to sign in with a Federated provider (FP) you must follow the following steps.
Think about which will be your target mobile platform. Not all the FP provide the same authentication flow on iOS or Android. For example Google offers a more handy way to authenticate Android devices by using Google Play Game Services
Authenticate in Unity Using Google Play Games Services | Firebase
Search on his FP's official GitHub repository for the official plugins to get access to the FP's SDK on Unity. For example, Google offer a useful plugin to authenticate user in both platforms
GitHub - googlesamples/google-signin-unity: Google Sign-In API plugin for Unity game engine. Works with Android and iOS.
Last plugin's release: https://github.com/googlesamples/google-signin-unity/releases/tag/v1.0.4
Examples - Unity SDK - Documentation - Meta for Developers
Create the FP credentials according to its own requirements. For example, Google login requires the use of web_client_id, which can be obtained from the google-services.json or GoogleService-Info.plist files needed to build the application on the target platform.
https://github.com/googlesamples/google-signin-unity#get-a-google-sign-in-configuration-file
https://github.com/googlesamples/google-signin-unity#using-this-plugin-with-firebase-auth
Once you've built the FP's credential into your project, it's time to check out our Firebase documentation for using the FP credential in our authentication flow. I recommend having the Firebase reference along with the documentation as it will help to know what arguments the required method needs.
The best way to test your new authentication provider is by implementing the Firebase Authentication Unity Quickstart. Please clone the Unity Quickstart repository here and deploy the Unity project found in the auth folder. Follow the steps mentioned in the README.md file and build the app on your target platform.
I recommend that you add the FP's SDK right in the same step as adding the Firebase SDK plugins to avoid some build issues. Since these errors are more related to Unity than Firebase, I recommend reaching out to our communities on StackOverflow, Google Groups, and Slack for help with these issues as they have more knowledge than I on those topics.
So, in conclusion, getting credentials from third-party providers is a task delegated to them and not to Firebase since this one is not responsible for any third-party authentication flow.

monetizing APIs in WSO2 API Manager

For my use case, I need to enable monetization feature in wso2am 4.0.0. the solution which is explained in documentation limits us to use stripe as a billing engine ( other mentioned solution i.e. implementing Monetization interface is difficult!!). Stripe is not free and open source. Has anyone found any other solution for handling monetization?

crnk json implementation Java API Doc

We are using crnk JSON API implementation on the server side (Java). I see the crnk documentation here http://www.crnk.io/documentation/. But, I am not able to find the corresponding Java API Reference documentation. Not sure if there is on available ?
no, so far it is not available. but could be added as PR. release automation is currently in progress and the asciidoc documentation already gets automatically published. Adding JavaDoc next to it would be a minor effort.

How to add javascript code to google functions

I want to write a google cloud function that will respond to POST requests. I want to write it in Javascript.
I've found Google's tutorial on how to do it, but at the beginning of the tutorial it says that this is a deprecated thing, and I have to do it using Cloud Endpoints Frameworks for App Engine. However, the link they provide doesn't help.
Any ideas on how to write a javascript google cloud function?
Link to the tutorial that I've found:
https://cloud.google.com/endpoints/docs/frameworks/legacy/v1/python/getstarted/clients/js/add_javascript
The warning that's displayed at the beginning of the tutorial:
Cloud Endpoints Frameworks v1 has been deprecated and will be shut
down on August 2, 2018. We recommend that you use the latest version
of this feature, which is renamed to Cloud Endpoints Frameworks for
App Engine. This new version supports App Engine standard environment,
provides lower latency, and has better integration with App Engine.
For more details, see Migrating to 2.0.
The migration link points to https://cloud.google.com/endpoints/docs/frameworks/legacy/v1/python/migrating
There are two completely different things you're talking about here.
Google Cloud Functions is a serverless way to write functions in Javascript which respond to HTTP requests.
Google Cloud Endpoints Frameworks for App Engine is a way to write App Engine applications in Python or Java which respond to HTTP requests.
The first link you provide is about writing browser-side JavaScript code which calls an Endpoints service. The corresponding link for the Endpoints 2.0 product is here.
Depending on what you actually want to do, you should consult one or more of these links.

how to get googleTokenID and googleAccessToken in Firebase Authentication on Unity

On the official documentation of Firebase Authentication, the guide is only available on how you can get the googleAccessToken on native Android & iOS. No solution is available for Unity on their official guide.
The closest solution I have found is to use the Google Play Services plugin for Unity to get the access token, which is not a good solution for the cross-platform as the following plugin is deprecated on the iOS platform. So yah, your code will not work on iOS.
Also, I believe it's an expensive solution to add a plugin for a "googleIdToken".
This process is complicated and Firebase documentation is not helping.
To address this issue Google recently released Google Sign-In plugin for Unity.
You can find detailed instructions on the read me file.
https://github.com/googlesamples/google-signin-unity
The fire base documentation seems to have a unity SDK to achieve what you're wanting to do.
You then include the GoogleService-Info.plist for ios.
https://firebase.google.com/docs/unity/setup
https://firebase.google.com/docs/unity/setup#add_the_sdk_to_your_app
the GoogleService-Info.plist for ios is in your google console.

Resources