#Amigo Usage
Amigo is a hotfix library which can hotfix almost everything for your app.
In your project's build.gradle
dependencies {
classpath 'me.ele:amigo:0.1.0'
}
In your module's build.gradle
apply plugin: 'me.ele.amigo'
you are good to go now, as simple as this.
- sync with jcenter may take some time, if amigo cannot be found, please add my private maven url into your buildscript
buildscript {
repositories {
maven {
url "https://dl.bintray.com/jackcho/maven"
}
jcenter()
...
}
}
- Instant Run conflicts with Amigo, so disable Instant Run when used with amigo
There are two ways to make hotfix work.
-
if you don't need hotfix work immediately
you just need to download new apk file to /data/data/{your pkg}/files/amigo/demo.apk, when app restarts next time, hotfix apk will be loaded as fresh as new.
Amigo.workLater(context); // or Amigo.workLater(context, apkFile);
-
work immediately, app will restart immediately
Amigo.work(context); // or Amigo.work(context, apkFile);
Amigo.clear(context);
note:The old apk would be cleared automatically when the latest version updated.
some time-tense operation is handled in a new process with an activity, you may customize it
<meta-data
android:name="amigo_layout"
android:value="{your-layout-name}" />
<meta-data
android:name="amigo_theme"
android:value="{your-theme-name}" />
-
support new
activity
&receiver
in beta,service
&provider
is not supported for nowclasspath 'me.ele:amigo:0.0.6-beta1' ...
-
app launcher activity's name cannot be changed
-
RemoteViews
's layout change innotification
&widget
is not support -
may conflict with google play terms
-
the only limit is your imagination
if you try to experience Amigo's magic, you can integrate with your own app as you like; also you can play with this app demo following the procedures below.
- ./gradlew clean assembleRelease & adb install .../build/outputs/apk/app-release.apk
- change code wherever you like & ./gradlew clean assembleRelease
- adb push .../build/outputs/apk/app-release.apk /sdcard/demo.apk
- click the "apply patch apk" button, and see the changes you made then.
-
make it simple, you just need a fully new apk
-
for user's network traffic's sake, you may just want to download a diff file bspatch is an option for you
Copyright 2016 ELEME Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.