[Help Wanted]: got issue running the project

[kristopheri]

Required Reading

• Confirmed

Plugin Version

4.2.1

Mobile operating-system(s)

• iOS
• Android

What do you require assistance about?

Suddenly got issue running the app with that plugin

[Optional] Plugin Code and/or Config

android/build.gradle

        maven {
            // react-native-background-fetch
            url("${project(':react-native-background-fetch').projectDir}/libs")
        }

[Optional] Relevant log output

Issue in 4.2.1
Execution failed for task ':app:mergeExtDexDebug'. > Could not resolve all files for configuration ':app:debugRuntimeClasspath'. > Failed to transform tsbackgroundfetch-4.1.0.aar (com.transistorsoft:tsbackgroundfetch:4.1.0) to match attributes {artifactType=android-dex, asm-transformed-variant=NONE, dexing-enable-desugaring=true, dexing-enable-jacoco-instrumentation=false, dexing-is-debuggable=true, dexing-min-sdk=24, org.gradle.category=library, org.gradle.dependency.bundling=external, org.gradle.libraryelements=aar, org.gradle.status=release, org.gradle.usage=java-runtime}. > Execution failed for DexingNoClasspathTransform: /Users/jared/.gradle/caches/transforms-3/172f3a711b9c9c667efb4aa9a19eb421/transformed/jetified-tsbackgroundfetch-4.1.0-runtime.jar. > Error while dexing.

Issue in 4.3.0
* What went wrong:
Execution failed for task ':app:mergeExtDexDebug'.
> Could not resolve all files for configuration ':app:debugRuntimeClasspath'.
   > Failed to transform tsbackgroundfetch-4.0.6.aar (com.transistorsoft:tsbackgroundfetch:4.0.6) to match attributes {artifactType=android-dex, asm-transformed-variant=NONE, dexing-enable-desugaring=true, dexing-enable-jacoco-instrumentation=false, dexing-is-debuggable=true, dexing-min-sdk=24, org.gradle.category=library, org.gradle.dependency.bundling=external, org.gradle.libraryelements=aar, org.gradle.status=release, org.gradle.usage=java-runtime}.
      > Execution failed for DexingNoClasspathTransform: /Users/jared/.gradle/caches/transforms-3/c3b15f798c2760fe1a73826940e6b1d4/transformed/jetified-tsbackgroundfetch-4.0.6-runtime.jar.
         > Error while dexing.

[christocracy]

Install latest version.

It has new setup instructions that no longer require a custom maven url in your build.gradle

https://fetch.transistorsoft.com/react-native/setup/

[kristopheri]

Install latest version.

It has new setup instructions that no longer require a custom maven url in your build.gradle

https://fetch.transistorsoft.com/react-native/setup/

Hi Chris, after upgrading to react-native-background-fetch@4.4.2 I am getting a different issue in my react native 0.68 project.
help on this thank you

notes: already did gradlew clean

Task :react-native-background-fetch:generateCodegenSchemaFromJavaScript FAILED

Deprecated Gradle features were used in this build, making it incompatible with Gradle 8.0.

You can use '--warning-mode all' to show the individual deprecation warnings and determine if they come from your own scripts or plugins.

See https://docs.gradle.org/7.5/userguide/command_line_interface.html#sec:command_line_warnings
8 actionable tasks: 2 executed, 6 up-to-date
/Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/parsers/typescript/index.js:190
throw parsingErrors[0];
^

UnusedModuleTypeScriptInterfaceParserError: Module NativeDocumentPicker.d: Unused NativeModule spec. Please load the NativeModule by calling TurboModuleRegistry.get('').
at /Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/parsers/typescript/modules/index.js:731:13
at guard (/Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/parsers/typescript/utils.js:111:14)
at buildModuleSchema (/Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/parsers/typescript/modules/index.js:720:22)
at /Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/parsers/typescript/index.js:179:9
at guard (/Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/parsers/typescript/utils.js:111:14)
at buildSchema (/Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/parsers/typescript/index.js:178:22)
at Object.parseFile (/Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/parsers/typescript/index.js:209:10)
at files.reduce.modules (/Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/cli/combine/combine-js-to-schema.js:83:30)
at Array.reduce ()
at combineSchemas (/Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/cli/combine/combine-js-to-schema.js:71:16) {
nodes: [
Node {
type: 'TSInterfaceDeclaration',
start: 299,
end: 547,
loc: SourceLocation {
start: Position { line: 13, column: 7, index: 299 },
end: Position { line: 18, column: 1, index: 547 },
filename: undefined,
identifierName: undefined
},
id: Node {
type: 'Identifier',
start: 309,
end: 313,
loc: SourceLocation {
start: Position { line: 13, column: 17, index: 309 },
end: Position { line: 13, column: 21, index: 313 },
filename: undefined,
identifierName: 'Spec'
},
name: 'Spec'
},
typeParameters: undefined,
extends: [
Node {
type: 'TSExpressionWithTypeArguments',
start: 322,
end: 333,
loc: SourceLocation {
start: [Position],
end: [Position],
filename: undefined,
identifierName: undefined
},
expression: Node {
type: 'Identifier',
start: 322,
end: 333,
loc: [SourceLocation],
name: 'TurboModule'
}
}
],
body: Node {
type: 'TSInterfaceBody',
start: 334,
end: 547,
loc: SourceLocation {
start: Position { line: 13, column: 42, index: 334 },
end: Position { line: 18, column: 1, index: 547 },
filename: undefined,
identifierName: undefined
},
body: [
Node {
type: 'TSPropertySignature',
start: 340,
end: 372,
loc: [SourceLocation],
readonly: true,
key: [Node],
computed: false,
typeAnnotation: [Node]
},
Node {
type: 'TSMethodSignature',
start: 377,
end: 434,
loc: [SourceLocation],
key: [Node],
computed: false,
typeParameters: undefined,
parameters: [Array],
typeAnnotation: [Node],
kind: 'method'
},
Node {
type: 'TSMethodSignature',
start: 439,
end: 490,
loc: [SourceLocation],
key: [Node],
computed: false,
typeParameters: undefined,
parameters: [Array],
typeAnnotation: [Node],
kind: 'method'
},
Node {
type: 'TSMethodSignature',
start: 495,
end: 545,
loc: [SourceLocation],
key: [Node],
computed: false,
typeParameters: undefined,
parameters: [],
typeAnnotation: [Node],
kind: 'method'
}
]
}
}
]
}

Node.js v18.17.0
error Command failed.
Exit code: 1
Command: /Users/jared/.nvm/versions/node/v18.17.0/bin/node
Arguments: /Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/cli/combine/combine-js-to-schema-cli.js /Users/jared/Projects/app-Mobile/node_modules/react-native-background-fetch/android/build/generated/source/codegen/schema.json /Users/jared/Projects/app-Mobile
Directory: /Users/jared/Projects/app-Mobile/node_modules/react-native-background-fetch
Output:

FAILURE: Build failed with an exception.

• What went wrong:
  Execution failed for task ':react-native-background-fetch:generateCodegenSchemaFromJavaScript'.

Process 'command 'yarn'' finished with non-zero exit value 1

• Try:

Run with --stacktrace option to get the stack trace.
Run with --info or --debug option to get more log output.
Run with --scan to get full insights.

• Get more help at https://help.gradle.org

BUILD FAILED in 20s

error Failed to install the app. Make sure you have the Android development environment set up: https://reactnative.dev/docs/environment-setup.
Error: Command failed: ./gradlew app:installDebug -PreactNativeDevServerPort=8081
/Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/parsers/typescript/index.js:190
throw parsingErrors[0];
^

UnusedModuleTypeScriptInterfaceParserError: Module NativeDocumentPicker.d: Unused NativeModule spec. Please load the NativeModule by calling TurboModuleRegistry.get('').
at /Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/parsers/typescript/modules/index.js:731:13
at guard (/Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/parsers/typescript/utils.js:111:14)
at buildModuleSchema (/Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/parsers/typescript/modules/index.js:720:22)
at /Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/parsers/typescript/index.js:179:9
at guard (/Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/parsers/typescript/utils.js:111:14)
at buildSchema (/Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/parsers/typescript/index.js:178:22)
at Object.parseFile (/Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/parsers/typescript/index.js:209:10)
at files.reduce.modules (/Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/cli/combine/combine-js-to-schema.js:83:30)
at Array.reduce ()
at combineSchemas (/Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/cli/combine/combine-js-to-schema.js:71:16) {
nodes: [
Node {
type: 'TSInterfaceDeclaration',
start: 299,
end: 547,
loc: SourceLocation {
start: Position { line: 13, column: 7, index: 299 },
end: Position { line: 18, column: 1, index: 547 },
filename: undefined,
identifierName: undefined
},
id: Node {
type: 'Identifier',
start: 309,
end: 313,
loc: SourceLocation {
start: Position { line: 13, column: 17, index: 309 },
end: Position { line: 13, column: 21, index: 313 },
filename: undefined,
identifierName: 'Spec'
},
name: 'Spec'
},
typeParameters: undefined,
extends: [
Node {
type: 'TSExpressionWithTypeArguments',
start: 322,
end: 333,
loc: SourceLocation {
start: [Position],
end: [Position],
filename: undefined,
identifierName: undefined
},
expression: Node {
type: 'Identifier',
start: 322,
end: 333,
loc: [SourceLocation],
name: 'TurboModule'
}
}
],
body: Node {
type: 'TSInterfaceBody',
start: 334,
end: 547,
loc: SourceLocation {
start: Position { line: 13, column: 42, index: 334 },
end: Position { line: 18, column: 1, index: 547 },
filename: undefined,
identifierName: undefined
},
body: [
Node {
type: 'TSPropertySignature',
start: 340,
end: 372,
loc: [SourceLocation],
readonly: true,
key: [Node],
computed: false,
typeAnnotation: [Node]
},
Node {
type: 'TSMethodSignature',
start: 377,
end: 434,
loc: [SourceLocation],
key: [Node],
computed: false,
typeParameters: undefined,
parameters: [Array],
typeAnnotation: [Node],
kind: 'method'
},
Node {
type: 'TSMethodSignature',
start: 439,
end: 490,
loc: [SourceLocation],
key: [Node],
computed: false,
typeParameters: undefined,
parameters: [Array],
typeAnnotation: [Node],
kind: 'method'
},
Node {
type: 'TSMethodSignature',
start: 495,
end: 545,
loc: [SourceLocation],
key: [Node],
computed: false,
typeParameters: undefined,
parameters: [],
typeAnnotation: [Node],
kind: 'method'
}
]
}
}
]
}

Node.js v18.17.0
error Command failed.
Exit code: 1
Command: /Users/jared/.nvm/versions/node/v18.17.0/bin/node
Arguments: /Users/jared/Projects/app-Mobile/node_modules/react-native-codegen/lib/cli/combine/combine-js-to-schema-cli.js /Users/jared/Projects/app-Mobile/node_modules/react-native-background-fetch/android/build/generated/source/codegen/schema.json /Users/jared/Projects/app-Mobile
Directory: /Users/jared/Projects/app-Mobile/node_modules/react-native-background-fetch
Output:

FAILURE: Build failed with an exception.

• What went wrong:
  Execution failed for task ':react-native-background-fetch:generateCodegenSchemaFromJavaScript'.

Process 'command 'yarn'' finished with non-zero exit value 1

• Try:

Run with --stacktrace option to get the stack trace.
Run with --info or --debug option to get more log output.
Run with --scan to get full insights.

• Get more help at https://help.gradle.org

BUILD FAILED in 20s

at makeError (/Users/jared/Projects/app-Mobile/node_modules/@react-native-community/cli-platform-android/node_modules/execa/index.js:174:9)
at /Users/jared/Projects/app-Mobile/node_modules/@react-native-community/cli-platform-android/node_modules/execa/index.js:278:16
at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
at async runOnAllDevices (/Users/jared/Projects/app-Mobile/node_modules/@react-native-community/cli-platform-android/build/commands/runAndroid/runOnAllDevices.js:109:5)
at async Command.handleAction (/Users/jared/Projects/app-Mobile/node_modules/@react-native-community/cli/build/index.js:192:9)

info Run CLI with --verbose flag for more details.

[christocracy]

react native 0.68

A bit old, no?

[christocracy]

The error is misleading — it’s not actually background-fetch failing. Look at the error message:

Module NativeDocumentPicker.d: Unused NativeModule spec

background-fetch@4.4.2 now runs codegen at build time, which scans your entire project’s node_modules for TurboModule specs. It’s hitting a file in react-native-document-picker that your RN 0.68 codegen can’t parse. Any library that adopts modern codegen would trigger this.

Your options on RN 0.68:
1. Downgrade react-native-document-picker to a pre-new-arch version (try v8.x or earlier). That’s likely the fastest unblock.
2. Pin react-native-background-fetch to the version just before 4.4.2 to avoid triggering codegen scans entirely. You’ll miss the new setup improvements but it’ll build.
3. Upgrade React Native. RN 0.68 is three+ years past EOL and you’re going to keep hitting these incompatibilities with every library update. This is the real fix.

I can’t realistically support RN 0.68 going forward — the codegen infrastructure in that version is too broken to work reliably with any library adopting the new architecture. Option 2 is your safest path if upgrading RN isn’t on the table right now.

[kristopheri]

Hi Chris, thanks for the swift response and for providing me with options.

after downgrading react-native-background-fetch to 4.4.0 and react-native-document-picker to 8.2.2 gets a new error

also tried only downgrading to 4.4.0 before the react-native-document-picker gives same issue earlier. but gives a new error when downgraded the picker.

note: also checked issues similar to this but no search results

> Task :react-native-background-fetch:compileDebugJavaWithJavac FAILED

Deprecated Gradle features were used in this build, making it incompatible with Gradle 8.0.

You can use '--warning-mode all' to show the individual deprecation warnings and determine if they come from your own scripts or plugins.

See https://docs.gradle.org/7.5/userguide/command_line_interface.html#sec:command_line_warnings

Execution optimizations have been disabled for 3 invalid unit(s) of work during this build to ensure correctness.
Please consult deprecation warnings for more details.
397 actionable tasks: 391 executed, 6 up-to-date
Note: Some input files use or override a deprecated API.
Note: Recompile with -Xlint:deprecation for details.
Note: /Users/jared/Projects/app-Mobile/node_modules/@notifee/react-native/android/src/main/java/io/invertase/notifee/NotifeeReactUtils.java uses or overrides a deprecated API.
Note: Recompile with -Xlint:deprecation for details.
/Users/jared/Projects/app-Mobile/node_modules/react-native-background-fetch/android/src/main/java/com/transistorsoft/rnbackgroundfetch/RNBackgroundFetchModule.java:14: error: RNBackgroundFetchModule is not abstract and does not override abstract method getName() in NativeModule
public class RNBackgroundFetchModule extends NativeBackgroundFetchSpec implements ActivityEventListener, LifecycleEventListener {
       ^
/Users/jared/Projects/app-Mobile/node_modules/react-native-background-fetch/android/src/main/java/com/transistorsoft/rnbackgroundfetch/RNBackgroundFetchModule.java:15: error: cannot find symbol
    public static final String TAG = NAME;
                                     ^
  symbol:   variable NAME
  location: class RNBackgroundFetchModule
/Users/jared/Projects/app-Mobile/node_modules/react-native-background-fetch/android/src/main/java/com/transistorsoft/rnbackgroundfetch/RNBackgroundFetchPackage.java:19: error: cannot find symbol
        if (RNBackgroundFetchModule.NAME.equals(name)) {
                                   ^
  symbol:   variable NAME
  location: class RNBackgroundFetchModule
/Users/jared/Projects/app-Mobile/node_modules/react-native-background-fetch/android/src/main/java/com/transistorsoft/rnbackgroundfetch/RNBackgroundFetchPackage.java:30: error: cannot find symbol
                RNBackgroundFetchModule.NAME,
                                       ^
  symbol:   variable NAME
  location: class RNBackgroundFetchModule
/Users/jared/Projects/app-Mobile/node_modules/react-native-background-fetch/android/src/main/java/com/transistorsoft/rnbackgroundfetch/RNBackgroundFetchPackage.java:32: error: cannot find symbol
                    RNBackgroundFetchModule.NAME,
                                           ^
  symbol:   variable NAME
  location: class RNBackgroundFetchModule
/Users/jared/Projects/app-Mobile/node_modules/react-native-background-fetch/android/src/main/java/com/transistorsoft/rnbackgroundfetch/RNBackgroundFetchPackage.java:33: error: cannot find symbol
                    RNBackgroundFetchModule.NAME,
                                           ^
  symbol:   variable NAME
  location: class RNBackgroundFetchModule
Note: /Users/jared/Projects/app-Mobile/node_modules/react-native-background-fetch/android/src/main/java/com/transistorsoft/rnbackgroundfetch/HeadlessTask.java uses or overrides a deprecated API.
Note: Recompile with -Xlint:deprecation for details.
6 errors

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':react-native-background-fetch:compileDebugJavaWithJavac'.
> Compilation failed; see the compiler error output for details.

* Try:
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.

* Get more help at https://help.gradle.org

BUILD FAILED in 33s

error Failed to install the app. Make sure you have the Android development environment set up: https://reactnative.dev/docs/environment-setup.
Error: Command failed: ./gradlew app:installDebug -PreactNativeDevServerPort=8081
Note: Some input files use or override a deprecated API.
Note: Recompile with -Xlint:deprecation for details.
Note: /Users/jared/Projects/app-Mobile/node_modules/@notifee/react-native/android/src/main/java/io/invertase/notifee/NotifeeReactUtils.java uses or overrides a deprecated API.
Note: Recompile with -Xlint:deprecation for details.
/Users/jared/Projects/app-Mobile/node_modules/react-native-background-fetch/android/src/main/java/com/transistorsoft/rnbackgroundfetch/RNBackgroundFetchModule.java:14: error: RNBackgroundFetchModule is not abstract and does not override abstract method getName() in NativeModule
public class RNBackgroundFetchModule extends NativeBackgroundFetchSpec implements ActivityEventListener, LifecycleEventListener {
       ^
/Users/jared/Projects/app-Mobile/node_modules/react-native-background-fetch/android/src/main/java/com/transistorsoft/rnbackgroundfetch/RNBackgroundFetchModule.java:15: error: cannot find symbol
    public static final String TAG = NAME;
                                     ^
  symbol:   variable NAME
  location: class RNBackgroundFetchModule
/Users/jared/Projects/app-Mobile/node_modules/react-native-background-fetch/android/src/main/java/com/transistorsoft/rnbackgroundfetch/RNBackgroundFetchPackage.java:19: error: cannot find symbol
        if (RNBackgroundFetchModule.NAME.equals(name)) {
                                   ^
  symbol:   variable NAME
  location: class RNBackgroundFetchModule
/Users/jared/Projects/app-Mobile/node_modules/react-native-background-fetch/android/src/main/java/com/transistorsoft/rnbackgroundfetch/RNBackgroundFetchPackage.java:30: error: cannot find symbol
                RNBackgroundFetchModule.NAME,
                                       ^
  symbol:   variable NAME
  location: class RNBackgroundFetchModule
/Users/jared/Projects/app-Mobile/node_modules/react-native-background-fetch/android/src/main/java/com/transistorsoft/rnbackgroundfetch/RNBackgroundFetchPackage.java:32: error: cannot find symbol
                    RNBackgroundFetchModule.NAME,
                                           ^
  symbol:   variable NAME
  location: class RNBackgroundFetchModule
/Users/jared/Projects/app-Mobile/node_modules/react-native-background-fetch/android/src/main/java/com/transistorsoft/rnbackgroundfetch/RNBackgroundFetchPackage.java:33: error: cannot find symbol
                    RNBackgroundFetchModule.NAME,
                                           ^
  symbol:   variable NAME
  location: class RNBackgroundFetchModule
Note: /Users/jared/Projects/app-Mobile/node_modules/react-native-background-fetch/android/src/main/java/com/transistorsoft/rnbackgroundfetch/HeadlessTask.java uses or overrides a deprecated API.
Note: Recompile with -Xlint:deprecation for details.
6 errors

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':react-native-background-fetch:compileDebugJavaWithJavac'.
> Compilation failed; see the compiler error output for details.

* Try:
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.

* Get more help at https://help.gradle.org

BUILD FAILED in 33s

    at makeError (/Users/jared/Projects/app-Mobile/node_modules/@react-native-community/cli-platform-android/node_modules/execa/index.js:174:9)
    at /Users/jared/Projects/app-Mobile/node_modules/@react-native-community/cli-platform-android/node_modules/execa/index.js:278:16
    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
    at async runOnAllDevices (/Users/jared/Projects/app-Mobile/node_modules/@react-native-community/cli-platform-android/build/commands/runAndroid/runOnAllDevices.js:109:5)
    at async Command.handleAction (/Users/jared/Projects/app-Mobile/node_modules/@react-native-community/cli/build/index.js:192:9)
info Run CLI with --verbose flag for more details.

[christocracy]

react native 0.68

Do you know how old 0.68 is?

[kristopheri]

react native 0.68

Do you know how old 0.68 is?

Seems like there is no other option left but to upgrade the project 😁. thank you and will take Option number 3.

[christocracy]

When you sit back on an old version of RN, you run the risk of not supporting the latest iOS / Android SDKs.

There comes a time when you have no other option but to spend a day upgrading.

[PatrickWalter387]

Hi, I'm facing the exact same issue as described in this thread.

Plugin version: react-native-background-fetch@4.2.1 (pinned, not using ^)
React Native version: 0.71.4

Error log:

* What went wrong:
Execution failed for task ':app:mergeExtDexDebug'.
> Could not resolve all files for configuration ':app:debugRuntimeClasspath'.
   > Failed to transform tsbackgroundfetch-4.1.1.aar (com.transistorsoft:tsbackgroundfetch:4.1.1) to match attributes {artifactType=android-dex, asm-transformed-variant=NONE, dexing-enable-desugaring=true, dexing-enable-jacoco-instrumentation=false, dexing-is-debuggable=true, dexing-min-sdk=21, org.gradle.category=library, org.gradle.dependency.bundling=external, org.gradle.libraryelements=aar, org.gradle.status=release, org.gradle.usage=java-runtime}.
      > Execution failed for DexingWithClasspathTransform: C:\Users\Desenvolvimento\.gradle\caches\transforms-3\8fc15b9e5040bfbcf860123165069244\transformed\jetified-tsbackgroundfetch-4.1.1-runtime.jar.
         > Error while dexing.

Important context:

• This project was building successfully ~2 weeks ago with no changes on our end
• Upgrading React Native or the plugin is not an option at this time — the project is in production and a major version bump would require significant regression testing
• The issue started after tsbackgroundfetch was updated on Maven Central (versions 4.1.0 and 4.1.1), which broke the D8 dexing step
• Other machines that still have the old AAR cached continue to build fine — confirming this is a regression introduced by the native library update, not by anything we changed

The core problem: A change made to the native Android library (tsbackgroundfetch) on Maven Central is silently breaking builds for projects that have pinned older versions of react-native-background-fetch. Projects that haven't cleared their Gradle cache are unaffected, but anyone who clears their cache or sets up a new machine is now broken.

This shouldn't happen — a patch to a transitive native dependency should never break frozen, production-pinned plugin versions without a major version bump or at minimum a clear migration notice.

Is there any way to force the Gradle resolution to use the previously working AAR version? Or could the older, working AAR be made available again on the way that was, so pinned versions can resolve correctly?

Thank you.

[christocracy]

See the CHANGELOG

[PatrickWalter387]

Hey, @kristopheri i just managed to fix it without upgrading anything.

The original local AAR that ships inside node_modules/react-native-background-fetch/android/libs is version 1.0.2. However, after the changes listed in the changelog, Gradle started resolving tsbackgroundfetch to the newer versions from Maven Central (4.1.0, 4.1.1) regardless of whether the maven { url("${project(':react-native-background-fetch').projectDir}/libs") } entry is present or not in android/build.gradle. These newer versions don't seem to work well with older versions of react-native-background-fetch and break the D8 dexing step.

The fix was simple — just force Gradle to use the 1.0.2 version that was already present in node_modules and was the one working before:

allprojects {
    configurations.all {
        resolutionStrategy {
            force "com.transistorsoft:tsbackgroundfetch:1.0.2"
        }
    }
    repositories {
        // ...
        maven {
            // Required for react-native-background-fetch
            url("${project(':react-native-background-fetch').projectDir}/libs")
        }
    }
}

After adding that force line, everything went back to working exactly as before. Hope this helps anyone stuck on an older version who can't upgrade React Native or the plugin right now.

[christocracy]

Hosting the SDK libs locally in the node_module was always a hack.

The native libs are now hosted remotely at mavencentral and Cocoapods/SPM. This is the correct way. This makes setup much simpler, with no more need to manage custom maven url in the consumer's build.gradle.

Historically, the local lib version had a permissive version of .+, so when the SDK was finally published to mavencentral, older plug-in versions would reach out there for the dependency.

[kristopheri]

Hi sir, @PatrickWalter387 thanks for helping out!

im getting this issue after applying the force

 What went wrong:
Could not determine the dependencies of task ':react-native-background-fetch:compileDebugAidl'.
> Could not resolve all task dependencies for configuration ':react-native-background-fetch:debugCompileClasspath'.
   > Could not find com.transistorsoft:tsbackgroundfetch:1.0.2.
     Required by:
         project :react-native-background-fetch

[PatrickWalter387]

Hi sir, @PatrickWalter387 thanks for helping out!

im getting this issue after applying the force

 What went wrong:
Could not determine the dependencies of task ':react-native-background-fetch:compileDebugAidl'.
> Could not resolve all task dependencies for configuration ':react-native-background-fetch:debugCompileClasspath'.
   > Could not find com.transistorsoft:tsbackgroundfetch:1.0.2.
     Required by:
         project :react-native-background-fetch

Hey! The 1.0.2 is the version bundled in my node_modules. Check which version you have at:

node_modules/react-native-background-fetch/android/libs/com/transistorsoft/tsbackgroundfetch/

Use whatever version folder you find there in the force line instead of 1.0.2.

Also make sure to keep this line in your repositories block — without it Gradle won't be able to find the local AAR:

maven {
    url("${project(':react-native-background-fetch').projectDir}/libs")
}

[christocracy]

published legacy version 4.2.9 with local tsbackgroundfetch lib pinned to the locally-found version (1.0.4)