-
Notifications
You must be signed in to change notification settings - Fork 8
Known Issues
-
On Linux, iOS devices are not detected in Sidekick.
Workaround: None. This is a limitation of the Linux OS. -
When you select, install, update or remove plugins from the Plugins tab in App Settings, you might experience an
Internal server error
.
Workaround: Install the plugins manually from a command-line terminal (Command Prompt on Windows, Terminal on macOS and Linux). -
When you are using npm 5.4.0, 5.4.1 or 5.4.2, you cannot create a new app based on a template that contains the
nativescript-telerik-ui
plugin.
Workaround: Install a newer version of npm. -
When you are using npm 5.0.0, 5.0.1 or 5.0.2, Sidekick cannot install one of its dependencies and you will not be able to build in the cloud.
Workaround: Install a newer version of npm. -
When you debug, expanding the Global Listeners panel will show an error message in the Chrome DevTools console.
Workaround: None. -
When you debug, breakpoints placed in JavaScript files will be transferred to incorrect positions in the TypeScript files.
Workaround: Place breakpoints only in the TypeScript files. -
When you use
.keystore
or.jks
certificates, the Release Cloud build for Android fails and the following error message appears:Only 8, 16, 24, or 32 bits supported: 872
.
Workaround: Use.p12
certificates instead. You can convert.keystore
and.jks
files to.p12
by following the steps outlined in this article. -
On an Android device, when you start a debugging session, the app becomes temporarily unresponsive.
Workaround: Wait for a couple of seconds and if theApp isn't responding
pop-up appears, select Wait. -
On an Android device, when you start and instantly stop a debugging session multiple times in a row, the app may become unresponsive and close.
Workaround: None. -
On Android devices, when you build and LiveSync your app in the NativeScript CLI and then attempt to build and deploy it on a connected device in NativeScript Sidekick, you might experience issues. The app might not update correctly and retain its state from the last build in the NativeScript CLI.
Workaround: Delete the/data/local/<app-id>
folder from the affected device. You can accomplish this by running the following commands - first theadb shell
command and after that therm -rf data/local/tml/<app-id>
command. -
You cannot install NativeScript Sidekick on a Windows 7 Professional system that does not have .NET Framework 4.5 installed.
Workaround: Install .NET Framework 4.5 and then install NativeScript Sidekick. -
On Windows, if the combined length of the base folder (in which you create the app) and the app folder name is greater than 60 symbols, you cannot build locally for Android. The process fails and the following error message appears:
Error: Failed to crunch file <Path To File>
.
Workaround: Ensure that the combined character length of the base folder name and the app name is less than 60 symbols. -
On macOS, the NativeScript Sidekick helper processes might not be terminated after auto update even if the client is stopped.
Workaround: Kill the leaking helper processes manually. -
On macOS and Linux, you cannot build your app if it is located on a partition that forbids file execution. The build fails immediately with the following error message:
SASS compiler failed with exit code 1.
.
Workaround: Allow file execution for the respective partition or move your project to a different partition. -
On macOS, the local iOS build cannot complete if no default development team is specified in the native Xcode project.
Workaround: Open Xcode and log in with your development account. -
On macOS, when you are a member of two or more development teams, the local iOS build cannot complete and the following error message appears:
Error: Unable to determine default development team. Available development teams are: YOUR_TEAM_ID, YOUR_TEAM_ID
.
Workaround: Manually select a team.-
- In your app folder, navigate to
app/AppResources/iOS
and open thebuild.xcconfig
file.
- In your app folder, navigate to
-
- (Optional) If the
build.xcconfig
file does not exist, create it manually.
- (Optional) If the
-
- Specify a team id by entering
DEVELOPMENT_TEAM = YOUR_TEAM_ID
. You can obtainYOUR_TEAM_ID
from the error message or from the Apple Developer portal.
- Specify a team id by entering
-
- Introduction
- Get Started
- User Guide
- Logging in Sidekick
- Sidekick Settings
- Creating Your App
- Configuring Your App
- Adding Pages
- Code Signing You App
- Building Your App
- Running Your App
- Publishing Your App
- Troubleshooting