Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Android] Update README for instructions #789

Merged
merged 2 commits into from
May 15, 2024
Merged

[Android] Update README for instructions #789

merged 2 commits into from
May 15, 2024

Conversation

kirklandsign
Copy link
Contributor

@kirklandsign kirklandsign commented May 13, 2024

The Android instructions on the readme page need to be atomic and have everything the user needs right there on the page (no external links should be required).

It should follow a similar flow as the iOS here.
https://github.com/pytorch/torchchat/blob/documentation-cleanup/README.md

Copy link

pytorch-bot bot commented May 13, 2024

🔗 Helpful Links

🧪 See artifacts and rendered test results at hud.pytorch.org/pr/pytorch/torchchat/789

Note: Links to docs will display an error until the docs builds have been completed.

❌ 2 New Failures, 1 Pending

As of commit 269f755 with merge base 9bd4f5c (image):

NEW FAILURES - The following jobs have failed:

This comment was automatically generated by Dr. CI and updates every 15 minutes.

@facebook-github-bot facebook-github-bot added the CLA Signed This label is managed by the Meta Open Source bot. label May 13, 2024
README.md Outdated Show resolved Hide resolved
@kirklandsign kirklandsign requested a review from mikekgfb May 13, 2024 21:32
Copy link
Contributor

@mikekgfb mikekgfb left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you!

@mikekgfb mikekgfb merged commit 9e4e0a3 into main May 15, 2024
41 of 42 checks passed
@mikekgfb mikekgfb deleted the android-docs branch May 15, 2024 00:17
[executorch-llama.aar](https://ossci-android.s3.us-west-1.amazonaws.com/executorch/release/0.2/executorch-llama.aar) (SHASUM: 09d17f7bc59589b581e45bb49511d19196d0297d)

```
curl https://ossci-android.s3.us-west-1.amazonaws.com/executorch/release/0.2/executorch-llama.aar -o android/Torchchat/app/libs/executorch.aar
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

command should include the --create-dirs otherwise it will fail to a brand new user


![Screenshot](https://pytorch.org/executorch/main/_static/img/android_llama_app.png
"Android app running Llama model")
The torchchat app skeleton is located at `android/Torchchat`. Use Android Studio to open this directory.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

if the .aar file doesn't exist before you open the project and download it later, users will not be able to run. Users should run the curl command before opening the project.

echo "09d17f7bc59589b581e45bb49511d19196d0297d android/Torchchat/app/libs/executorch.aar" | shasum --check
```

Then, click the Play button (^R) to launch it to emulator/device.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the app crashes right away in the simulator. Re-opening the app crashes again

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you have the crash log?

Alternatively, you can run `scripts/android_example.sh` which sets up Java, Android SDK Manager, Android SDK, Android emulator, builds the app, and launches it for you.

```
export TORCHCHAT_ROOT=$(pwd)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

command fails for me
Android sdkmanager is set up

  • return
  • setup_android_sdk
  • sdkmanager 'platforms;android-34'
    scripts/android_example.sh: line 79: sdkmanager: command not found

malfet pushed a commit that referenced this pull request Jul 17, 2024
* [Android] Update README for instructions

* Update download instruction
malfet pushed a commit that referenced this pull request Jul 17, 2024
* [Android] Update README for instructions

* Update download instruction
malfet pushed a commit that referenced this pull request Jul 17, 2024
* [Android] Update README for instructions

* Update download instruction
malfet pushed a commit that referenced this pull request Jul 17, 2024
* [Android] Update README for instructions

* Update download instruction
malfet pushed a commit that referenced this pull request Jul 17, 2024
* [Android] Update README for instructions

* Update download instruction
malfet pushed a commit that referenced this pull request Jul 17, 2024
* [Android] Update README for instructions

* Update download instruction
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
CLA Signed This label is managed by the Meta Open Source bot.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants