Skip to content

Enable Android API 23+ support by using AviatorScript interpreter mode #509

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.

Sign up for GitHub

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

Closed
Copilot wants to merge 2 commits into from
Closed

Enable Android API 23+ support by using AviatorScript interpreter mode #509

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
682cfd9
Initial plan
Copilot Feb 5, 2026
2dc4fdd
Configure AviatorScript to use interpreter mode for Android API 23+ c…
Copilot Feb 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -120,6 +120,12 @@ For Maven:
</dependency>
```

### Android Compatibility

jCasbin is fully compatible with Android API 23+ (Android 6.0 Marshmallow and later). The library uses AviatorScript in **interpreter mode** to ensure compatibility with older Android versions that don't support MethodHandle APIs (which require API 26+).

No special configuration is needed - jCasbin automatically uses interpreter mode for all platforms, making it safe to use on Android devices running API 23 and above.

## Documentation

https://casbin.org/docs/overview
Expand Down
3 changes: 2 additions & 1 deletion src/main/java/org/casbin/jcasbin/main/CoreEnforcer.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,7 @@
import com.fasterxml.jackson.databind.ObjectMapper;
import com.googlecode.aviator.AviatorEvaluator;
import com.googlecode.aviator.AviatorEvaluatorInstance;
import com.googlecode.aviator.EvalMode;
import com.googlecode.aviator.Expression;
import com.googlecode.aviator.runtime.type.AviatorFunction;
import org.casbin.jcasbin.effect.DefaultEffector;
Expand Down Expand Up @@ -76,7 +77,7 @@ void initialize() {
autoSave = adapter instanceof FileAdapter ? false : true;
autoBuildRoleLinks = true;
dispatcher = null;
aviatorEval = AviatorEvaluator.newInstance();
aviatorEval = AviatorEvaluator.newInstance(EvalMode.INTERPRETER);
initRmMap();
initBuiltInFunction();
}
Expand Down
3 changes: 2 additions & 1 deletion src/test/java/org/casbin/jcasbin/main/BuiltInFunctionsUnitTest.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@

import com.googlecode.aviator.AviatorEvaluator;
import com.googlecode.aviator.AviatorEvaluatorInstance;
import com.googlecode.aviator.EvalMode;
import org.casbin.jcasbin.util.BuiltInFunctions;
import org.casbin.jcasbin.util.Util;
import org.testng.annotations.Test;
Expand Down Expand Up @@ -248,7 +249,7 @@ public void testEvalFunc() {
testEval("r_sub.name == 'alice'", env, null, true);
testEval("r_sub.name == 'bob'", env, null, false);

AviatorEvaluatorInstance aviatorEval = AviatorEvaluator.newInstance();
AviatorEvaluatorInstance aviatorEval = AviatorEvaluator.newInstance(EvalMode.INTERPRETER);
aviatorEval.addFunction(new FunctionTest.CustomFunc());
env.put("r_obj", "/test/url1/url2");

Expand Down
3 changes: 2 additions & 1 deletion src/test/java/org/casbin/jcasbin/main/ManagementAPIUnitTest.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@

import com.googlecode.aviator.AviatorEvaluator;
import com.googlecode.aviator.AviatorEvaluatorInstance;
import com.googlecode.aviator.EvalMode;
import org.testng.Assert;
import org.testng.annotations.Test;

Expand Down Expand Up @@ -290,7 +291,7 @@ public void should_throwsNullPointException_when_setAviatorEvaluator_given_nullI
@Test
public void should_true_when_setAviatorEvaluator_given_customInstance() {
// given
AviatorEvaluatorInstance instance = AviatorEvaluator.newInstance();
AviatorEvaluatorInstance instance = AviatorEvaluator.newInstance(EvalMode.INTERPRETER);
Enforcer enforcer = new Enforcer();
// when
enforcer.setAviatorEvaluator(instance);
Expand Down