# android-jsc

**Repository Path**: littocats/android-jsc

## Basic Information

- **Project Name**: android-jsc
- **Description**: Scripts for building JSC for Android
- **Primary Language**: Unknown
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2015-10-21
- **Last Updated**: 2024-05-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# JSC build scripts for Android

This repository contains scripts for building the JSC library for Android. The build scripts bundle JSC as a shared library into an [Android AAR](http://tools.android.com/tech-docs/new-build-system/aar-format) file, which makes it easy to use it in Android projects built with [Buck](https://buckbuild.com) or [Gradle](https://gradle.org).

## Requirements
 * OS X or Linux - the build process have not been tested on other platforms.
 * Android dev environment setup ([SDK](https://developer.android.com/sdk/installing/index.html?pkg=tools) + [NDK](https://developer.android.com/ndk/guides/setup.html))
 * [Buck](https://buckbuild.com) - configured to work with Android (see [Quick Start](https://buckbuild.com/setup/quick_start.html) for instructions)
 * [Maven](https://maven.apache.org/download.cgi) (3.2+)
 * Used command line utilities: [ruby](https://www.ruby-lang.org/) (2.0+), zip, curl

## Build instructions

**1. Use the following script to pull in sources for [JSC](https://www.webkit.org) and [ICU](http://site.icu-project.org)**
```bash
./fetch_sources.sh
```

**2. Build the AAR with Buck (this may take a while)**
```bash
buck build :android-jsc
```
As build step may take a while, consider using `--num-threads` or `--load-limit` options of `buck` command. This may slow the build process down, but should let you use your computer with less hiccups while the build is running.

**3. Install the AAR in you local maven repository:**
```bash
./install.sh
```

## Use the android-jsc AAR

After installation, the android-jsc AAR file should be accessible through maven:

**1. Using BUCK**
```python
remote_file(
  name = 'android-jsc',
  url = 'mvn://org.webkit:android-jsc:r174650',
  sha1 = 'd4b32ee79922794b04bfbbcde0cf9572baaa1b84',
)
```

**2. Using gradle**
```groovy
compile 'org.webkit:android-jsc:r174650'
```

The resulting AAR can be also located in your local maven repository (usually under `~/.m2/repository/org/webkit/android-jsc/`)