Skip to content

Commit fce3728

Browse files
committed
Merge remote-tracking branch 'origin/preview' into jackson-match-preview
2 parents 2f131d8 + e7cef25 commit fce3728

5 files changed

Lines changed: 141 additions & 5 deletions

File tree

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
---
2+
layout: default-layout
3+
noTitleIndex: true
4+
needAutoGenerateSidebar: true
5+
needGenerateH3Content: true
6+
title: (Original) Apple Rosetta Transition and Dynamic Web TWAIN Service on macOS
7+
keywords: Dynamic Web TWAIN Service, Rosetta, macOS
8+
breadcrumbText: (Original) Apple Rosetta Transition
9+
description: Original version - Apple Rosetta Transition and Dynamic Web TWAIN Service on macOS
10+
date: 2026-05-22 17:21:42 +0800
11+
last_modified: 2026-05-22 10:20:00 -0800
12+
---
13+
14+
# Error Troubleshooting
15+
16+
## Apple Rosetta Transition and Dynamic Web TWAIN Service on macOS
17+
18+
### Overview
19+
20+
Apple has announced that Rosetta support for Intel-based applications will be phased out in future macOS releases. Rosetta will remain fully available through macOS 27. Starting with macOS 28, Intel-only applications will no longer be supported.
21+
22+
Starting with macOS 26.4, users may also see system notifications warning that Intel-based applications will not be supported in future macOS versions.
23+
24+
![system notification from macOS](/assets/imgs/Intel-based-service.jpg)
25+
26+
### What is Apple’s timeline?
27+
28+
| macOS Version | Status |
29+
|---|---|
30+
| macOS 26.4+ | Rosetta warning notifications appear |
31+
| macOS 27 | Rosetta remains fully supported |
32+
| macOS 28 | Intel-only applications will no longer be supported |
33+
34+
More details:
35+
https://support.apple.com/en-us/102527
36+
37+
### Does Dynamic Web TWAIN Service still work on macOS?
38+
39+
Yes. The current version of Dynamic Web TWAIN Service continues to function normally on supported macOS versions, including macOS 26 and macOS 27.
40+
41+
### Do end-user need to take any action now?
42+
43+
No immediate action is required. Customers can continue using the current version normally and are encouraged to upgrade to the future Universal Binary release once available.
44+
45+
### What is Dynamsoft doing to address this?
46+
47+
Dynamsoft is actively developing a Universal Binary version of Dynamic Web TWAIN Service with native Apple Silicon support.
48+
49+
This enhancement is currently planned for the **Dynamic Web TWAIN 19.4 release (ETA: June 2026)**, with the goal of ensuring full compatibility before the general availability of macOS 27.
Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
---
2+
layout: default-layout
3+
noTitleIndex: true
4+
needAutoGenerateSidebar: true
5+
needGenerateH3Content: true
6+
title: Apple Rosetta Transition and Dynamic Web TWAIN Service on macOS
7+
keywords: Dynamic Web TWAIN Service, Rosetta, macOS, Apple Silicon, Universal Binary, Intel, arm64
8+
breadcrumbText: Apple Rosetta Transition and Dynamic Web TWAIN Service on macOS
9+
description: Apple is phasing out Rosetta for Intel apps on Apple Silicon Macs. Learn how this affects the Dynamic Web TWAIN Service and what steps to take.
10+
date: 2026-05-22 17:21:42 +0800
11+
last_modified: 2026-05-22 10:20:00 -0800
12+
---
13+
14+
# Error Troubleshooting
15+
16+
## Apple Rosetta Transition and Dynamic Web TWAIN Service on macOS
17+
18+
### Overview
19+
20+
Apple is phasing out [Rosetta](https://support.apple.com/en-us/102527), the translation layer that allows Intel-based applications to run on Apple Silicon Macs. Starting with **macOS 26.4**, users may see a system notification when launching apps that rely on Rosetta. Intel-only apps will continue to function through **macOS 27**, with support ending in **macOS 28**.
21+
22+
The **Dynamic Web TWAIN Service** — the native macOS component installed on end-user machines — currently ships as an Intel binary. This means users on Apple Silicon Macs running macOS 26.4 or later may see an Apple notification about the service. **The service continues to work normally** — the notification is informational only.
23+
24+
Dynamsoft is releasing a **Universal Binary** version of the service in **Dynamic Web TWAIN v19.4**, targeted for **June 2026**, well ahead of the macOS 28 deadline.
25+
26+
### What is Apple's timeline?
27+
28+
| macOS Version | Expected Availability | Rosetta Status |
29+
|---|---|---|
30+
| macOS 26.4+ | Already released | System notifications appear for Intel-only apps |
31+
| macOS 27 | September 2026 | Rosetta remains fully functional — last version to support it |
32+
| macOS 28 | 2027 | Intel-only apps will no longer run on Apple Silicon Macs |
33+
34+
For the official Apple announcement, see: [Using Intel-based apps on a Mac with Apple silicon — Apple Support](https://support.apple.com/en-us/102527)
35+
36+
### I see an Apple notification saying the Dynamsoft Service needs to be updated. Is it broken?
37+
38+
No. The notification is an informational warning from macOS — it does not mean the Dynamic Web TWAIN Service is broken or will stop working. The service continues to function normally on macOS 26.4 and macOS 27.
39+
40+
![system notification from macOS](/assets/imgs/Intel-based-service.jpg)
41+
42+
The notification appears because the current service installer is an Intel binary running through Rosetta on Apple Silicon Macs. Once you upgrade to a version that includes the Universal Binary service (v19.4+), the notification will no longer appear.
43+
44+
### What is Dynamsoft doing to address this?
45+
46+
Dynamsoft is releasing a **Universal Binary** version of the Dynamic Web TWAIN Service with native Apple Silicon support. This means the service will run natively on both Apple Silicon and Intel-based Macs, eliminating the Rosetta dependency and the macOS notification.
47+
48+
This enhancement is planned for the **Dynamic Web TWAIN v19.4 release (ETA: June 2026)**, ahead of the macOS 27 general availability (September 2026) and well ahead of the macOS 28 hard cutoff.
49+
50+
### Which component is affected?
51+
52+
Only the **Dynamic Web TWAIN Service** (the native macOS installer/daemon) is affected. The JavaScript SDK itself runs in the browser and is not impacted by the Rosetta transition.
53+
54+
### I'm on Dynamic Web TWAIN v18.x. Do I need to upgrade my SDK to v19?
55+
56+
Not necessarily. The v19.4 service installer includes the **DWT 18.6 service module**, which is **backward compatible with DWT 18.x**. This means you can install the v19.4 Dynamsoft Service on end-user machines to get Apple Silicon native support while continuing to use your existing v18.x SDK integration.
57+
58+
You do not need to change your application code or upgrade your JavaScript SDK to v19 just to resolve the Rosetta notification.
59+
60+
### Do I need to renew my license or maintenance to get the update?
61+
62+
- **Active annual license or maintenance plan**: You are entitled to upgrade to v19.4 at no additional cost. Download and deploy the updated service installer when it becomes available.
63+
- **Perpetual license without active maintenance**: You will need to renew your maintenance plan to access the v19.4 release. Please contact [Dynamsoft Sales](https://www.dynamsoft.com/company/contact/) to discuss renewal options.
64+
65+
### What is the actual deadline? Do I need to act now?
66+
67+
There is no immediate urgency, but we recommend planning your upgrade now:
68+
69+
1. **Now (macOS 26.4+)**: Users on Apple Silicon Macs may see an Apple notification. The service works fine — the notification is informational.
70+
2. **June 2026 (DWT v19.4 release)**: Universal Binary service available. Deploying this eliminates the notification.
71+
3. **September 2026 (macOS 27 GA)**: Rosetta still fully supported. No functionality impact.
72+
4. **2027 (macOS 28)**: Intel-only apps stop working on Apple Silicon Macs. You **must** have the Universal Binary service deployed before this point.
73+
74+
We recommend upgrading to v19.4 promptly after release to eliminate the Apple notification and ensure a smooth experience for your end users.
75+
76+
### Does this affect Intel-based Macs?
77+
78+
No. Intel-based Macs run Intel binaries natively without Rosetta. The current service installer continues to work on Intel-based Macs regardless of macOS version.
79+
80+
> Note: Apple has announced that macOS 26 is the last macOS release to support Intel-based Mac hardware.
81+
82+
### How do I deploy the updated service to end users?
83+
84+
The deployment process is the same as the current service. Once v19.4 is released, download the updated macOS service installer and distribute it to your end users. If you use silent installation or enterprise deployment methods, the process remains the same — only the installer binary changes.
85+
86+
For details on deployment options, see: [How to deploy the end-user components to all users](/_articles/faq/deploy-to-all-users.md)

_articles/faq/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -209,6 +209,7 @@ description: Dynamic Web TWAIN SDK Documentation FAQ
209209
33. [Error message - CORS Errors caused by local network access permissions when using Chromium 142 and later](/_articles/faq/chromium-142-local-network-access-issue.md)
210210
34. [Error message - File is Damaged and Can’t Be Opened in macOS](/_articles/faq/file-damaged-on-macos.md)
211211
35. [Safari 26.2 Regression Causing Dynamic Web TWAIN v19.3 Auto-Reconnect Failure on macOS](/_articles/faq/safari-26-2-regression.md)
212+
36. [Apple Rosetta Transition and Dynamic Web TWAIN Service on macOS](/_articles/faq/apple-rosetta-transition.md)
212213

213214
## Licensing and Purchase
214215

_articles/info/api/interfaces.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -34,14 +34,14 @@ interface DWTInitialConfig {
3434

3535
``` typescript
3636
interface Container {
37-
WebTwainId?: string; // Id of the WebTwain instance
38-
ContainerId?: string; // Id of the element
39-
Width?: string | number; // Width of the element
40-
Height?: string | number; // Height of the element
37+
WebTwainId?: string; // ID of the WebTwain instance
38+
ContainerId?: string; // ID of the container element to bind
39+
Width?: string | number; // Width of the div element appended to the container
40+
Height?: string | number; // Height of the div element appended to the container
4141
}
4242
```
4343

44-
- `WebTwainId` and `ContainerId` are both optional but one must exist as the identifier for that `WebTwain` instance.
44+
- `WebTwainId` and `ContainerId` are both optional but one must exist as the identifier for that `WebTwain` instance. If you don't need to use the viewer (headless), you can leave `ContainerId` empty.
4545
- `Width` and `Height` determine the initial size of `Viewer` object.
4646

4747
### DisplayInfo
17.5 KB
Loading

0 commit comments

Comments
 (0)