Skip to content

Commit d987647

Browse files
DMGithubPublisherDMGithubPublisher
committed
update to internal commit 0a6c33eb
1 parent 2470a7f commit d987647

File tree

62 files changed

+1532
-76
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

62 files changed

+1532
-76
lines changed

‎_includes/sidelist-faq.html‎

Lines changed: 9 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -1,68 +1,23 @@
11
<li>
22
<a href="{{ site.faq_general }}index.html" class="otherLinkColour">FAQ</a>
33
<ul>
4+
45
<li>
5-
<a href="{{ site.faq_general }}what-is-dbr.html">What business needs can Dynamsoft Barcode Reader meet?</a>
6+
<a href="{{ site.faq_general }}general.html">General</a>
67
</li>
78
<li>
8-
<a href="{{ site.faq_general }}supported-barcode-formats.html">What barcode types are supported by Dynamsoft Barcode Reader?</a>
9+
<a href="{{ site.faq_general }}license-usage.html">Licensing & Usage</a>
910
</li>
1011
<li>
11-
<a href="{{ site.faq_general }}different-editions-of-dbr.html">Which edition of Barcode Reader should I use?</a>
12+
<a href="{{ site.faq_general }}configuration.html">Configuration</a>
13+
1214
</li>
1315
<li>
14-
<a href="{{ site.faq_general }}dbr-free-trial.html">What I need to know about trial licenses?</a>
16+
<a href="{{ site.faq_general }}multi-platform.html">Multi Platform</a>
1517
</li>
18+
1619
<li>
17-
<a href="{{ site.faq_general }}non-english-characters.html">What I can do when barcode image returnes messy (non-english) characters?</a>
18-
</li>
19-
<li>
20-
<a href="{{ site.faq_general }}dbr-supports-pdf.html">Can Barcode Reader SDK read PDF files? Do I need to pay for this feature?</a>
21-
</li>
22-
<li>
23-
<a href="{{ site.faq_general }}scan-specific-page.html">How to scan specific pages of a pdf file?</a>
24-
</li>
25-
<li>
26-
<a href="{{ site.faq_general }}avoid-incorrect-results.html">How to filter incorrect results with the barcode result length?</a>
27-
</li>
28-
<li>
29-
<a href="{{ site.faq_general }}scan-us-drivers-license.html">How to scan barcodes on US Driver's Licenses and extract the information?</a>
30-
</li>
31-
<li>
32-
<a href="{{ site.faq_general }}how-to-enable-dpm.html">How to enable DPM?</a>
33-
</li>
34-
<li>
35-
<a href="{{ site.faq_general }}expand-quota-for-runtime-license.html">How to expand the quota of a runtime license?</a>
36-
</li>
37-
<li>
38-
<a href="{{ site.faq_general }}track-license.html">How to track the number of devices?</a>
39-
</li>
40-
<li>
41-
<a href="{{ site.faq_general }}sdk-works-without-internet.html">Can the SDK work without internet connection?</a>
42-
</li>
43-
<li>
44-
<a href="{{ site.faq_general }}what-happens-if-license-expires.html">What will happen if licenses are not renewed in time?</a>
45-
</li>
46-
<li>
47-
<a href="{{ site.faq_general }}how-hardware-is-bind-to-license.html">What I need to know about licensing process?</a>
48-
</li>
49-
<li>
50-
<a href="{{ site.faq_general }}ensure-no-overuse.html">How to properly use concurrent instance license?</a>
51-
</li>
52-
<li>
53-
<a href="{{ site.faq_general }}competitors-comparison.html">How does your SDK compare to other commercial SDKs?</a>
54-
</li>
55-
<li>
56-
<a href="{{ site.faq_general }}unprintable-character.html">How to Handle Non-printable Characters Like "\u{1D}" or "{GS}" from the Barcode Text?</a>
57-
</li>
58-
<li>
59-
<a href="{{ site.faq_general }}custom-settings-template.html">How to create custom settings template?</a>
60-
</li>
61-
<li>
62-
<a href="{{ site.faq_general }}sort-barcodes-image.html">How can I sort the barcodes of my image in reading order?</a>
63-
</li>
64-
<li>
65-
<a href="{{ site.faq_general }}error-license-buffer.html">How to resolve error failed to read or write license buffer?</a>
20+
<a href="{{ site.faq_general }}error-debug.html">Error & Debug</a>
6621
</li>
6722
</ul>
68-
</li>
23+
</li>

‎faq/general/add-remove-beep-sound.md‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
layout: default-layout
3+
title: How to add/remove a "beep" sound once a barcode is found?
4+
keywords: Dynamsoft Barcode Reader, FAQ, JavaScript, tech basic, beep, sound
5+
description: How to add/remove a "beep" sound once a barcode is found?
6+
needAutoGenerateSidebar: false
7+
---
8+
9+
# How to add/remove a "beep" sound once a barcode is found?
10+
11+
[<< Back to FAQ index](index.md)
12+
13+
This feature is controlled using the [whenToPlaySoundforSuccessfulRead](https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/api-reference/interface/ScanSettings.html?ver=latest) property. To enable the feature, set the property to either **frame** or **unique**. To disable the feature, set it to **never**.
14+
15+
> This feature is disabled by default.

‎faq/general/arm64-simulator-error.md‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
---
2+
layout: default-layout
3+
title: How to resolve the "Building for iOS Simulator, but linking in dylib built for iOS" error when building for the iOS simulator?
4+
keywords: Dynamsoft Barcode Reader, FAQ, Mobile, tech basic, ios, arm64, simulator, exclude architectures
5+
description: How to resolve the "Building for iOS Simulator, but linking in dylib built for iOS" error when building for the iOS simulator?
6+
needAutoGenerateSidebar: true
7+
---
8+
9+
# How to resolve the "Building for iOS Simulator, but linking in dylib built for iOS" error when building for the iOS simulator?
10+
11+
[<< Back to FAQ index](index.md)
12+
13+
DBR iOS can be used to build apps that belong to the arm64 architecture. If you try building an app for the arm64 simulator, and you migrated your app from an older version of Xcode to Xcode 12 or higher, then you might encounter the following error message:
14+
15+
> ld: "Building for iOS Simulator, but linking in dylib built for iOS, file '/ios/Pods/DynamsoftBarcodeReader/DynamsoftBarcodeReader.framework/DynamsoftBarcodeReader' for architecture arm64"
16+
17+
<br />
18+
19+
In order to fix the error, please take the following steps under the *Build Settings* of the Xcode project:
20+
21+
1. Under *User-Defined* -> find *VALIDATE_WORKSPACE* and set it to **YES**. Rebuild your project.
22+
23+
2. Under *Architectures* -> find *Build Active Architecture Only* and set it to **YES**.
24+
25+
3. Under *Architectures* -> make sure that *Architectures* is set to $(ARCHS_STANDARD).
26+
27+
<br />
28+
29+
If the error message persists, please make one of the following changes:
30+
31+
- Instead of using the .framework (which all the samples do by default), switch to using the corresponding .xcframework
32+
33+
- Under the *Build Settings* -> find *Excluded Architectures* -> in the *Debug* field click the + icon -> select *Any iOS Simulator SDK* -> put "arm64"
34+
35+
- You can also exclude architectures via the Podfile as such:
36+
37+
```ruby
38+
post_install do |installer|
39+
installer.pods_project.build_configurations.each do |config|
40+
config.build_settings["EXCLUDED_ARCHS[sdk=iphonesimulator*]"] = "arm64"
41+
end
42+
end
43+
```
44+
OR
45+
```ruby
46+
post_install do |installer|
47+
installer.pods_project.build_configurations.each do |config|
48+
config.build_settings["EXCLUDED_ARCHS[sdk=iphonesimulator*]"] = "uname -m"
49+
end
50+
end
51+
```
52+
OR
53+
```ruby
54+
podspec:
55+
s.pod_target_xcconfig = { 'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'arm64' }
56+
s.user_target_xcconfig = { 'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'arm64' }
57+
```
58+

‎faq/general/armv7-architecture-error.md‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
layout: default-layout
3+
title: How can I solve the "Undefined symbols for architecture armv7" error when building on iOS?
4+
keywords: Dynamsoft Barcode Reader, FAQ, Mobile, tech basic, ios, armv7, undefined symbols
5+
description: How can I solve the "Undefined symbols for architecture armv7" error when building on iOS?
6+
needAutoGenerateSidebar: true
7+
---
8+
9+
# How can I solve the "Undefined symbols for architecture armv7" error when building on iOS?
10+
11+
[<< Back to FAQ index](index.md)
12+
13+
DBR iOS is compatible with the arm64 and x86_64 architectures only. If you attempt to build an app that is targetting the armv7 architecture, you will be met with an error from the Barcode Reader framework saying
14+
15+
> Undefined symbols for architecture armv7
16+
17+
Please note that this will mostly occur with older versions of Xcode or iOS that are still compatible with the older iOS device models that used the armv7 architecture. For most devices that are able to run iOS 11 and higher, the architecture will be arm64.
18+
19+
By default, when you set the *Architectures* in *Build Settings* to the "$(ARCHS_STANDARD) - Standard Architectures (arm64)", the armv7 architecture should automaticallt not be included. To ensure that your app ignores the armv7 architecture, you can add it to the *Excluded Architectures* field of the *Build Settings*.

‎faq/general/avoid-incorrect-barcode-results.md‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
---
2+
layout: default-layout
3+
title: How to avoid incorrect barcode results?
4+
keywords: Dynamsoft Barcode Reader, FAQ, JavaScript, Troubleshooting / User Cases, avoid incorrect barcode results
5+
description: How to avoid incorrect barcode results?
6+
needAutoGenerateSidebar: false
7+
---
8+
9+
# How to avoid incorrect barcode results?
10+
11+
[<< Back to FAQ index](index.md)
12+
13+
- One method is to raise the value of [minResultConfidence](https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/api-reference/interface/RuntimeSettings.html#minresultconfidence) of the `RuntimeSettings` to a value of 50 or higher. It is set to 30 by default.
14+
- If the issue has to do with the length of the text result, you can try setting a minimum length for the barcode text(s) that are returned by the SDK. By setting the [minBarcodeTextLength](https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/api-reference/interface/RuntimeSettings.html#minbarcodetextlength) property of the `RuntimeSettings`, the SDK can ignore results that are consistently coming out shorter than expected.

‎faq/general/bitcode-support.md‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
layout: default-layout
3+
title: Does the SDK support iOS Bitcode Framework?
4+
keywords: Dynamsoft Barcode Reader, FAQ, Mobile, tech basic, ios, bitcode
5+
description: Does the SDK support iOS Bitcode Framework?
6+
needAutoGenerateSidebar: true
7+
---
8+
9+
# Does the SDK support iOS Bitcode Framework?
10+
11+
[<< Back to FAQ index](index.md)
12+
13+
Yes, DBR iOS does allow the user to enable bitcode in their project if they would like to. Enabling bitcode can potentially reduce the app's total size.
14+
15+
In order to enable bitcode, access the *Build Settings* of the project via Xcode and find the *Enable Bitcode* option to toggle it on.

‎faq/general/call-loadWasm-proactively.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
layout: default-layout
3+
title: Do we have to call loadWasm proactively?
4+
keywords: Dynamsoft Barcode Reader, FAQ, tech basic, loadWasm
5+
description: Do we have to call loadWasm proactively?
6+
needAutoGenerateSidebar: false
7+
---
8+
9+
# Do we have to call loadWasm proactively?
10+
11+
[<< Back to FAQ index](index.md)
12+
13+
No, the method is internally called when `createInstance` is called so there is no need to explicitly call it. However, if you would like to save some time during the instance creation, you can choose to manually call the method as soon as the page is loaded rather than letting it load on the instance creation. This can help avoid unnecessary waiting time when the library is invoked.

‎faq/general/change-domain-binding-of-product-key.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
---
2+
layout: default-layout
3+
title: How to change the domain binding of your product key?
4+
keywords: Dynamsoft Barcode Reader, FAQ, JavaScript, tech basic, domain binding, product key
5+
description: How to change the domain binding of your product key?
6+
needAutoGenerateSidebar: false
7+
---
8+
9+
# How to change the domain binding of your product key?
10+
11+
[<< Back to FAQ index](index.md)
12+
13+
In order to change the domain binding of the handshake code that includes the license item in question please follow the below steps -
14+
1. You will first need to log into the [customer portal](https://www.dynamsoft.com/customer/index).
15+
2. After login, please navigate go to [projects link](https://www.dynamsoft.com/lts/index.html#/handshakeCodes)
16+
3. Find the project that you want to change the domain binding.
17+
4. Click on the "Configure" button.
18+
5. Scroll down and find "Optional Settings" -> edit "Bind Website Domain" field to change your domain binding.
19+
<img src="../assets/domain_binding.jpg" alt="domain_binding" />
20+
> Please note that a single project can contain multiple license items. If you wish to bind a single license item to a certain domain, then you will need to make sure that license item is the only item in the associated project. First, remove the license item from its current project. Afterwards, create a new project and then open its configuration page. Then, move the license item to the new project and finally edit the binding info of the new project.

‎faq/general/check-camera.md‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
---
2+
layout: default-layout
3+
title: How to check the camera permissions programmatically in Dynamsoft Barcode Reader JavaScript SDK?
4+
keywords: JavaScript, JS, camera, permission
5+
description: How to check the camera permissions programmatically in Dynamsoft Barcode Reader JavaScript SDK?
6+
needAutoGenerateSidebar: false
7+
---
8+
9+
# How to check the camera permissions programmatically in Dynamsoft Barcode Reader JavaScript SDK?
10+
11+
[<< Back to FAQ index](index.md)
12+
13+
Starting from version 9.6.10+, you can utilize the [testCameraAccess](https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/api-reference/BarcodeScanner.html#testcameraaccess) method to check the camera status programmatically.
14+
15+
For versions older than 9.6.10, you can check the status using a try-catch block as shown below:
16+
17+
```javascript
18+
try {
19+
await scanner.open(); // or 'await scanner.show()'
20+
} catch(e) {
21+
if(e.name === "NotAllowedError") {
22+
// it means the user denied permission
23+
// add your code here to guide users to grant permission
24+
}
25+
}
26+
```
27+
28+
In case permission is denied, you can prompt the user (using an alert or something similar) to manually grant permission for your website to access the camera via the site settings.

‎faq/general/check-current-version.md‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
layout: default-layout
3+
title: How to check the version of the JS SDK I am currently using?
4+
keywords: Dynamsoft Barcode Reader, FAQ, tech basic, check version, current version
5+
description: How to check the version of the JS SDK I am currently using?
6+
needAutoGenerateSidebar: false
7+
---
8+
9+
# How to check the version of the JS SDK I am currently using?
10+
11+
[<< Back to FAQ index](index.md)
12+
13+
There are multiple ways to check the version currently being used -
14+
15+
- The first way is to use the [version API](https://www.dynamsoft.com/barcode-reader/programming/javascript/api-reference/InitializationControl.html?ver=latest#version). Using this API in the browser console should print out the version of the library being used by the web app.
16+
- If you are using the library via npm or yarn, then you can check the version of the package via
17+
18+
```bash
19+
npm –v dynamsoft-javascript-barcode
20+
```
21+
22+
- If you are including the library via the CDN link, then the version number should be mentioned in that reference link.

0 commit comments

Comments
 (0)