Installation

Installation

This guide explains how to add SORA to your Android project.

---

Requirements

Before installing SORA, ensure your project meets the following requirements:

Requirement	Version
Android API	21+
Target SDK	34
Java	8 or later
Recommended	Java 11

---

Add JitPack Repository

SORA is distributed through JitPack.

Add the JitPack repository to your project's settings.gradle file:

dependencyResolutionManagement {
    repositories {
        mavenCentral()
        maven {
            url 'https://jitpack.io'
        }
    }
}

If your project uses the legacy Gradle repository configuration, add JitPack to the root build.gradle repositories block instead.

---

Add the Dependency

Add SORA to your module-level build.gradle file:

dependencies {
    implementation "com.github.EKITEAM:SORA:1.0.5"
}

Sync your project after adding the dependency.

---

Internet Permission

SORA loads images from remote URLs and therefore requires Internet access.

Add the following permission to your Android manifest:

<uses-permission android:name="android.permission.INTERNET" />

Example:

<manifest ...>
&lt;uses-permission
    android:name=&quot;android.permission.INTERNET&quot; /&gt;

&lt;application
    ...&gt;

&lt;/application&gt;

</manifest>

---

Verify Installation

Create an ImageView in your layout:

<ImageView
    android:id="@+id/imageView"
    android:layout_width="200dp"
    android:layout_height="200dp" />

Load an image using SORA:

ImageView imageView = findViewById(R.id.imageView);
ImageLoader.with(this)
.load("https://example.com/image.jpg")
.into(imageView);

If the image appears successfully, SORA has been installed correctly.

---

Dependency Information

Current stable version:

com.github.EKITEAM:SORA:1.0.5

Repository:

https://jitpack.io/#EKITEAM/SORA

---

Troubleshooting

Dependency Cannot Be Resolved

Make sure:

• JitPack is added to your repositories.
• You are using the correct artifact coordinates.
• Gradle sync completed successfully.
• Your internet connection is available.

---

Images Do Not Load

Verify that:

• The device has internet access.
• The URL is valid and publicly accessible.
• The INTERNET permission is declared in the manifest.
• The request uses a supported image format.

---

Build Errors

Try the following:

./gradlew clean

Then rebuild the project.

If the issue persists, open an issue on GitHub and include:

• Android Studio version
• Gradle version
• Android API level
• Complete stack trace

---

Next Steps

After installation, continue with:

1. Quick Start
2. Request Builder
3. Cache Management
4. SVG Support

These guides cover the core functionality of SORA and recommended usage patterns.