# appc-aar-transform

> Transforms Android Archive files

Latest version **1.0.0** (published 2017-02-03) · SEE LICENSE IN LICENSE.txt license · 0 weekly downloads

## Install

```sh
npm install appc-aar-transform
pnpm add appc-aar-transform
yarn add appc-aar-transform
bun add appc-aar-transform
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.0 |
| Published | 2017-02-03 |
| First published | 2017-02-03 |
| Weekly downloads | 0 |
| License | SEE LICENSE IN LICENSE.txt |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 6 |
| Known vulnerabilities | 0 (+18 in 2 direct dependencies) |
| Install scripts | no |
| Author | Appcelerator, Inc. |
| Maintainers | appcelerator |
| Keywords | appcelerator, aar, transform, android |

## Links

- npm: https://www.npmjs.com/package/appc-aar-transform
- Repository: https://github.com/appcelerator/appc-aar-transform
- Homepage: http://github.com/appcelerator/appc-aar-transform
- Issues: https://jira.appcelerator.org/browse/TIMOB
- npm.io page: https://npm.io/package/appc-aar-transform

## Dependencies (6)

- [async](https://npm.io/package/async.md) ^2.1.4
- [xmldom](https://npm.io/package/xmldom.md) ^0.1.27
- [findit2](https://npm.io/package/findit2.md) ^2.2.3
- [fs-extra](https://npm.io/package/fs-extra.md) ^1.0.0
- [node-appc](https://npm.io/package/node-appc.md) ^0.2.39
- [extract-zip](https://npm.io/package/extract-zip.md) ^1.6.0

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 1.0.0 (latest) — 2017-02-03

## README

# AAR Transform
Extract and copy the contents from Android Archive (.aar) files.

## Installation
`npm install appc-aar-transform`

## Usage
This module is used to extract the contents of an Android Archive (.aar) to a desired location and optionally copy any bundled assets and libraries to a new location.

```js
var AarTransformer = require('appc-aar-transform');
var transformer = new AarTransformer(logger) // logger is optional, can be any bunyan based logger
transformer.transform(options, function(err, result) {
  console.log(result.packageName); // package key from AndroidManifest.xml
  console.log(result.jars); // array of JAR files found in the Android Archive
});
```

### Options

| Option | Type | Description |
|--------|------| ------------|
| `aarPathAndFilename` | String | The path and filename pointing to the .aar file to process. |
| `outputPath` | String | Base directory where the .aar file will be extracted to. The actual content will be extracted into a sub-directory (basename of the AAR file). |
| `assetsDestinationPath` | String | (Optional) Copy all assets contained in the .aar to this path. |
| `libraryDestinationPath` | String | (Optional) Copy all libraries (.jar) contained in the .aar to this path. |
| `sharedLibraryDestinationPath` | String | (Optional) Copy all shared libraries (.so) contained in the .aar to this path. |

## Contributing

This is an open source project. Please consider forking this repo to improve,
enhance or fix issues. If you feel like the community will benefit from your
fork, please open a pull request.

To protect the interests of the contributors, Appcelerator, customers
and end users we require contributors to sign a Contributors License Agreement
(CLA) before we pull the changes into the main repository. Our CLA is simple and
straightforward - it requires that the contributions you make to any
Appcelerator open source project are properly licensed and that you have the
legal authority to make those changes. This helps us significantly reduce future
legal risk for everyone involved. It is easy, helps everyone, takes only a few
minutes, and only needs to be completed once.

[You can digitally sign the CLA](http://bit.ly/app_cla) online. Please indicate
your e-mail address in your first pull request so that we can make sure that
will locate your CLA. Once you've submitted it, you no longer need to send one
for subsequent submissions.

## License

This project is open source and provided under the [Apache Public License
(version 2)](https://tldrlegal.com/license/apache-license-2.0-(apache-2.0)).

Copyright (c) 2017, [Appcelerator](http://www.appcelerator.com/) Inc. All Rights Reserved.

---
_Source: https://npm.io/package/appc-aar-transform · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._