npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@atala/apollo

v1.3.5

Published

[![Kotlin](https://img.shields.io/badge/kotlin-1.9.22-blue.svg?logo=kotlin)](http://kotlinlang.org) ![badge-license] ![badge-latest-release] [![semantic-release-kotlin]](https://github.com/semantic-release/semantic-release)

Downloads

75

Readme

Apollo

Kotlin badge-license badge-latest-release semantic-release-kotlin

badge-platform-android badge-platform-ios badge-platform-jvm badge-platform-js badge-platform-js-node

A cryptography lib built with Kotlin Multiplatform with support for the following targets:

  • JS
  • iOS
  • Android
  • JVM

How to build Apollo

Set Environment Variables

Set variable GITHUB_ACTOR with your GitHub Username and set variable GITHUB_TOKEN with your GitHub Personal Access Token.

As an example we will go with Bash

  1. Open CMD.
  2. Run sudo nano $HOME/.bash_profile.
  3. Insert export GITHUB_ACTOR="YOUR GITHUB USERNAME"
  4. Insert export GITHUB_TOKEN="YOUR GITHUB PERSONAL ACCESS TOKEN"
  5. Save profile and restart CMD to take effect.

Install Homebrew (Mac Only)

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Install autoconf, automake & libtool (Mac Only)

brew install autoconf automake libtool

Install JDK 11

cs java --jvm adopt:1.11.0-11 --setup

after that java -version should yield something like that

openjdk version "11.0.11" 2021-04-20
OpenJDK Runtime Environment (build 11.0.11+9)
OpenJDK 64-Bit Server VM (build 11.0.11+9, mixed mode)

In case of using macOS with M chip, make sure to install the arch64 version of Java

Install XCode (Mac Only)

Install XCode from App Store.

Then approve xcodebuild license in your terminal. Like so:

$ sudo xcodebuild -license

Install Android SDK

Install Android SDK from SDK Manager (via Android Studio).

Then approve Android SDK license. Like so:

$ cd /Users/{{YOUR USER}}/Library/Android/sdk
$ tools/bin/sdkmanager --licenses

While there are many ways to install Android SDK this has proven to be the most reliable way. Standard IntelliJ with Android plugin may work. However, we've had several issues. Your mileage may vary.

For Ubuntu,

sudo apt update && sudo apt install android-sdk

Leaving the SDK at ~/Android/Sdk

Create local.properties file

Create a file named local.properties in the root of Apollo.

Add your android sdk path to local.properties file. Like so:

sdk.dir = /Users/{{YOUR USER}}/Library/Android/sdk

This will indicate to your IDE which android SDK to use.

Alternatively, you can add the following environment variable into your shell profile file:

$ export ANDROID_HOME='/Users/{{YOUR USER}}/Library/Android/sdk

Building the project

You should be able to import and build the project in IntelliJ IDEA now.

Troubleshooting

Here is a list of common issues you might face and its solutions.

Enviroment Variables were added but not available

If you already added the envorment variable to your CMD profile and still not being available.

Solution

  • Restart your Device.
No binary for ChromeHeadless browser on your platform

If you get error:

No binary for ChromeHeadless browser on your platform.
Please, set "CHROME_BIN" env variable.
java.lang.IllegalStateException: Errors occurred during launch of browser for testing.
- ChromeHeadless

Solution

  • Install headless chrome or just Chrome browser
In case IntelliJ was building but was still showing syntax error in Gradle Script

Solution

  • Go to preference/settings and make sure to select the correct Java version 11.
Could not find JNA native support

if you get this error on macOS with M chip:

Could not find JNA native support

Solution

  • Make sure that you are using Java version that is arch64.

How to use for JVM/Android app

In build.gradle.kts files include the dependency

repositories {
    mavenCentral()
}

For dependencies

dependencies {
    implementation("org.hyperledger.identus:apollo:<latest version>")
}

How to use for Swift app

Using SPM

Inside your Package.swift file, add the following

dependencies: [
    .package(
        url: "[email protected]:input-output-hk/atala-prism-apollo.git",
        from: "<latest version>"
    )
]

Using generated xcframework directly

The following instruction using Xcode 15

  1. Go the Release Page and check the latest version and download the Apollo.xcframework.zip file.
  2. Uncompress the downloaded file.
  3. Add the Apollo.xcframework to your Xcode project.
  4. When asked select Copy items if needed.
  5. Then go to the project configuration page in Xcode and check the Frameworks and Libraries section and add the Apollo.xcframework if not found then choose Embed & Sign.
  6. Then go to the build phase page and mark the framework as required.

[!WARNING] For Intel iOS simulator: You need to add the following flag as YES EMBEDDED_CONTENT_CONTAINS_SWIFT=YES on the target like so:

Package.swift

Package(
   ...
   targets: .testTarget(
      ...
      swiftSettings: [.define("EMBEDDED_CONTENT_CONTAINS_SWIFT=YES")]
      ...
   )
)

How to use for Node.js app

Inside the package.json

{
    "dependencies": {
        "@atala/apollo": "<latest version>"
    }
}

How to use for another KMP (Kotlin Multiplatform) project

Using Groovy

In the project build.gradle

allprojects {
    repositories {
        // along with all the other current existing repos add the following
        mavenCentral()
    }
}

In the module build.gradle

kotlin {
    sourceSets {
        commonMain {
            dependencies {
                // This following is just an example you can import it as per you needs
                implementation 'org.hyperledger.identus:apollo:<latest version>'
            }
        }
    }
}

Using Kotlin DSL

In the project build.gradle.kts

allprojects {
    repositories {
        // along with all the other current existing repos add the following
        mavenCentral()
    }
}
kotlin {
    sourceSets {
        val commonMain by getting {
            dependencies {
                // This following is just an example you can import it as per you needs
                implementation("org.hyperledger.identus:apollo:<latest version>")
            }
        }
    }
}

How to use for Scala project

libraryDependencies += "org.hyperledger.identus" % "apollo-jvm" % "<latest version>"

Usage

Please have a look at unit tests, more samples will be added soon.

Cryptography Notice

This distribution includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country's laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted. See http://www.wassenaar.org/ for more information.

License

This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software. Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely.